(2019年12月2日 14:48:27)

GitBook其实和Git没有什么直接关系,它实际上是可以用markdown书写,生成静态页面网站的工具。然后github提供了对这种格式和部署的支持。

https://docs.gitbook.com/ 本身也提供云平台服务,可以当做一个类博客的网站在上面写书。

这篇是用GitBook写的GitBook入门教程,清晰明了:https://yuzeshan.gitbooks.io/gitbook-studying/index.html

安装

先安装好node.js
再执行:npm install gitbook-cli -g
然后输入 gitbook -V
最后安装了gitbook 3.2.3

创建一本书

mkdir gitbook-demo
cd gitbook-demo
gitbook init
  • 初始化会创建README.md和SUMMARY.md两个文件(如果这两个文件已存在,则会进行更新操作)
  • 每个目录都有会有一个README.md文件,它是当前章节的一个入口文档
  • 其中SUMMARY.md文件管理的是gitbook的目录

gitbook是以SUMMARY.md文件为主来管理其它文件的

  • 如果SUMMARY.md有写明的目录,但是文件还没存在,执行gitbook init则会自动创建。
  • 反之如果子目录已存在,但是SUMMARY.md中没有,此时执行gitbook init并不会改变SUMMARY.md

SUMMARY.md示例:

# 目录

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1节:衣](Chapter1/衣.md)
  * [第2节:食](Chapter1/食.md)
  * [第3节:住](Chapter1/住.md)
  * [第4节:行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

运行项目

gitbook serve

执行这个命令后监听在 http://localhost:4000

生成静态html文件

执行gitbook build

生成pdf文件

需要安装https://calibre-ebook.com/download_windows

文档更新时间: 2019-12-26 11:21   作者:nick