ubuntu14.04安装gitbook和使用

gitbook 是基于nodejs的一个命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书，可以协同开发（主要是利用github）。具体gitbook是什么自行搜索，其实没必要搞懂，会用gitbook ,git命令，这个弄熟练后 在研究原理 不迟

---

ubuntu14.04 安装和使用

安装nodejs

• ubuntu上切记不要什么都是sudo apt-get install（有可能没有源，或者要装的软件在源上版本太旧了）
• 软件的依赖关系，自行百度解决

去官网下载nodejs,下载最近版就可以，解压即可

在bin目录下就有了 node,npm这两个命令（可以直接运行的）
注意此时，这两个命令只能在bin目录下运行

$cd /home/john/Downloads/node-v6.9.1-linux-x86/bin
$./node -v
$./npm

想要在任何目录下都能运行，只需要建立符号链接到/usr/local/bin下就行了
注意符号链接 写成绝对路径，不要用相对路径

$sudo ln -s /home/john/Downloads/node-v6.9.1-linux-x86/bin/node /usr/local/bin/node

$sudo ln -s /home/john/Downloads/node-v6.9.1-linux-x86/bin/npm /usr/local/bin/npm

这样之后切换到任意目录,都能运行node,npm命令

---

接着安装gitbook

gitbook Ubuntu下，在安装好nodejs后直接使用如下命令安装,依据自己安装的目录可能有权限问题，自行加上

npm install -g gitbook-cli

安装完成后，同样的在bin目录下（其他路径不能运行）
设置一个符号链接

$sudo ln -s /home/john/Downloads/node-v6.9.1-linux-x86/bin/gitbook /usr/local/bin/gitbook

这样之后

$gitbook -v #查看gitbook版本

---

gitbook 多人协作

确保你的github fork那本需要协作的书

clone到 ~/git_workspace 目录下 项目名 AndroidBook，直接切换到这个目录

$gitbook serve #是serve 不是 server，这个相当于发布图书命令

遇到了如下的情况

按照提示操作就好，随便尝试，反正clone的，可以恢复的

装了插件而已，继续 $gitbook serve

浏览器可以查看到此书

接着协作

上一个个步骤完成后

多了两个文件夹，一个是gitbook install的插件，因为原项目中没有这个插件
还有一个是$gitbook serve 之后生成的静态文件，里面是html之类的东西，我们看到的图书网页就是这个

---

注意 上面红色的文件夹不要git add commit提交
我们只需要提交我们修改的文档，即

修改AndroidBook下面的文件（markdown好好练下），然后 gitbook 预览下效果，然后就是git相关操作了，要与原作者合并，pull request 就行