GitBook新手入门

GitBook新手入门

GitBook新手入门

GitBook是使用Git管理书籍项目，使用Markdown撰写书籍，并使用GitHub和GitBook网站进行托管的一个实用工具。下面简单说一下新手如何使用该强大的工具。

创建Gitbook账户

首先去​​GitBook​​注册一个账号然后在账号中新建一个Organzation（组织）在该组织中新建一个Space（一般一个Space包含一本书，一个组织中可以创建多个Space）

命令行工具安装

安装​​Node.js​​可以使用​​node -v​​检测是否安装成功使用npm包管理工具安装GitBook命令行工具​​​npm install gitbook-cli -g​​​可以使用​​gitbook -V​​检测是否安装成功

书籍编辑

初始化书籍样本文件（切换到撰写的书籍目录下，执行如下命令）​​​gitbook init​​​该命令会自动创建SUMMARY.md和README.md。README.md中书写对本书的介绍，SUMMARY.md是本书的目录。如果提前创建好这两个文件，在执行上面的命令，则该命令会按照SUMMARY.md文件中设置的目录格式自动创建书籍的目录。例如，如果提前建立好如下的SUMMARY.md目录文件，则会根据文件中的路径自动创建书籍文件夹及文件中的markdown文本文件。

前言](README.md) - [Python基础](Python基础/README.md) - [Python环境搭建及基本数据类型](Python基础/Python环境搭建及基本数据类型.md) - [运算符及字符串](Python基础/运算符及字符串.md) - [序列与字典](Python基础/序列与字典.md) - [流程控制语句](Python基础/流程控制语句.md) - [函数](Python基础/函数.md) - [面向对象编程初识](Python基础/面向对象编程初识.md) - [面向对象编程高级](Python基础/面向对象编程高级.md) - [Python科学计算](Python基础/Python科学计算.md) - [空间数据处理环境搭建](Python基础/空间数据处理环境搭建.md) - [空间数据基础](空间数据基础/README.md) - [空间参考系统](空间数据基础/空间参考系统.md) - [地图投影](空间数据基础/地图投影.md) - [空间数据](空间数据基础/空间数据.md)

书籍的撰写可以采用任何markdown编辑器，我个人比较推荐Typora，当然也可以使用GitBook官方的GitBook Editor。

需要注意的是撰写过程中插入的图片地址，GitBook会自动转成当前文件所在目录的相对目录。所以我推荐将图片保存在当前文件所在目录下面，然后文件中图片的地址直接使用图片名称即可（图片相对于当前文件所在路径）。 2. 在线预览

​​gitbook serve​​

执行该命令以后在浏览器打开​​ 1. 首先在GitHub上新建一个Repository，然后将本地工程同步到该仓库，具体步骤参间我的博文：​​​新建Git仓库并添加本地项目​​​ 2. 然后在GitBook新建的Space中Integrations中关联GitHub上的该仓库即可。 这样子，每次使用Git命令同步文件到GitHub后，GitBook也会自动同步。其实，就是一个Git项目，不用操心GitBook的任何细节了。

参考资料

​​GitBook Toolchain Documentation​​

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。