GitBook配置

GitBook 是一个通过 Git 和 Markdown 来撰写书籍的工具。
生成格式有:JSON、ePub、PDF、Website !

================================

Git 方式

GitBook 使用 Git 进行写作内容管理。

  • 从用户的角度看,这样能够方便地进行多人协作(连程序源代码都能管好,书籍自然不在话下),还不用学习额外概念或用法

  • 从设计实现的角度看,这样能够合理利用已有工具(不重复造轮)满足产品需求,甚至扩展性更好(Git 相关服务能够利用的太多了)

正所谓:“人发地,地法天,天法道,道法自然”啊。

Markdown

GitBook 不只是利用了 Git,目前非常流行的 Markdown 也被运用其中。

使用 Markdown 最大的好处就是简单:

  • 语法简单,并且能够形象地表达出意图(例如无序列表使用 * ,强调使用 ** ,一个 # 表示 H1、两个 # 表示 H2)

  • 不干扰写作者:语法标记在视觉上对写作者的负面影响不大(不像 HTML 满屏的 <>)

总之,Markdown 就是能够让写作者更专注于内容创作。

不过 GitBook 不只是简单地使用 Markdown,使用 Markdown 编写的内容只是源格式,最终的目标格式可以为 PDF、ePub 等。

================================

[ 配置方式 ]

1> 下载并安装 npm

node-v0.12.0.pkg [http://nodejs.org/download/](http://nodejs.org/download/)

2> 安装 gitbook

```

$ sudo npm install gitbook -g

```

3> 进入终端 cd 到新建的电子书目录

```

$ touch SUMMARY.md

$ gitbook init

```

4> 下载并安装 gitbookEditor,gitbook 本地编辑器 [https://github.com/GitbookIO/editor/releases](https://github.com/GitbookIO/editor/releases)

* 打开并选择刚刚 init 的目录即可编辑

5> 本地预览

```

$ gitbook serve

```

6> 下载并安装 calibre,生成电子书使用

calibre-2.20.0 [http://calibre-ebook.com/download_osx](http://calibre-ebook.com/download_osx)

* 在终端输入

```

$ ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

```

7> 生成电子书

```

$ gitbook epub

或者

$ gitbook pdf

```

8> .gitignore [https://github.com/github/gitignore.git](https://github.com/github/gitignore.git)

================================ 

PS: 

[ 每日一句 ]

静,是一种气质,也是一种修养。 

 

[ 推荐一首英文歌 ]

" Unforgivable Sinner " - Lene MarLin

================================

 

|-> GitHub: SpongeBob-GitHub

|--> Copyright (c) 2015 Bing Ma.

 



" There's always more to learn, and there are always better ways to do what you've done before. " -- Trybst


原文地址:https://www.cnblogs.com/Trybst/p/4494163.html