Powered by md-Blog  文 - 篇  访客 -

Gitbook教程


更新:2020-03-17 12:51:18  /  创建:2020-03-17 12:50:32  /  分类:大前端  / 
不要删除

安装 Node.js

https://nodejs.org/en/download/

安装 GitBook

$ npm install gitbook-cli -g

查看版本

$ gitbook -V

创建电纸书

$ mkdir myBook
$ cd myBook

初始化

$ gitbook init

预览

$ gitbook build

$ gitbook serve

生成电子书文件 mobi

$ gitbook mobi ./ ./myBook.mobi

本功能依赖:Calibre

Calibre 安装完毕后,对于 Mac OS X 系统,还需要先设置一下软链接:

$ ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

编辑电子书

初始化后的目录中会出现“README.md(电子书简介文件)”和“SUMMARY.md(导航目录文件)”两个基本文件。除此之外还可以手动新建其它“Glossary.md(书尾的词汇表)”、“book.json(电子书配置文件)”。电子书的正文内容可以根据自己的喜好创建新的后缀为 .md 文件,如“chapter01.md”,然后用 MarkDown 编写具体的文本内容即可。下面对这些文件分别做详细介绍。

1、README.md

此文件是简单的电子书介绍,可以把您所制作的电子书做一下简单的描述:

# 简介

这是我的第一本使用 GitBook 制作的电子书。

2、SUMMARY.md

此为电子书的导航目录文件,每当新增一个章节文件就需要向此文件中添加一条记录。对于 Kindle 电子书来说,此文件所呈现的目录结构就是开头的目录内容和“前往”的目录导航。

# Summary

* [简介](README.md)
* [第一章](section1/README.md)
* [第二章](section2/README.md)

如果需要“子章节”可以使用 Tab 缩进来实现(最多支持三级标题)。

3、Glossary.md

对于电子书内容中需要解释的词汇可在此文件中定义。词汇表会被放在电子书末尾。其格式如下所示:

# 电子书
电子书是指将文字、图片、声音、影像等讯息内容数字化的出版物和植入或下载数字化文字、图片、声音、影像等讯息内容的集存储和显示终端于一体的手持阅读器。

# Kindle
Amazon Kindle 是由 Amazon 设计和销售的电子书阅读器(以及软件平台)。用户可以通过无线网络使用 Amazon Kindle 购买、下载和阅读电子书、报纸、杂志、博客及其他电子媒体。

4、book.json
“book.json”是电子书的配置文件,可以看作是电子书的“原数据”,比如 title、description、isbn、language、direction、styles 等,更多点击http://help.gitbook.com/format/configuration.html查看。它的基本结构如下所示:

{
    "title": "我的第一本電子書",
    "description": "用 GitBook 制作的第一本電子書!",
    "isbn": "978-3-16-148410-0",
    "language": "zh-tw",
    "direction": "ltr"
}

5、普通章节.md 文件
普通章节.md 文件可以使用您感觉顺手的文本编辑器编写。MarkDown 的写法可以点击http://help.gitbook.com/format/markdown.html查看相关示例。每编写一个 .md 文件,不要忘了在“SUMMARY.md”文件中添加一条记录哦。

6、电子书封面图片
GitBook 帮助文档建议封面图片的尺寸为 1800*2360 像素并且遵循建议:

没有边框
清晰可见的书本标题
任何重要的文字在小版本中应该可见
图片的格式为 jpg 格式。把图片重命名为“cover.jpg”放到电子书项目文件夹即可。

不要删除

小站不易,感谢支持!