Gitbook的安装及命令行的快速功能预览说明。

Node.js安装

Node.js是一个基于Chrome Javascript运行时建立的一个平台，用来方便的搭建快速的，易于扩展的网络应用。

Node.js借助事件驱动，非阻塞I/O模型变得轻量和高效，非常适合run across distributed devices的data-intensivede 的实时应用。

]]>https://rd163.visword.com/posts/gitbook-intro/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-intro/ 图书项目结构

README.md和SUMMARY.md 是Gitbook项目必备的两个文件，也就是一本最简单的gitbook也必须含有这两个文件，它们在一本Gitbook中具有不同的用处。

README.md 与 SUMMARY编写

使用语法

在Gitbook中所有文字的编写都使用Markdown语法。

]]>https://rd163.visword.com/posts/gitbookcli/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbookcli/ Gitbook命令行速览

Gitbook是一个命令行工具，使用方法：

本地预览

bash

$ gitbook serve ./{book_name}

输出一个静态网站

]]>https://rd163.visword.com/posts/gitbook-get-started/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-get-started/ Gitbook 使用入门

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.io
• GitBook Github地址：https://github.com/GitbookIO/gitbook

参考

• 仓库：https://github.com/tonydeng/gitbook-zh/tree/master/gitbook-howtouse
• 在线阅读：http://tonydeng.github.io/gitbook-zh/gitbook-howtouse

]]>https://rd163.visword.com/posts/gitbook-pdfandebook/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-pdfandebook/ 输出PDF

输出为PDF文件，需要先安装gitbook pdf

bash

$ npm install gitbook-pdf -g

如果在安装gitbook-pdf时，觉得下载phantomjs包太慢的话，你可以到phantomjs的官方网站上去下载。

]]>https://rd163.visword.com/posts/gitbook-output/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-output/ 图书输出

目前为止，Gitbook支持如下输出：

• 静态HTML，可以看作一个静态网站
• PDF格式
• eBook格式
• 单个HTML文件
• JSON格式

我们这里着重说下如何输出静态的HTML和PDF文件。

]]>https://rd163.visword.com/posts/gitbook-outfile/Sun, 12 Jan 2025 00:00:00 +0800小智晖https://rd163.visword.com/posts/gitbook-outfile/ 输出为静态网站

你有两种方式输出一个静态的网站：

本地预览是自动生成

当你编辑好gitbook文档之后，你可以使用gitbook的命令来进行本地预览。

bash

$ gitbook serve ./{book_name}

gitbook会启动一个4000端口用于预览。

]]>