码迷,mamicode.com
首页 > 其他好文 > 详细

GitBook配置

时间:2015-05-11 14:18:49      阅读:939      评论:0      收藏:0      [点我收藏+]

标签:

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.

 

GitBook配置

标签:

原文地址:http://www.cnblogs.com/SpongeBob-GitHub/p/4494163.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!