当前位置:秋硕笔记 > 教程 > 正文

安装和使用GitBook

GitBook是一款文档编辑工具。它的功能类似金山WPS中的Word或者微软Office中的Word的文档编辑工具。它可以用来写文档、建表格、插图片、生成pdf。 当然,以上的功能WPS、Office可能做得更好,但是,GitBook还有更最强大的功能:它可以用文档建立一个网站,让更多人了解你写的书,另外,最最核心的是,他支持Git,也就意味着,它是一个分布式的文档编辑工具。 你可以随时随地来编写你的文档,也可以多人共同编写文档,哪怕多人编写同一页文档,它也能记录每个人的内容,然后告诉你他们之间的区别,也能记录你的每一次改动,你可以查看每一次的书写记录和变化,哪怕你将文档都删除了,它也能找回来! 这就是它继承Git后的厉害之处!

完成GitBook的安装只需要几分钟。

GitBook.com

GitBook.com为您提供简单高效的图书在线撰写、发布和托管方案, 你可以通过GitBook.com进行在线编辑、或者使用GitBook 本地编辑器在本地电脑上编辑。

本地安装

要求

GitBook的安装非常简单。您的系统只需满足这两个要求:

  • NodeJS(推荐使用v4.0.0及以上版本)
  • Windows,Linux,Unix或Mac OS X
使用NPM安装

安装GitBook的最好方法是通过NPM安装。在已经安装好NodeJS和NPM的电脑上,通过命令行窗口,输入以下命令安装GitBook:

$ npm install gitbook-cli -g

gitbook-cli是安装和管理GitBook版本库的程序。它会自动安装GitBook所需的模块来创建一本书。

创建一本书

GitBook通过以下命令在当前目录创建一本书:

$ gitbook init

如果你想用现有的目录来创建一本书,你可以通过运行

gitbook init ./directory

来实现

使用下面的命令预览您创建的图书:

$ gitbook serve

或者使用以下命令构建静态网站:

$ gitbook build
安装其他版本

gitbook命令可以方便地下载和安装不同版本的GitBook来测试你的书:

$ gitbook fetch 4.0.0-alpha.1

使用gitbook ls-remote列出可用于安装的远程版本。

$ gitbook ls-remoteAvailable GitBook Versions: 4.0.0-alpha.5, ...部分省略..., 4.0.0-alpha.1, 3.2.2, 3.2.1, ...部分省略..., 2.0.0-alpha.1Tags: latest : 3.2.2 pre : 4.0.0-alpha.5
调试

您可以使用–log=debug和–debug来获得更详细的错误消息(堆栈跟踪)。例如:

$ gitbook build ./ --log=debug --debug

or

$ gitbook serve ./ --log=debug --debug

 
本文来自:http://gitbook.hushuang.me/

感觉很棒!可以赞赏支持我哟~

赞(0) 打赏

评论抢沙发