红联Linux门户
Linux帮助

ubuntu14.04安装gitbook和使用

发布时间:2016-10-29 10:52:48来源:linux网站作者:master-dragon
gitbook 是基于nodejs的一个命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书,可以协同开发(主要是利用github)。具体gitbook是什么自行搜索,其实没必要搞懂,会用gitbook ,git命令,这个弄熟练后在研究原理不迟。
 
ubuntu14.04 安装和使用
 
安装nodejs
ubuntu上切记不要什么都是sudo apt-get install(有可能没有源,或者要装的软件在源上版本太旧了)
软件的依赖关系,自行搜索解决
去官网(https://nodejs.org/en/)下载nodejs,下载最近版就可以,解压即可
ubuntu14.04安装gitbook和使用
在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命令
ubuntu14.04安装gitbook和使用
 
接着安装gitbook
gitbook Ubuntu下,在安装好nodejs后直接使用如下命令安装
npm install -g gitbook-cli
安装完成后,同样的在bin目录下(其他路径不能运行)
设置一个符号链接
ubuntu14.04安装gitbook和使用
$sudo ln -s /home/john/Downloads/node-v6.9.1-linux-x86/bin/gitbook /usr/local/bin/gitbook
这样之后
ubuntu14.04安装gitbook和使用
ubuntu14.04安装gitbook和使用
$gitbook -v #查看gitbook版本
ubuntu14.04安装gitbook和使用
 
gitbook 多人协作
确保你的github fork那本需要协作的书
ubuntu14.04安装gitbook和使用
clone到 ~/git_workspace 目录下 项目名 AndroidBook,直接切换到这个目录
$gitbook serve #是serve 不是 server,这个相当于发布图书命令
遇到了如下的情况
ubuntu14.04安装gitbook和使用
按照提示操作就好,随便尝试,反正clone的,可以恢复的
ubuntu14.04安装gitbook和使用
装了插件而已,继续 $gitbook serve
ubuntu14.04安装gitbook和使用
浏览器可以查看到此书
ubuntu14.04安装gitbook和使用
 
接着协作
上一个个步骤完成后
ubuntu14.04安装gitbook和使用
多了两个文件夹,一个是gitbook install的插件,因为原项目中没有这个插件
还有一个是$gitbook serve 之后生成的静态文件,里面是html之类的东西,我们看到的图书网页就是这个
注意 上面红色的文件夹不要git add commit提交
我们只需要提交我们修改的文档,即
修改AndroidBook下面的文件(markdown好好练下),然后 gitbook 预览下效果,然后就是git相关操作了,要与原作者合并,pull request 就行。
 
本文永久更新地址:http://www.linuxdiyf.com/linux/25506.html