Gitbook 是基于 Node.js 的命令行工具,用来创建漂亮的电子书,它使用 Markdown 或 AsciiDoc 语法来撰写内容,用 Git 进行版本控制,且可以托管在 Github 上。Gitbook 可以将作品编译成网站、 PDF、 ePub 和 MOBI 等多重格式。
首先,安装 Node.js。GitBook 依赖 Node.js 环境。如果您的系统中还未安装 Node.js,请到 Node.js官方网站,根据你所使用的系统下载对应的版本。如果已安装则略过本步骤。
第二,安装 GitBook 命令行工具。
$ npm install gitbook -g$ ll /usr/local/software/node-v6.12.0/bin/gitbooklrwxrwxrwx 1 shenweiyan bioinfo 42 Sep 6 10:39 /usr/local/software/node-v6.12.0/bin/gitbook -> ../lib/node_modules/gitbook/bin/gitbook.js$ gitbook -hYou need to install "gitbook-cli" to have access to the gitbook command anywhere on your system.If you've installed this package globally, you need to uninstall it.>> Run "npm uninstall -g gitbook" then "npm install -g gitbook-cli"shenweiyan@ecs-steven 11:15:01 /ifs1# gitbook-cli 是 gitbook 的一个命令行工具, 通过它可以在电脑上安装和管理 gitbook 的多个版本.$ npm install -g gitbook-cli $ gitbook -h Usage: gitbook [options] [command] Options: -v, --gitbook [version] specify GitBook version to use -d, --debug enable verbose error -V, --version Display running versions of gitbook and gitbook-cli -h, --help output usage information Commands: ls List versions installed locally current Display currently activated version ls-remote List remote versions available for install fetch [version] Download and install a <version> alias [folder] [version] Set an alias named <version> pointing to <folder> uninstall [version] Uninstall a version update [tag] Update to the latest version of GitBook help List commands for GitBook * run a command with a specific gitbook version
使用 GitBook命令行工具制作文档的步骤,如下:
新建一个目录,并进入该目录使用 gitbook 命令初始化电子书项目。举个例子,现在要创建一个名为“MyBook”的空白电子书项目,如下所示:
mkdir MyBook #新建目录cd MyBook #进入目录gitbook init #初始化目录
初始化后的目录中会出现“README.md”和“SUMMARY.md”两个基本文件。每个作品目录中这两个文件都是必须的。README.md 是作品的介绍,SUMMARY.md 是作品的目录结构,里面要包含一个章节标题和文件索引的列表
首先,GitBook 使用 SUMMARY.md
文件组织整个内容的目录,如:
# Summary* [简介](README.md)* [常见问题](Faq.md)
如上面目录中“常见问题”章节的内容,就存放在名为 Faq.md
的纯文本文件中,md 文件使用 markdown 语法 编辑,规则非常简单,几分钟就可以学会。
当内容书写完毕后,可以在终端中输入如下命令,实现实时预览:
gitbook serve
gitbook serve
命令实际上会首先调用 gitbook build
编译书籍,完成以后会打开一个 web 服务器,监听本地 4000 端口,在浏览器中输入 http://localhost:4000
,即可打开电子书。
当电子书内容制作好后,可以使用如下命令,生成 html 版本的电子书:
gitbook build
该命令会在当前文件夹中生成 _book
文件夹,用户可以将这个文件夹内容托管到网上,从而实现内容的发布。
GitBook 使用 SUMMURY.md
文件实现目录结构的设定,在该文件中,可以通过缩进实现多级目录的效果,如:
* [第一章](section1/README.md) * [第一节](section1/example1.md) * [第二节](section1/example2.md)* [第二章](section2/README.md) * [第一节](section2/example1.md)
如上所示,章节的 md 文件,还可以存放在子文件夹中。另外,GitBook 的目录,限定为三级。
用户还可以通过使用标题或者水平分割线标识将 GitBook 目录分为几个不同的部分:
# Summary### Part I* [Introduction](README.md)* [Writing is nice](part1/writing.md)* [GitBook is nice](part1/gitbook.md)### Part II* [We love feedback](part2/feedback_please.md)* [Better tools for authors](part2/better_tools.md)----* [Last part without title](part3/title.md)
联系客服