如何使用 Gitbook 在本地创建电子书 - 文章教程

如何使用 Gitbook 在本地创建电子书

发布于 2020-11-24 字数 3764 浏览 1725 评论 0

安装 gitbook 本地版本

下载 Node.js:https://nodejs.org/en/download/,安装 Node.js 到硬盘里,这里我安装到 D 盘的 nodejs 文件夹里,打开 cmd.exe,通过命令行进入 D 盘的 nodejs 文件夹。

image

通过 Node.js 安装 gitbook,在命令行输入 npm install -g gitbook-cli ,这样就安装了 gitbook。

image

开始建立一本书

建立一个文件夹,文件夹的名字就是书的名字,我在E盘建立了 pptMaking 的文件夹。

通过 cmd 命令行进入该文件夹, 输入 gitbook init,回车执行该命令

执行完后,看文件夹里新增了两个文件。

README.md —— 用来写书籍的介绍
SUMMARY.md —— 用来配置书籍的目录结构

使用 Typora 编辑 SUMMARY.md

# Summary

* [Introduction](README.md)
* [第一章](chapter1/README.md)
  * [第一节](chapter1/section1.md)
  * [第二节](chapter1/section2.md)
  * [第三节](chapter1/section3.md)
  * [第四节](chapter1/section4.md)
* [第二章](chapter2/README.md)
  * [第一节](chapter2/section1.md)
  * [第二节](chapter2/section2.md)
  * [第三节](chapter2/section3.md)
  * [第四节](chapter2/section4.md)
* [第三章](chapter3/README.md)
  * [第一节](chapter3/section1.md)
  * [第二节](chapter3/section2.md)
  * [第三节](chapter3/section3.md)
  * [第四节](chapter3/section4.md)
* [第四章](chapter4/README.md)
  * [第一节](chapter4/section1.md)
  * [第二节](chapter4/section2.md)
  * [第三节](chapter4/section3.md)
  * [第四节](chapter4/section4.md)
* [结束](end/README.md)

gitbook 初始化。回到命令行,在 pptMaking 文件下执行 gitbook init 命令。这时,gitbook 会查找 SUMMARY.md 文件中描述的目录和文件,如果没有则会新建文件和目录。所以说,你想批量建立目录和文件,这是一个好方法。

image

通过网页显示你的书籍。在命令行里执行 gitbook serve,命令会将 markdown 格式转换为 html 格式。命令里最后会提示 Serving book on http://localhost:4000,复制 http://localhost:4000 到浏览器里,会显示你的书 籍。

image

image

注意,如果命令行里显示缺失什么文件,而无法显示

输出你的书籍

输出的命令

可以通过执行 gitbook build 命令构建书籍,默认是生成静态网站输出到_book目录。

上面这一步包括在gitbook serve里。

通过build命令可以指定书籍路径

gitbook build [书籍路径] [输出路径]

生成 pdf 格式

gitbook pdf ./ ./pptMaking.pdf

生成 epub 格式

gitbook epub ./ ./pptMaking.epub

生成 mobi 格式

gitbook mobi ./ ./pptMaking.mobi

如果不能生成,需要下载 ebook-convert,或者在Typora中安装Pandoc进行导出。

image

将书籍 push 到github

在 mybook 目录下执行 git init 初始化仓库,执行 git romate add 添加远程仓库,然后 commit,push,pull

资源

如果你对这篇文章有疑问,欢迎到本站 社区 发帖提问或使用手Q扫描下方二维码加群参与讨论,获取更多帮助。

扫码加入群聊

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!

关于作者

JSmiles

生命进入颠沛而奔忙的本质状态,并将以不断告别和相遇的陈旧方式继续下去。

2891 文章
评论
84935 人气
更多

推荐作者

勿忘心安

文章 0 评论

ekko

文章 0 评论

江挽川

文章 0 评论

献世佛

文章 0 评论

Meets

文章 0 评论