gitbook命令

安装gitbook命令
前提:已经安装nodejs
1 | npm install -g gitbook-cli |
查看版本号
1 | gitbook -V |
gitbook命令
gitbook -h
1 | Usage: gitbook [options] [command] |
gitbook help
1 | build [book] [output] 编译指定目录,输出Web格式,输出一个静态网站到目录[output] |
开始写
从gitbook直接克隆到本地开始写
会自动生成chapter1.md,可以删除也可以直接修改名称,编辑完后直接提交
在本地已编辑好书后,提交到远程gitbook仓库
- 拿到提交的地址,如果为新书,则先新建gitbook然后拿到地址
git init
该目录- 添加远程地址
1
git remote add gitbook https://push.gitbook.io/username/book-name.git
注:如果是用第三方登录,如github, twitter等,要先到账户设置中设置用户名和密码用于验证。
发布
1 | git add |
安装插件
更换主题
在npm上面搜索gitbook-theme。安装主题和安装插件一样安装。
- 通过npm搜索出来的结果提示安装
npm install gitbook-theme-maxiang
- 根目录新建一个文件book.json,选项参见
1
2
3{
"plugins": ["thePlugin"]
} - 运行
gitbook install
安装json文件中的所有插件 gitbook serve
预览
可以删除npm下载下来的主题文件夹,_book保留提交,会生成的新的样式文件。
更换封面
错误集锦
1 在启动gitbook serve时,报错:
1 | TypeError: Path must be a string. Received undefined |
不是真的路径有错误,而是该文件里面的内容有无法识别,转换为html格式文件。文件里面的HTML标签一定要放在代码块里面。
2 read时只显示其中一部分的内容
可能在写中间某个文件时,里面有无法生成html格式的内容,导致之后的文件都没有编译成功。
- 本文标题:gitbook命令
- 创建时间:2017-09-01 16:00:00
- 本文链接:2017/09/01/git/gitbook命令/
- 版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!