使用gitbook editor管理个人笔记/制作PDF电子书

原创
2017/02/26 13:07
阅读数 3.4K

环境: 全新的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

展开阅读全文
打赏
0
2 收藏
分享
加载中
更多评论
打赏
0 评论
2 收藏
0
分享
返回顶部
顶部