为自己的成果写一本GITBOOK

贡献开源真的是一种快乐,这与工作不同,我们可以无怨无悔的为解决一个BUG,通宵熬夜,只希望自己写的成果能给他人带来方便,快乐,减少别人的烦恼。
REDUX 应用框架ZORO是我第一个开源项目,我为此感到欣慰,因为这也是我一直想要去做的事情,或多或少的为开源社区做贡献
重该项目第一次提交

为自己的成果写一本GITBOOK
文章图片
C04B473A-0A68-4794-9E2D-3F6B18D4C655.png 到现在2.*版本

为自己的成果写一本GITBOOK
文章图片
image.png 已经经历了126个大大小小的commit, 15个版本迭代,不断的在公司实际项目中使用,不断的优化,现在已经趋于稳定,感谢有幸能得到使用者的3十几个star,起初的每一个star都让我倍感兴奋,因为这是一种认可,也是我坚持的动力
今天我想为自己的这个成果写一本书,同时也分享如何使用GITBOOK写书
为了使用gitbook,我们首先安装nodejs, git
下载地址: NODEJS官网,下载LTS版本的,直接安装即可
下载地址: GIT下载地址 下载完成直接安装即可
nodejs安装完成后,系统就有了npm命令,接下来我们执行命令安装gitbook-cli

$ npm install -g gitbook-cli

接下来初始化我们的书籍
$ mkdir book $ cd ./book $ gitbook init

这时我们的book目录下多出来了两个文件
README.md 常用于写书的前言
SUMMARY.md 用于写书的目录
接下来有了书籍,我们还需要一个图形化管理界面,方便我们时时编辑查看内容,这里使用Typora
下载地址: Typora下载地址
下载完成打开Typora,并且打开我们的book目录,编写相关的章节即可
以下是我已经写好的ZORO文档
为自己的成果写一本GITBOOK
文章图片
image.png 所有的内容支持markdown语法,同一样使用简单易懂
我们如何编写目录呢
为自己的成果写一本GITBOOK
文章图片
image.png 对应的内容如下:
# 目录 * [前言](REDAME.md) * [安装](INSTALL.md) * 教程 * [快速开始](GUIDE/QUIKE_START.md) * [接入create-react-app](GUIDE/CREATE_REACT_APP.md) ...省略其他内容

当我们完成了书籍编写,我们如何生成一个网站呢,执行如下命令
$ gitbook build

变会在book目录下生成_book目录
如果你想要临时查看生成的网站效果可以执行如下命令
$ gitbook serve

之后通过浏览器访问http://localhost:4000即可查看,
该命令同时也具备build命令的功能,会在book目录下生成_book目录
最后一起看看我完成的gitbook书吧https://faurewu.github.io/zoro/
【为自己的成果写一本GITBOOK】每次写完文章都觉得自己的文笔相当的差,总无法完好表达自己的想法,感谢您的观看

    推荐阅读