GitBook 用法

GitBook是一个使用GitHub/Git和Markdown/AsciiDoc用来构建漂亮的书籍的工具。

要求


安装好了nodejsnpm

全局安装GitBook


使用npm来安装GitBook。

$ npm install gitbook-cli -g

初始化一本书籍


可以使用gitbook init命令来初始化一本书籍,但是这里我们手动来初始化。
建立一下的文件结构。

├───zh/
│   └───INTRO.md
│   └───SUMMARY.md
└───INTRO.md
└───LANGS.md
└───book.json

book.json文件是GitBook的配置文件。这里我们需要指定GitBook的版本、语言、结构(修改默认的readme文件名)。

{
    "gitbook": ">=2.0.0",
    "language": "zh",
    "structure": {
        "readme": "INTRO.md"
    }
}

LANGS.md文件用来说明本书有哪几种语言版本。这里只设置了中文版,并且书籍在zh目录下。

* [中文版](zh/)

INTRO.md(默认情况下是readme.md)是用来介绍书籍的介绍页。

# title
description

SUMMARY.md是用来定义书籍的目录的。

# Summary

* [Part I](part1/README.md)
    * [Writing is nice](part1/writing.md)
    * [GitBook is nice](part1/gitbook.md)
* [Part II](part2/README.md)
    * [We love feedback](part2/feedback_please.md)
    * [Better tools for authors](part2/better_tools.md)

接下来就可以开始书籍的写作了。

发布静态网站


书籍写好了可以发布成PDF, ePub, mobi或者静态网站任意一种形式。

$ gitbook build

执行了上面的命令后,就会在当前目录下生成一个_book目录,里面就是本书的网站形式了。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 本文详细讲解了 Gitbook 生成电子书的完整过程,内容包括:安装、命令、配置、文档结构、生成电子书、部署。限于...
    静默虚空阅读 11,304评论 9 138
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,953评论 6 342
  • Gitbook是一个命令行工具,可以把你的Markdown文件汇集成电子书,并提供PDF等多种格式输出。你可以把G...
    陳云峰阅读 6,422评论 1 7
  • 龙头牛耳麋鹿身,虎背熊腰覆蛇鳞。 鹿角狮眼蛇脖子,蜃腹鹰爪行如翷。 百兽武装祥瑞神,尊贵灵异乃麒麟。 行不踩蚁为仁...
    欣荣Y阅读 719评论 4 17
  • 01 前两天拜访客户,接待我的是个很年轻的姑娘。 说是姑娘,后来才知道其实是个已经有二胎的辣妈了,但我依然愿意这样...
    猫妖叨叨阅读 1,948评论 26 34