在Ubuntu系统上安装Gitbook搭建Wiki站-续笔记自媒体

相信很多站长有和我一样的习惯,除了日常更新博客外,平时也会花些时间对知识进行整理。使用 gitbook 将重要的笔记整理成电子书。这样既方便各大网友阅读,还可以带来新的离线阅读功能。而且还支持导出 PDF,EPUB,HTML 等多种格式。

准备环境:

之前续笔记自媒体发布一篇文章《在 Ubuntu 系统上搭建 Hexo 静态博客》 ,Gitbook 和 Hexo 在安装过程中有较多相似之处,都是使用 NPM 来进行安装的。因此对于环境部署的相关操作,我将直接引用搭建Hexo的相关步骤。

本教程使用的系统环境为Ubuntu ,由于使用自带的nodejs和npm低版本进行安装带来的坑超多,因此我决定手动安装。

执行命令,先卸载ubuntu自带的nodejs和npm

清理依赖包:

官网下载 nodejs:

配置环境变量:

同步文件使环境变量生效

测试一下:

均得到版本号,表示nodejs和npm已成功安装。

基本安装:

gitbook 的安装非常简单,详细指南可以参考 gitbook 文档

安装只需要一步就能完成!

检查是否安装成功:

若成功显示版本号即表示安装成功。

图书简介及目录:

可使用 vim 命令或 Markdown 编辑器分别创建 README.md 与 SUMMARY 文件。

示例如下:

README.md 这个文件相对于是一本 Gitbook 的简介。

SUMMARY.md 这个文件相对于是一本书的目录结构。

SUMMARY.md基本上是列表加链接的语法。链接中可以使用目录,也可以使用。

简介于目录文件编写完成后,我们可以使用 Gitbook 的命令行工具将这个目目录结构生成相应地目录及文件。

我们可以看到,gitbook 给我们生成了与SUMMARY.md所对应的目录及文件。每个目录中,都有一个README.md文件,用于描述这一章的说明。

网站预览:

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

gitbook 默认会启动一个4000端口用于预览。可以在浏览器中打开这个网址: http://localhost:4000

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

图书输出:

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

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

输出 HTML

你可以将静态网站内容输出到当前目录。

GitBook 最近的版本,使用gitbook build命令生成了静态文件后,打开后的左侧点击均没有反应。

解决方案如下(即使用gitbook之前的版本来生成静态页面):

输出 PDF

输出为PDF文件,需要先安装gitbook pdf执行下列命令:

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

http://phantomjs.org/

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

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

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

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

其他内容:

更多gitbook相关介绍说明以及 markdown 用法,请查看 Gitbook 文档常用插件及用法