Skip to content

Latest commit

 

History

History
264 lines (180 loc) · 12.1 KB

2.md

File metadata and controls

264 lines (180 loc) · 12.1 KB

使用

1、新建mybook文件夹，初始化：gitbook init

会自动生成目录

README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置

2、启动Typora编辑器，引入文件夹

img

3、目录编辑SUMMARY.md

img

4、可以使用VSCode进行辅助编辑

img

5、浏览器浏览：gitbook serve

执行 gitbook serve 来预览这本书籍，执行命令后会对 Markdown 格式的文档进行转换，默认转换为 html 格式，最后提示 “Serving book on http://localhost:4000”

6、构建书籍：gitbook build

　　默认：将生成的静态网站输出到 _book 目录
　　指定路径：gitbook build [书籍路径] [输出路径]
　　指定端口：gitbook serve --port 2333
　　生成pdf格式：gitbook pdf ./ ./mybook.pdf
　　生成epub格式：gitbook epub ./ ./mybook.epub　　
　　生成 mobi 格式：gitbook mobi ./ ./mybook.mobi

注意：如果生成不了，你可能还需要安装一些工具，比如 calibre、ebook-convert，或者在 Typora 中安装 Pandoc 进行导出。

7、用 Git 做版本管理

a、在远端建好git仓库，在 mybook 目录下执行 git init 初始化仓库，执行 git remote add 添加远程仓库。接着就可以愉快地 commit，push，pull …

b、将生成的html放在自己的服务器上,就能直观看到你想要的文档效果

8、相关配置及优化

目录结构:

├── book.json
├── README.md
├── SUMMARY.md
├── chapter-1/
|    ├── README.md
|    ├── something.md
├── chapter-2/
|    ├── README.md

a、GitBook 特殊文件的功能：

文件名 描述
book.json 配置数据 (optional)
README.md 电子书的前言或简介 (required)
SUMMARY.md 电子书目录 (optional)
GLOSSARY.md 词汇/注释术语列表 (optional)

b、book.json的配置说明:

变量 描述
root 包含所有图书文件的根文件夹的路径，除了 book.json
structure 指定自述文件，摘要，词汇表等的路径
title 您的书名，默认值是从 README 中提取出来的。在 GitBook.com 上，这个字段是预填的。
description 您的书籍的描述，默认值是从 README 中提取出来的。在 GitBook.com 上，这个字段是预填的。
author 作者名。在GitBook.com上，这个字段是预填的。
isbn 国际标准书号 ISBN
language 本书的语言类型 —— ISO code 。默认值是 en
direction 文本阅读顺序。可以是 rtl （从右向左）或 ltr （从左向右），默认值依赖于 language 的值。
gitbook 应该使用的GitBook版本，并接受类似于 >=3.0.0 的条件。
links 在左侧导航栏添加链接信息
plugins 要加载的插件列表(官网插件列表)
pluginsConfig 插件的配置

c、Gitbook 默认带有 5 个插件：

highlight - 语法高亮插件
search - 搜索插件
sharing - 分享插件
font-settings - 字体设置插件
livereload - 热加载插件

d、去除自带插件:

可以在插件名称前面加 -


"plugins": [
        "-lunr", 
        "-search",导航栏查询功能（不支持中文）
        "search-pro",搜索支持中文
        "-highlight",代码高亮
        "-sharing",右上角分享功能
        "-font-settings",字体设置（最上方的"A"符号）
        "-livereload",为GitBook实时重新加载
        "expandable-chapters-small",
        "book-summary-scroll-position-saver",
        "chapter-fold",
        "multipart",
        "popup"
    ]

Tips：添加插件后要进行安装 gitbook install

e、GitBook插件列表

book.json文件没有的话,可以自己创建,其他文件可以自动生成

img

相关配置插件事例参考:

1、https://www.liqingbo.cn/docs/gitbook/content/config.html

2、https://zhousiwei.gitee.io/mybook/notes/gitbook_config.html

3、https://www.jianshu.com/p/427b8bb066e6

4、gitbook常用的插件

遇到的问题:

nodejs版本降级
今天在运行yarn/npm来安装node.js的时候，发现安装了最新的14版本，但是因为gitbook插件没有升级的原因，我需要node.js版本为12.0版本。我的安装命令为：
解决方法:
npm install -g n
sudo n 12.3.1

npm install失败，出现以下错误:
Error: connect ETIMEDOUT 104.16.24.35:443

解决办法：(换国内的镜像)
npm config set registry https://registry.npm.taobao.org/

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

报错:(node:4840) [DEP0066] DeprecationWarning: OutgoingMessage.prototype._headers is deprecated

点击第二三层级的时候会不能展开的问题


解决办法:
文件名层级不对,自己仔细查找并修改就好了