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.

 

posted @   Trybst  阅读(465)  评论(0编辑  收藏  举报
编辑推荐:
· 对象命名为何需要避免'-er'和'-or'后缀
· SQL Server如何跟踪自动统计信息更新?
· AI与.NET技术实操系列:使用Catalyst进行自然语言处理
· 分享一个我遇到过的“量子力学”级别的BUG。
· Linux系列:如何调试 malloc 的底层源码
阅读排行:
· C# 中比较实用的关键字,基础高频面试题!
· .NET 10 Preview 2 增强了 Blazor 和.NET MAUI
· Ollama系列05:Ollama API 使用指南
· 为什么AI教师难以实现
· 如何让低于1B参数的小型语言模型实现 100% 的准确率
点击右上角即可分享
微信分享提示