GitBook文本管理工具的使用

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 等等。

各类MarkDown编辑器比较

二、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.mdSUMMARY.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网址,可以访问了。

猜你喜欢

转载自blog.csdn.net/PitBXu/article/details/84061156
今日推荐