GitBook 使用

编程之家收集整理的这篇文章主要介绍了GitBook 使用编程之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。

介绍

GitBook是一个基于Node.js的命令行工具,可使用 Github/Git和Markdown来制作精美的电子书,GitBook 并非关 Git的教程。

导出格式有PDF、HTML等,需要添加相应插件

官网:https://www.gitbook.com


安装

安装npm

从网站 https://nodejs.org/en/download/ 上下载并安装

npm -v

查看是否安装成功。

安装gitbook

npm install -g gitbook-cli
gitbook -V

查看是否安装成功。

安装GitBook Editor

这是官方的一个客户端编辑器。可以不安装,直接在GitBook网站上编辑文档也是可以的。

下载地址:https://www.gitbook.com/editor

现在的版本是7.0.12,如果要切换到Markdown编辑器,右下角有个按钮,点击然后选择“Edit Markdown”即可使用Markdown编辑器。如果是旧的版本,


使用

直接使用

页面上,直接点击“+New Book”,根据提示即可创建一本书,然后就可以进行编辑了。

可用editor编辑,也可以网站上直接编辑。

关联GitHub

GitHub:先在上GitHub创建一个仓库。

GitBook:然后在GitBook右上角的个人信息那里,点击“Account Settings”,在界面上选择“GitHub”这个Tab,找到“Integration”选项卡,有一个按钮“Install GitHub integration on this account”,点击,选择刚刚在GitHub创建的仓库即可。

注意:后续如果还需要继续做关联,在GitHub网站的Setting中的“Intalled GitHub Apps”,对GitBook进行配置即可。

GitBook:创建一个新书,然后点击setting,有一个GitHub选项卡,选择关联的GitHub仓库即可。

现在就可用editor编辑,也可以网站上直接编辑,还可以用GitHub进行管理了。


文件结构

除了README.md,还需要SUMMARY.md这个文件,这个是书的结构,如下:

# Summary
* 第一章
	* [第一节](di-yi-zhang/di-yi-jie.md)
	* [第二节](di-yi-zhang/di-er-jie.md)
* 第二章
* 第三章

文件夹“di-yi-zhang”跟SUMMARY.md都在根目录。

默认情况下,如果是直接在网页上编辑的,目录跟文件名都会是拼音,当然可以自己命名。


导出

导出HTML,会在_book文件夹下生成文件

gitbook build

如果是要导出PDF,ePub或者mobi格式的电子书时,需要安装Calibre电子书阅读/管理器和命令行工具,不然可能会报错“EbookError: Error during ebook generation: 'ebook-convert'”。

导出PDF

gitbook pdf

其他功能

https://chrisniael.gitbooks.io/gitbook-documentation/content/index.html

插件搜索地址:https://plugins.gitbook.com/

总结

以上是编程之家为你收集整理的GitBook 使用全部内容,希望文章能够帮你解决GitBook 使用所遇到的程序开发问题。

如果觉得编程之家网站内容还不错,欢迎将编程之家网站推荐给程序员好友。

本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您喜欢寻找一群志同道合、互帮互助的学习伙伴,可以点击下方链接加入:
编程之家官方1群:1065694478(已满)
编程之家官方2群:163560250(已满)
编程之家官方3群:312128206

相关文章

猜你在找的开发工具相关文章

1. 安装制作工具 mkisofs 2. Linux 操作系统镜像 iso 打包 3. 校验并写入 md5 值
最近在学习 MySQL 的 bin-log 时候考虑到数据备份的问题,突然想到如果能将数据通过 Linux 命令行方式备份到百度网盘,那是一件多么牛逼的事情。百度网盘有免费的 2TB 存储空间,而且有
kickstart 能实现 linux 系统的自动化安装,需要设置 ks.cfg 文件,而这个 ks.cfg 文件的生成最好使用 system-config-kickstart 工具生成,比较准确,也
介绍 GitBook是一个基于Node.js的命令行工具,可使用 Github/Git和Markdown来制作精美的电子书,GitBook 并非关 Git的教程。 导出格式有PDF、HTML等,需要添
Let’s Encrypt是一个由非营利性组织互联网安全研究小组(ISRG)提供的免费、自动化和开放的证书颁发机构(CA)。 简单的说,借助Let’s Encrypt颁发的证书可以为我们的网站免费启用
最近再研究图床,注册的阿里云域名备案还在审批,所以七牛云图床暂时没用,所以试下用PicGo+ Gitee PicGo - 基于 electron-vue 开发的图床工具 PicGo目前支持了微博图床,
PyCharm下载地址:https://www.jetbrains.com/pycharm/download/ 永久激活 这里主要介绍永久激活的方式,永久激活后,就可以放心使用了,一劳永逸,5分钟就能
史上最全vscode配置使用教程 工欲善其事,必先利其器。想要优雅且高效的编写代码,必须熟练使用一款前端开发工具。但前端开发工具数不胜数,像HBuilder、Sublime Text、WebStorm