gitbook
简介：
在macOS上安装gitbook安装nodejs, 在macOS上, 只要安装了Xcode, nodejs就会被默认安装node -V, 显示当前系统的node版本号npm install -g npm, 更新当前系统的npm版本npm install -g gitbook-cli, 安装...
在macOS上安装gitbook
- 安装nodejs, 在macOS上, 只要安装了Xcode, nodejs就会被默认安装
- node -V, 显示当前系统的node版本号
- npm install -g npm, 更新当前系统的npm版本
- npm install -g gitbook-cli, 安装gitbook命令行工具
- gitbook -V, 查看当前的gitbook-cli和gitbook版本, 这个时候会自动安装gitbook, gitbook-cli和gitbook是两个软件, 使用gitbook-cli中的gitbook命令来管理我们的gitbook
- brew cask install gitbook-editor, 安装gitbook编辑器
- 为了生成电子书, 安装ebook-convert, 下载 Calibre application, 接着
sudo ln -sv /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin, 如果要生成pdf的话, 则使用gitbook pdf . ./mybook.pdf
gitbook命令
- gitbook ls-remote: 列出远程gitbook可用的版本
- gitbook ls: 列出本地gitbook可用的版本
- gitbook init: 初始化目录为gitbook的根目录
- gitbook build: 编译成静态的html
- gitbook serve: 启动服务到localhost:4000
- gitbook uninstall 2.2.2: 卸载对应的版本的gitbook
- gitbook update: 更新gitbook
创建电子书步骤
- mkdir book
- cd book
- gitbook init
- gitbook build
- gitbook serve
配置
通过book.json文件修改
gitbook editor 使用注意点
- gitbook editor 对中文的支持不太好, 所以最好在终端中创建
- gitbook editor 存放的图片都放在asset中, 所以不需要担心URL
