环境: 全新的ubuntu16.04.2 LTS + Oh my ZSH
先来看一张在gitbook editor中编辑笔记的效果图, 左边是树状的目录结构(可以拖拽--editor会自动更新章节编号), 右边是markdown编辑区和预览区.
说明: 旧版的gitbook editor章节编号比如1.1, 1.2会自动生成,左边目录树节点可以任意拖动位置(章节号会自动重排), 这些功能对于个人组织笔记再完美不过, 但这些在新版的gitbook editor中已经没有了!
下载gitbook legacy: https://github.com/GitbookIO/editor-legacy/releases
文件名为: gitbook-linux64.tar.gz## 安装node (我喜欢用nvm安装) wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.1/install.sh | bash source ~/.zshrc nvm ls-remote --lts nvm install v4.8.0 npm install -g cnpm --registry=https://registry.npm.taobao.org## 安装gitbook命令行(加上了@1.5.0参数 , 老版的) cnpm install gitbook@1.5.0 -g 注: 翻了一下git上的提交记录, 1.5.0是2014年的版本, 差不多对应gitbook legacy 1.0.x使用gitbook editor随便写点什么东西。 然后开始用命令生成pdf
➜ gitbook pdf hello Starting build ... Need to install ebook-convert from Calibre## 安装 ebook-convert 从这里找到安装脚本 http://calibre-ebook.com/download_linux 一行命令搞定(版本是2.80.0), 我当时装的版本是2.16.0~sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"
卸载的方法:sudo calibre-uninstall
默认装在了/opt/calibre ... 然后会建一堆符号链接,如下: Creating symlinks... Symlinking /opt/calibre/calibredb to /usr/bin/calibredb Symlinking /opt/calibre/web2disk to /usr/bin/web2disk Symlinking /opt/calibre/calibre to /usr/bin/calibre Symlinking /opt/calibre/ebook-viewer to /usr/bin/ebook-viewer Symlinking /opt/calibre/lrf2lrs to /usr/bin/lrf2lrs Symlinking /opt/calibre/ebook-convert to /usr/bin/ebook-convert Symlinking /opt/calibre/ebook-polish to /usr/bin/ebook-polish Symlinking /opt/calibre/ebook-device to /usr/bin/ebook-device Symlinking /opt/calibre/markdown-calibre to /usr/bin/markdown-calibre Symlinking /opt/calibre/ebook-edit to /usr/bin/ebook-edit Symlinking /opt/calibre/ebook-meta to /usr/bin/ebook-meta Symlinking /opt/calibre/calibre-smtp to /usr/bin/calibre-smtp Symlinking /opt/calibre/lrs2lrf to /usr/bin/lrs2lrf Symlinking /opt/calibre/lrfviewer to /usr/bin/lrfviewer Symlinking /opt/calibre/calibre-parallel to /usr/bin/calibre-parallel Symlinking /opt/calibre/calibre-debug to /usr/bin/calibre-debug Symlinking /opt/calibre/calibre-server to /usr/bin/calibre-server Symlinking /opt/calibre/fetch-ebook-metadata to /usr/bin/fetch-ebook-metadata Symlinking /opt/calibre/calibre-customize to /usr/bin/calibre-customize Setting up command-line completion... Installing zsh completion to: /usr/share/zsh/vendor-completions/_calibre Installing bash completion to: /usr/share/bash-completion/completions/calibre Setting up desktop integration... Creating un-installer: /usr/bin/calibre-uninstall Run "calibre" to start calibre 呃, gitbook依赖的ebook-convert出现在了上面的列表之中。## 生成电子书
假设电子书放在~/gitbook/hello下 cd ~/gitbook gitbook pdf hello 会在hello目录下生成 book.pdf gitbook epub hello gitbook mobi hello cd hello gitbook serve -p 8080 启动本地的http服务器 ## Gitbook的基本规则 (转载部分)Gitbook需要2个基本文件:
- README.md
- SUMMARY.md
README.md是关于你的书的介绍,而SUMMARY.md中则包含了书目,即章节结构,它的格式大致是:
* [第1章](c1.md) * [第1节](c1s1.md) * [第2节](c1s2.md)* [第2章](c2.md)
剩下的东西就很好理解了,你只需要编写相应章节即可。在编辑完README.md和SUMMARY.md后,你可以运行以下命令:
$ gitbook serve -p 8080 .
Gitbook首先把你的Markdown文件编译为HTML文件,并根据SUMMARY.md生成书的目录。所有生存的文件都保存在当前目录下的一个名为_book的子目录中。完成这些工作后,Gitbook会作为一个HTTP Server运行,并在8080端口监听HTTP请求。
运行以上命令后,打开浏览器,在地址栏输入:http://localhost:8080
即可看到你的书页了。
其中位于左侧书目顶部的Introduction
一节就编译自README.md,而书目本身自编译自SUMMARY.md。你要在自己的网站上发布新书,只需把_book目录复制到服务器相应目录即可。至此Gitbook的基本用法就介绍完毕。下面简单讨论下Gitbook的其他应用,包括Gitbook的插件、与Github的融合、Gitbook客户端、Gitbook平台,以及Gitbook的问题。
参考:http://www.ituring.com.cn/article/127645