gitbook使用简单教程

最新推荐文章于 2022-04-16 19:50:46 发布

dengliang2515

最新推荐文章于 2022-04-16 19:50:46 发布

阅读量111

点赞数

文章标签：运维 markdown 操作系统

原文链接：http://www.cnblogs.com/Lemuria/p/6785037.html

版权

参见前文Linux安装gitbook
按照惯例，得写一个Hello world。

创建一本gitbook书

创建一个书籍目录HelloWorld，cd到该目录下，执行gitbook init初始化书籍。得到两个文件SUMMARY.md，README.md。

编辑书籍

建立如下文件

HelloWorld
│  README.md
│  SUMMARY.md
├─chapter1
│     chapter1.md
│     section1.1.md
└─chapter2
      chapter2.md
      section2.1.md

并为新建的markdown文件增加一些内容。

编辑SUMMARY.md文件

* [介绍](README.md)
* [第一章](chapter1/chapter1.md)
  - [第一章第一节](chapter1/section1.1.md)
* [第二章](chapter2/chapter2.md)
  - [第二章第一节](chapter2/section2.1.md)

编译gitbook

在HelloWorld目录下，执行gitbook build，会在该目录生成一个_book目录，执行gitbook serve命令，开启http服务。如果没有错误的话，最后会提示成功，并提示你可以在浏览器用http://localhost:4000来浏览该书籍。
也可以将书编译到指定目录，比如nginx的html目录下，示例gitbook build /path/to/HelloWorld /usr/share/nginx/html/HelloWorld，通过nginx来访问。（推荐后者，因为Nginx所占资源远远小于Node，且可以支持多本书）

导出PDF

在Windows下，安装calibre，并将calibre的bin目录添加到系统环境变量path中，比如我的是D:\Program Files\Calibre Portable\Calibre.
执行gitbook pdf /path/to/HelloWorld HelloWorld.pdf，即可生成PDF。效果非常不错，Go的IDE也支持将单个Markdown文件生成PDF，但那个效果一般。

转载于:https://www.cnblogs.com/Lemuria/p/6785037.html