手把手教你GitBook使用(三)

简介: 详细的记录了一步步搭建自己的电子文档笔记

3.3 图书输出

目前为止,Gitbook 支持如下输出:

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

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


3.3.1 输出为静态网站

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

1. 本地预览是自动生成

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

6.png

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

比如,通过 gitbook serve 来预览本文档:

7.png

你可以你的浏览器中打开这个网址: http://localhost:4000

8.png

你会发现,在你编辑的 gitbook项目的目录中会多一个 _book 目录,而这个目录中就是生成的本地预览的静态网站内容。

2. 使用 gitbook build 参数

与直接预览生成的静态网站不一样的时,使用这个命令,你可以将内容输出到你想要的目录。

Ps:gitbook build ./{book_name} --output=./{outputFolde}

gitbook build [当前路径] [输出路径]

gitbook build ./ doc # 默认打包输出到当前路径下面的 doc 文件夹中

9.png注意:


打包成功之后,默认输出的文件放在 _book 文件夹里面,编译之后的入口: index.html


无论哪种方式,你都可以将这个静态网站打包,发布到你想要发布的服务器上,或者直接将这个打包文件给阅读者。

3.3.2 输出 PDF

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

10.png

一般来说,不推荐安装全局环境,安装局部环境会比较好。


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

http://phantomjs.org/

这个包的安装方式,参考其官网的说明文档。


当然,上面的方法,我试了,以失败告终。所以我换了一种方法。

Windows下使用 gitbook 生成PDF文件:https://www.aiyc.top/1969.html

然后,用下面的命令就可以生成 PDF 文件了。

11.png

如果,你已经在编写的 gitbook 当前目录,也可以使用相对路径。

12.png

然后,你就会发现,你的目录中多了一个名为 book.pdf 的文件。



目录
相关文章
|
8月前
[教程]使用gitbook写书
[教程]使用gitbook写书
|
9月前
|
JavaScript 开发工具 git
GitBook新手入门
GitBook是使用Git管理书籍项目,使用Markdown撰写书籍,并使用GitHub和GitBook网站进行托管的一个实用工具。下面简单说一下新手如何使用该强大的工具。
99 0
|
Python Windows
Python安装教程-手把手教你安装
Python安装教程-手把手教你安装
Python安装教程-手把手教你安装
|
11月前
|
Web App开发 JavaScript 前端开发
VueCLi的安装步骤(第四课)
VueCLi的安装步骤(第四课)
217 0
|
JavaScript
Hexo 入门指南(七) - 评论 & 分享
Hexo 入门指南(七) - 评论 & 分享
57 0
|
JavaScript Ubuntu
gitbook 快速入门
gitbook 快速入门
gitbook 快速入门
|
存储 JavaScript 前端开发
grunt入门笔记
grunt在前端工具中算是很有用的一个工具。 想一想如果没有这个工具,我们需要手动新建一个压缩代码后的文件夹,每次修改原始文件,都要手动压缩一下,再保存到压缩后的文件夹,想想都要疯掉。所以,grunt前端必不可少。
101 0
grunt入门笔记
|
监控 JavaScript 前端开发
Grunt快速入门教程
Grunt入门介绍:中文主页 : http://www.gruntjs.net/ Grun是一套前端自动化构建工具,一个基于nodeJs的命令行工具 Grunt它是一个任务运行器
97 0
|
JSON 测试技术 Linux
【HttpRunner v3.x】笔记 ——1. 环境安装
【HttpRunner v3.x】笔记 ——1. 环境安装
【HttpRunner v3.x】笔记 ——1. 环境安装
|
机器人
gitbook 插件 阅读更多
gitbook 插件 阅读更多