【教程】GitBook Editor编写电子书

1、安装软件

下载并安装GitBook Editor软件，网上资源很多，根据自己系统选用即可

官网参考：GitBook - Where technical teams document.

2、创建文档

1）运行GitBook Editor，点击右下角Do that later进入书库界面

2）创建文档

• 新建空白文档：书库界面点击+New Book，输入电子书名称，点击Confirm进入编辑界面
  
• 导入已有文档：书库界面点击左上角GitBook Editor，选择Open…，浏览电子书目录并打开
  

3）编辑界面点击左上角Book，选择Responsitory Settings…，绑定远程仓库的HTTP地址

4）左上角查看/拣选当前分支，可点击Create a branch新建分支

3、编辑文档

1）点击右下角问号图标，开启Edit Markdown，即可开始编写（插入的每张图片不超过 1 MB）

Markdown语法参考：http://markdown.p2hp.com/basic-syntax/

2）在book.json文件中配置文档信息、引用插件等

{
    "title": "文档标题",
    "author": "作者名称",
    "description": "文档描述",
    "language": "zh-hans",
    "plugins": [
        "code",
        "-lunr",
        "-search",
        "search-pro",
        "splitter",
        "-sharing",
        "sharing-plus",
        "tbfed-pagefooter",
        "popup",
        "versions-select"
    ],
    "pluginsConfig":
    {
        "code":
        {
            "copyButtons": true
        },
        "sharing":
        {
            "douban": false,
            "facebook": false,
            "google": false,
            "pocket": false,
            "qq": false,
            "qzone": false,
            "twitter": false,
            "weibo": false,
            "all": []
        },
        "tbfed-pagefooter":
        {
            "copyright": "版权声明",
            "modify_label": "文档修订时间：",
            "modify_format": "YYYY-MM-DD HH:mm:ss"
        },
        "versions":
        {
            "options": [
            {
                "value": "https://www.csdn.net/v1.0",
                "text": "1.0版本"
            },
            {
                "value": "https://www.csdn.net/v2.0",
                "text": "2.0版本"
            }]
        }
    }
}

3）编辑过程中注意及时点击右上角Save或Ctrl+S保存更新，点击云朵图标的Publish按钮可一键push到远程仓库

4、生成电子书

1）预览电子书命令：

gitbook serve

2）生成PDF命令：

gitbook pdf