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

2019独角兽企业重金招聘Python工程师标准>>>

环境：全新的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 [email protected] -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

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

你可能感兴趣的:(markdown,git,python)