Gitbook editor的相关介绍及与Git、Gitbook的区别

        咋一看 GitBook 的名字，你可能会认为它是关于 Git 的一本书。而当你有所了解之后，你也许会认为它是一个使用 Git 构建电子书的工具。其实不然，GitBook 与 Git 的关系，就像雷锋塔和雷锋那样，没有一点关系！

        实际上，GitBook 是一个基于 Node.js 的命令行工具，支持 Markdown 和 AsciiDoc 两种语法格式，可以输出 HTML、PDF、eBook 等格式的电子书。所以我更喜欢把 GitBook 定义为文档格式转换工具。

         所以，GitBook 不是 Markdown 编辑工具，也不是 Git 版本管理工具。市面上我们可以找到很多 Markdown 编辑器，比如 Typora、MacDown、Bear、MarkdownPad、MarkdownX、JetBrains’s IDE（需要安装插件）、Atom、、CSDN 以及GitBook 自家的 GitBook Editor 等等。

        但 GitBook 又与 Markdown 和 Git 息息相关，因为只有将它们结合起来使用，才能将它们的威力发挥到极致！因此，通常我们会选择合适的 Markdown 编辑工具以获得飞一般的写作体验；使用 GitBook 管理文档，预览、制作电子书；同时通过 Git 管理书籍内容的变更，并将其托管到云端（比如 GitHub、GitLab、码云，或者是自己搭建的 Git 服务器），实现多人协作。

        实际上，GitBook Editor 对于新手来说是个不错的选择，它集成了 GitBook、Git、Markdown等功能，还支持将书籍同步到 gitbook.com 网站，使我们可以很方便地编辑和管理书籍。但是不幸的是，GitBook Editor 的注册和登录需要翻墙，即便注册成功了也可能登录不上，似乎是因为网站最近在升级。

        那接下来我们就使用GitBook Editor中存在的一些概念进行介绍。

（1) README.md

    “README.md”是电子书的介绍内容。相当于书籍的扉页内容。

（2) SUMMARY.md

    “SUMMARY.md”包含了书目，即章节结构

（3) Chapter.md

    " Chapter.md "是你的文章章节内容.

develop相当于一个公共的仓库，你们每个人都复制一下这个仓库，然后在这个develop分支下，再去新建一个属于你自己的分支，然后在你自己的这个分支里面去修改东西，最后再提交、合并到develop分支中，不然每个人都去修改公共仓库的话，就会有冲突。

change library path的意思是可以切换图书的文件，存在多个文件夹，其文件夹中的book当然也会有所不同。

进入cmdàcd 进入到该书的目录下àgitbook serve运行书籍à在浏览器中进入http：//localhost：4000即可预览当前编辑书籍的布局样式

(GitBook) 是一个使用 Git 和 Markdown 来构建书籍的现代化的文档平台工具，虽然已经很好了，但由于gitbook有时候由于网络等原因会导致访问书写草稿不是很方便，所以结合群友的实用情况，对其他的一些工具也做一推荐，这也是写这一篇的主要原因

目前来看是国内最靠谱的选择，支持电子出版

看云为免费用户提供

官网地址： 看云 | 专注技术文档在线创作、阅读、分享和托管

看云文档示例：序言 · ThinkPHP3.2.3完全开发手册 · 看云

在线文档编辑与协同工具，免费用户一共有10GB上传流量

官网地址： https://www.yuque.com/

帮助文档示例： https://www.yuque.com/yuque

BookStack 是基于 Mindoc、使用Go语言的Beego框架开发的功能类似GitBook和看云的在线文档管理系统，实现了文档采集、导入、电子书生成以及版本管理的文档功能，并推出了配套的开源微信小程序 BookChat 和配套的开源手机APP BookChatApp 。

详细 安装部署文档

在线文档管理系统，相当完备，需要有一台服务器自建

演示官网： https://www.bookstack.cn

开源地址： TruthHun/BookStack

非常轻量级的文档，可以托管在Github page

官网及演示： https://docsify.js.org/#/zh-cn/

开源地址： https://github.com/docsifyjs/docsify

这是一个开源文档，可以托管在Github page等平台，支持markdown

演示以及文档： https://docute.org/zh/

开源地址： https://github.com/egoist/docute

这是一个开源接口文档在线管理系统

官网地址： https://www.iminho.me

说明文档及演示： https://www.iminho.me/wiki/docs/mindoc

开源wiki系统，支持多人协作，以及丰富的后台管理设置，个人觉得比mediawiki好看多了

官网及演示： https://www.dokuwiki.org

开源wiki程序

官网及演示： https://www.mkdocs.org

开源地址： https://github.com/mkdocs/mkdoc

---