用 Github、Markdown 和 GitBook 写开源书

时间 2019-11-08

原文原文链接

原文同步至：http://www.waylau.com/using-github-markdown-gitbook-write-open-source-books/html

以前一直是在 Github 上写开源书（见：http://www.waylau.com/books/）但，因为 Github 自己的目录结构并不必定符合阅读的习惯，并且没有提供 pdf , ePUB, MOBI 等格式的转换下载。不少同窗也仍是习惯离线看文档。GitBook 就是解决这一问题。git

GitBook 让你在保持在 Github 的书写习惯外，稍加配置，就能自动发布到GitBook 上，造成界面漂亮的电子书了（支持 html, pdf , ePUB, MOBI 等）。github

apache

若是你是第一次使用 GitBook,能够参见使用 GitBook 写开源书markdown

下面介绍，若是将一个 Github 项目转移到 GitBook 上来架构

##注册帐户工具

须要拥有 Github 和 GitBook 的帐户ui

##关联帐号code

将 GitBook 的项目关联上 Github 的库htm

##原有的项目

这个是原来的项目结构，参见https://github.com/waylau/apache-shiro-1.2.x-reference。

##添加 SUMMARY.md 文件配置

不改变原有的项目结构，添加 SUMMARY.md 文件，描述了 GitBook 目录结构，以下：

# Summary

This is the summary of my book.

* I. Overview 总览
	* [1. Introduction 介绍](I. Overview 总览/1. Introduction 介绍.md) 
	* [2. Tutorial 教程](I. Overview 总览/2. Tutorial 教程.md) 
	* [3. Architecture 架构](I. Overview 总览/3. Architecture 架构.md) 
	* [4. Configuration 配置](I. Overview 总览/4. Configuration 配置.md) 
* II. Core 核心
	* [5. Authentication 认证](II. Core 核心/5. Authentication 认证.md) 
	* [6. Authorization 受权](II. Core 核心/6. Authorization 受权.md) 
* III. Web Applications
* IV. Auxiliary Support 辅助支持
* V. Integration 整合
* VI. Tools 工具
* VII. Index 目录
* VIII. Other 其余

##编译

$ gitbook build ./

编译成功后，生成 _book 目录

##运行

运行 _book 目录中的index.html

效果

##提交更新到 Github，自动发布到 GitBook

提交代码到 Github 的库，因为 GitBook 的项目关联上 Github 的库，因此 GitBook 会自动根据 Github 进行发布。效果以下： <a href="http://s1288.photobucket.com/user/waylau/media/waylau%20blog/gitbook/16_zpsae785ba0.jpg.html" target="_blank"><img src="http://i1288.photobucket.com/albums/b484/waylau/waylau%20blog/gitbook/16_zpsae785ba0.jpg" border="0" alt=" photo 16_zpsae785ba0.jpg"/></a>

在线电子书：http://waylau.gitbooks.io/apache-shiro-1-2-x-reference/