Gitbook使用入门.docx

目录简介3基本安装4Node.js安装4Gitbook安装4Gitbook命名行速览4图书项目结构5README.md 与 SUMMARY编写5目录初始化5图书输出6输出为静态网站6输出PDF6发布7发布到github pages7结束8简介GitBook 是一个基于 Node.js 的命令行工具，可使用 Github/Git 和 Markdown 来制作精美的电子书。本书将简单介绍如何安装、编写、生成、发布一本在线图书。支持格式GitBook支持输出多种文档格式，如：静态站点：GitBook默认输出该种格式，生成的静态站点可直接托管搭载Github Pages服务上；PDF：需要安装gitbook-pdf依赖；eBook：需要安装ebook-convert；单HTML网页：支持将内容输出为单页的HTML，不过一般用在将电子书格式转换为PDF或eBook的中间过程；JSON：一般用于电子书的调试或元数据提取。Gitbook项目地址GitBook项目官网：http://www.gitbook.ioGitBook Github地址：/GitbookIO/gitbook本项目地址仓库：/wwq0327/gitbook-zh在线阅读：/gitbook-zh/基本安装本章内容讲述Gitbook的安装及命令行的功能快速预览说明。Node.js安装Node.js 是一个基于Chrome JavaScript 运行时建立的一个平台， 用来方便地搭建快速的， 易于扩展的网络应用· Node.js 借助事件驱动， 非阻塞 I/O 模型变得轻量和高效， 非常适合 run across distributed devices 的 data-intensive 的实时应用·Node.js的安装，请移步这里：在 Windows、Mac OS X 與 Linux 中安裝 Node.js 網頁應用程式開發環境安装完成这后，你可以在终端模式下检验一下：$ node -vv0.10.28看到些提示，就表示你已成功安装上了 Node.js 。Gitbook安装Gitbook是从NMP安装的，命令行：$ npm install gitbook -g安装完之后，你可以检验下是否安装成功：$ gitbook -V0.4.2如果你看到了与上面类似的版本信息，则表示你已成功完装上了Gitbook。Gitbook命名行速览Gitbook是一个命令行工具，使用方法：本地预览$ gitbook serve ./图书名称输出一个静态网站$ gitbook build ./repository --output=./outputFolder查看帮助$ gitbook -h Usage: gitbook [options] [command] Commands: build [options] [source_dir] Build a gitbook from a directory serve [options] [source_dir] Build then serve a gitbook from a directory pdf [options] [source_dir] Build a gitbook as a PDF ebook [options] [source_dir] Build a gitbook as a eBook init [source_dir] Create files and folders based on contents of SUMMARY.md Options: -h, --help output usage information -V, --version output the version number图书项目结构README.md和SUMMARY.md是Gitbook项目必备的两个文件，也就是一本最简单的gitbook也必须含有这两个文件，它们在一本Gitbook中具有不同的用处。README.md 与 SUMMARY编写README.md这个文件相当于一本Gitbook的简介。SUMMARY.md这个文件是一本书的目录结构，使用Markdown语法，如我们这本书的 SUMMARY.md ：* [基本安装](howtouse/README.md) - [Node.js安装](howtouse/Nodejsinstall.md) - [Gitbook安装](howtouse/gitbookinstall.md) - [Gitbook命令行速览](howtouse/gitbookcli.md)* [图书项目结构](book/README.md) - [README.md