GitBook Editor电子书编写说明
- 1、安装软件
- 2、创建文档
- 3、编辑文档
- 4、生成电子书
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