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

Posted 2023-04-04

参考技术A         咋一看 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 Editor编辑器中使用markdown语法总结

markdown是Gitbook中使用的标记语言，通常我们会使用编辑器去编辑电子书，之后再使用gitbook上传。在编辑器中也可以虽然说可以使用图形化的操作，但是也可以使用编写markdown去写电子书。

在Gitbook Editor编辑器中点击工具栏中的””会显示左侧的目录栏，点击图标””，会出现markdown语法编辑栏和非markdown编辑栏，如下图所示，左侧可以使用markdown语法编辑电子书内容，右侧则为编辑内容的实际显示效果。

1、标题

Markdown支持两种标题的语法，类Setext和类atx形式。

类 Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），例如：

类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶，例如：

类Atx形式在两行之间输入---才会出现和类setext一样的效果

2、  标记区块

markdown标记区块（Blockquotes）使用”>”的引用方式，需要在每行的前面加上”<”

3、列表

无序列表使用星号、加号或者减号做列表标记：

有序列表则使用数字接着一个英文句点：

列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符：

4、链接

Markdown支持两种形式的链接语法，行内和参考。不管哪一种，链接的文字都是用[]方括号来标记。

建立一个行内形式的链接，只需在方括号后面马上接（）括号并在括号里插入链接网址链接即可。如果还想加上链接的title文字，在网址后面用双引号把title文字包起来就可以了。

参考形式的链接使用另外一个方括号接在链接文字的括号后面，而在第二个方括号里面要填入用以辨识链接的标志。

当然也可以链接图片

链接的定义可以放在文件中的任何一个地方，你也可以放到段落的最后，就像是注解。

5、表格

表格的格式如下所示，可以按照格式添加行添加列。

参考文章：

https://github.com/othree/markdown-syntax-zhtw

http://wowubuntu.com/markdown/basic.html

本文出自 “xiaoxiaozhou” 博客，请务必保留此出处http://xiaoxiaozhou.blog.51cto.com/4681537/1908263