Gitbook简易教程

简介

GitBook 是一个基于 Node.js 的命令行工具，可以使用 Github/Git 和 Markdown 来制做精美的电子书。GitBook支持输出如下几种文档格式

• 静态站点：GitBook默认输出该种格式

• PDF：须要安装gitbook-pdf依赖

• eBook：须要安装ebook-convert

准备安装

在使用GitBook 以前, 咱们须要先安装一些必须的工具，Node.js、GitBook、GitBook Editor、Git版本控制器。

Node.js

Node.js 是一个基于Chrome JavaScript 运行时创建的一个平台， 用来方便地搭建快速的， 易于扩展的网络应用· Node.js 借助事件驱动， 非阻塞 I/O 模型变得轻量和高效， 很是适合 run across distributed devices 的 data-intensive 的实时应用。

一、win下安装Node.js

直接到nodejs官网下载，简单安装便可，此处再也不细述。

二、检测是否安装成功

node -v //显示v4.1.1

GitBook

GitBook 是一个基于 Node.js 的命令行工具，可以使用 Github/Git 和 Markdown 来制做精美的电子书。经过Node.js命令安装GitBook

一、NMP安装Gitbook

npm install gitbook -g

二、安装gitbook CLI

想在系统上的任何地方的gitbook命令，须要安装“gitbook CLI”，执行如下命令

//安装命令
npm install -g gitbook-cli
//卸载命令
npm uninstall -g gitbook

三、检验下是否安装成功

gitbook -V //显示0.4.2

Git

Git是一款免费、开源的分布式版本控制系统，用于敏捷高效地处理任何或小或大的项目。基本安装请点击安装教程。若是不须要从GitHub更新书到本地再编译，则能够不安装Git。

GitBookEditor

GitBook官方客户端编辑器，支持Win、Linux、Mac系统。请点击下载GitBookEditor。使用该编辑器能够快速的建立、编辑GitBook。安装具备如下步骤：

• 解压下载包 gitbook-editor-4.2.1-windows-ia32.zip

• 运行GitBook Editor Setup.exe进行默认安装

基本使用

GitBook 大体分为两种使用方式，即离线和在线。最简单的使用方式是使用GitBook Editor编辑GitBook ，而后使用相关命令编译成功HTML。固然还有如下几种方式

• 使用命令建立基本GitBook

• 使用网页在线编辑器建立、编辑GitBook。

• 使用itBookEditor客户端建立、编辑GitBook。

gitBookEditor

使用客户端方式，支持在线和本地两种方式建立、编辑GitBook，再执行相关命令编译成HTML，这种方式比较方便，推荐使用。以本地建立书籍为例

一、gitBookEditor客户端基本使用

二、使用命令对已经建立的Book进行编译

找到须要编译的书籍所在目录，执行gitbook serve 命令,在本电脑的默认路径为C:UsersQGYGitBookLibraryImportgitbooksimpletutorial，如图所示

高级扩展

掌握了“基本使用”，但有时候想要gitBook更美观，或者更符合咱们本身的需求，则经过book.json配置进行自定义、以及安装一些经常使用的插件等。

Book.json配置

GitBook 在编译书籍的时候会读取书籍源码顶层目录中的 book.js 或者 book.json，这里以 book.json 为例，参考 GitBook 文档 能够知道，book.json 支持以下配置

{

    //样式风格配置格式
    "styles": {
        "website": "styles/website.css",
        "ebook": "styles/ebook.css",
        "pdf": "styles/pdf.css",
        "mobi": "styles/mobi.css",
        "epub": "styles/epub.css"
     },

    //插件安装配置格式

    "plugins": ["myplugin"],
    "pluginsConfig": {
        "myPlugin": {
            "message": "Hello World"
        }
     }    
}

自定义插件扩展

插件是扩展GitBook功能最好的方法。使得GitBook功能更增强大，例如，把数学公式显示支持，跟踪回访使用谷歌解析，…以toggle-chapters插件为例
toggle-chapters 插件的效果是默认只在目录导航中显示章的标题，而不会显示小节的标题，点击每一章或者每一节会显示当前章或节的子目录，若是有的话，可是同时会收起其它以前展开的章节。因此，我的认为不是很是实用，由于这样子用户不能快速跳转到没有展开的章节！

1、搜索、安装插件方式

一、编辑器方式（没成功）

二、经过GitHub方式

www.plugins.gitbook.com

三、node.js命令方式

• 默认安装在如下路径

C:\Users\QGY\AppData\Roaming\npm\node_modules

• 把插件文件夹复制到

npm install gitbook-plugin-toggle-chapters --save-dev

2、经过Book.json配置插件

"plugins": ["toggle-chapters"],
    "pluginsConfig": {
        "myPlugin": {
            "message": "Hello World"
        }
     }