GitBook简介
一、Git和GitBook
相信在认识GitBook之前,你或多或少对Git是有了解的。可能你觉得Git只是作为协同开发使用,其实不然。GitHub依赖其良好的开源性,完全可以作为一个良好的分享平台。而且在这里你不只是能分享你的代码,包括你的任何文章、心得、著作,everything is ok!
那么Git和GitBook有联系吗?答案是 :
没联系!
就像雷锋和雷峰塔!
但是他们可以联合使用,GitBook只是一个文本编辑器(当然是高级的文本编辑器),类似MarkDown(当你在CSDN写博客时用到的那样)。我们可以用GitBook创建来管理,使用typora来进行线下编辑,最后,使用GitBook和GitHub/GitLab协作实现共享或协同开发。
类似的MarkDown编辑器其实有很多种,Typora、MacDown、Bear、MarkdownPad、MarkdownX、JetBrains’s IDE(需要安装插件)、Atom、简书、CSDN 以及 GitBook 自家的 GitBook Editor 等等。
二、GitBook与Word
同样的,也没什么关系。他们虽说都是文本编辑软件,但GitBook特点是功能简单,更注重协同开发和共享,还能完成版本控制。而Word可以做出许多炫酷的效果以及更为精准的格式样式等。
GitBook安装
一、安装Node.js
GitBook基于Node.js,需要先安装Node.js。进入官网即可下载: https://nodejs.org/en/download/
二、安装GitBook
安装好的Node.js自带了npm(node包管理工具),所以安装后即可在命令行执行以下命令安装GitBook:
npm install -g gitbook-cli
安装好之后就可以使用 gitbook
命令了
三、安装Typora
去官网下载: https://typora.io/(需翻墙)
Git下载地址: https://git-scm.com/downloads
使用GitBook
想象一下,现在你准备构建一本书籍,你在硬盘上新建了一个叫 mybook 的文件夹,按照以前的做法,你会新建一个 Word 文档,写上标题,然后开始巴滋巴滋地笔耕。但是现在有了 GitBook,你首先要做的是在 mybook 文件夹下使用cmd
命令行执行以下命令:
gitbook init
执行完后,你会看到多了两个文件 —— README.md 和 SUMMARY.md,它们的作用如下:
README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置
这时候,我们启动恭候多时的 Typora 来编辑这两个文件了
编辑 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
来预览这本书籍,执行后GitBook会将这本书转化为Html格式,并提供一个http网址,可以访问了。