关于gitbook构建的第一本书：业务代码干货宝典

2020年09月02日

次

关于为何会构建这本书：

起因是对于开发过程中一些复用率比较高的代码片段，每次遇到都要想着去之前项目中出现的地方，进行参考复用，时间久了，找起来就很麻烦，于是准备在github建一个仓库，用来整理存放一些常用的代码干货。

仓库建完搁置一段时间，想到之前希望自己平时的写作也有像github一样的仓库进行管理，于是去了解到了gitbook，后来写作方面一直也没有什么进展，于是也是搁置。

于是两件事碰撞到一起，一拍即合，既为我的干货代码找到一个很方便的呈现方式，也让我借此熟悉了一边gitbook构建的过程，一举两得！

下面主要针对构建过程中的一些重要点进行归纳整理（本文适用于有一定github使用基础的人群，如果需要傻瓜式详细教程，可以去网上搜索，有很多）

技术栈

本书开发技术栈：GitBook + Typora + Git

• Typora 下载地址：https://typora.io/
• Git 下载地址：https://git-scm.com/downloads

项目相关语法

• npm install -g gitbook-cli 安装gitbook

• gitbook init 初始化 初始化后会生成两个文件 ——README.md 和 SUMMARY.md

  在SUMMARY.md中修改文件目录后，重新执行gitbook init，会根据SUMMARY.md文件中描述的目录和文件,创建相应的文件夹

  // SUMMARY.md 示例
  * [前言](README.md)
  * [第一章](Chapter1/README.md)
  	* [第1节：test](Chapter1/test.md)
  

• gitbook serve 预览书籍

  默认端口是：4000

  可以指定端口 gitbook serve --port xxxx

  默认会输出到/_book文件夹下，可指定输出文件夹 gitbook serve [书籍路径] [输出路径]

• gitbook build 创建书籍

  默认会输出到/_book文件夹下，可指定输出文件夹 gitbook build [书籍路径] [输出路径]

  因为我希望能够在github上生成预览页面，因此，根据github page的设定，此处使用gitbook build ./ ./docs 设置输出文件夹名为docs

其他

1. 生成 PDF 格式的电子书

 gitbook pdf ./ ./mybook.pdf

1. 生成 epub 格式的电子书

 gitbook epub ./ ./mybook.epub

1. 生成 mobi 格式的电子书

 gitbook mobi ./ ./mybook.mobi

最后放两个链接：

这里整理了很多gitbook相关的插件：https://www.cnblogs.com/mingyue5826/p/10307051.html

这是我的书在github的仓库：https://github.com/seven777777/DryCodeWarehouse

最后是我的书的访问地址：业务代码干货宝典

内容还在不断更新中，如果觉得有用，可以收藏一下哟！

本博客所有博文作者 均为张敏。 所有文章除特别声明外，均采用 CC 3.0 License, 许可协议。转载请注明出处！ 博客源码可点击查看； 博客部分设计理念参考了羡辙杂俎。