红联Linux门户
Linux帮助

使用gitbook editor legacy制作电子书

发布时间:2017-03-05 15:00:02来源:linux网站作者:cyper
环境:全新的ubuntu16.04.2 LTS + Oh my ZSH
 
旧版的gitbook editor章节编号比如1.1, 1.2会自动生成,左边目录树节点可以任意拖动位置(章节号会自动重排), 这些功能对于个人组织笔记再完美不过, 但这些功能在新版的gitbook editor中已经没有了!
幸好还能在github上找到旧版的gitbook editor,作文以记之:
使用gitbook editor legacy制作电子书
 
下载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个基本文件:
1.README.md
2.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.linuxdiyf.com/linux/28920.html