3

gitbook制作电子书

 2 years ago
source link: https://shadowdragons.github.io/2019/05/26/gitbook/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client
gitbook制作电子书 - ben blog

这里以mac电脑安装为例。

GitBook的安装其实非常简单。最好方法是通过npm安装。

首先安装nodejs和npm。

brew install node
brew install npm

接下来就可以安装gitbook了。

npm install gitbook-cli -g

执行执行gitbook -V验证：

$ gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

到这里安装就完成了。

进入创建书籍的目录，执行：

gitbook init

这时会在目录下生成两个文件。

  • README.md 书籍的简介
  • SUMMARY.md 书籍的目录

一般GitBook的目录结构是这样的:

.
├── book.json
├── README.md
├── SUMMARY.md
├── cover.png
├── chapter-1/
|   ├── README.md
|   ├── something1.md
|   └── something2.md
└── chapter-2/
    ├── README.md
    ├── something1.md
    └── something2.md

由于初始化只生成了README.md和SUMMARY.md，其他文件和目录需要我们手动创建。

book.json

这个文件相当于书籍的配置文件，书籍相关的配置包括书名、作者等信息。

变量 说明
root 包含所有图书文件的根文件夹的路径，除了book.json
structure 指定自述，摘要，词汇表等的路径。
title 书的标题，默认值从README中提取。
description 您的图书说明，默认值从自述文件中提取。
author 作者姓名。
isbn 书的国际码ISBN
language 语言ISO规范的书的语言，默认值是en
direction 文本的方向。可以是rtl或ltr，默认值取决于language的值
gitbook GitBook的版本。使用SemVer规范并接受诸如“> = 3.0.0”的条件
SUMMARY.md

SUMMARY.md定义文档的菜单。

里面的[]内的内容是标题，()内是文档的路径，章节和子章节用四个空格或者tab键来分级。

示例如下：

* [简介](README.md)
* [第一部分](chapter-1/README.md)
    * [Writing很牛](chapter-1/something1.md)
    * [GitBook很牛](chapter-1/something2.md)
* [第二部分](chapter-1/README.md)
    * [我们喜欢社交网络](chapter-1/something1.md)
    * [更好的写作工具](chapter-1/something2.md)
cover.png

书籍封面。

我们可以通过模板快速制作我们的封面。工具链接 >

通过在线工具生成了我们下面的测试封面。

2.png

在书籍根目录下运行：

gitbook serve

输出结果：

$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed 
info: loading plugin "livereload"... OK 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 7 pages 
info: found 1 asset files 
info: >> generation finished with success in 0.7s ! 

Starting server ...
Serving book on http://localhost:4000

现在就可以通过浏览器访问http://localhost:4000进行浏览。

1.png

命令语法：

gitbook [文件类型] [书籍根目录] [生成文件路径/文件名]

生成PDF文件

$ gitbook pdf ./ ./mybook.pdf

结果截图：

3.png

生成ePub文件
$ gitbook epub ./ ./mybook.epub
生成Mobi文件
$ gitbook mobi ./ ./mybook.mobi
Powered By Valine
v1.4.18

report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK