文档章节

搭建本地的Gitbook

搭桥过河
 搭桥过河
发布于 2017/09/08 14:09
字数 455
阅读 11
收藏 0

gitbook是个写书、制作电子书的好工具。网上使用的话可以考虑使用gitbook.com,不过呢,我还是喜欢使用自己搭建的。

安装Gitbook

gitbook是基于Node.js的命令行工具。首先第一件事就是需要安装node,各个平台的安装方法不同,可以参看官网的指导。我的平台是树莓派3,安装可以参考以前的文章(要是想用最新版的node8,可以将__setup_7.x__替换成__setup_8.x__)。nodejs安装完成后,就可以安装gitbook啦:

$ npm install gitbook-cli -g

新建一本书

先建立目录,然后进入目录运行命令:

$ gitbook init

配置书籍

Gitbook支持插件,通过在书籍的根目录下建立一个__book.json__可以个性化设置Gitbook。 编辑__book.json__设置插件:

{
  "plugins": ["editlink", "splitter", "tbfed-pagefooter", "expandable-chapters", "-lunr", "-search", "search-plus"],
  "pluginsConfig": {
    "editlink": {
      "base": "http://url/edit/master/book/",
      "label": "Edit This Page",
      "multilingual": false
    },
    "tbfed-pagefooter": {
      "copyright":"&copy 戴桥",
      "modify_label": "该文件修订时间:",
      "modify_format": "YYYY-MM-DD HH:mm:ss"
    },
    "expandable-chapters":{}
  }
}

在__"plugins"中添加所需要的插件,在"pluginsConfig"__中对插件进行设置。具体设置可以在网上找到一些参考,如参考附录中的相关网址。

最后必须运行下面的命令安装插件:

$ gitbook install

预览书籍(提供网络浏览)

要预览书籍只需要在书籍所在目录中运行:

$ gitbook serve

然后可以通过浏览器访问 http://localhost:4000 访问。 如果想要更改访问的端口,可以使用__port__参数。如果运行多个书籍预览的话,同时需要设置__lrport__参数:

$ gitbook --port 9001 --lrport 35730 serve ./demo

参考:

© 著作权归作者所有

共有 人打赏支持
搭桥过河
粉丝 0
博文 1
码字总数 455
作品 0
西安
部门经理
私信 提问
GitBook快速教程 1.2 常用操作

版权声明:本文为twowinter原创文章,请联系微信公众号twowinter,未经博主允许不得转载。 https://blog.csdn.net/iotisan/article/details/81121200 这是一个 gitbook 教程,介绍如何基于模...

iotisan
07/19
0
0
用 Github、Markdown 和 GitBook 写开源书

原文同步至:http://www.waylau.com/using-github-markdown-gitbook-write-open-source-books/ 之前一直是在 Github 上写开源书(见:http://www.waylau.com/books/)但,由于 Github 本身的......

waylau
2014/12/11
0
3
GitBook快速教程 1.3 电子书导出

版权声明:本文为twowinter原创文章,请联系微信公众号twowinter,未经博主允许不得转载。 https://blog.csdn.net/iotisan/article/details/81121218 这是一个 gitbook 教程,介绍如何基于模...

iotisan
07/19
0
0
GitBook快速教程 1.1 安装

版权声明:本文为twowinter原创文章,请联系微信公众号twowinter,未经博主允许不得转载。 https://blog.csdn.net/iotisan/article/details/81121116 这是一个 gitbook 教程,介绍如何基于模...

iotisan
07/19
0
0
Gitbook,这个开源出书平台了不起

“程序猿”常常戏称,GitHub 是全球最大的同性交友网站。 只不过,在 GitHub 上交友十分特别,你可以浏览别人在上面托管的项目、代码,通过 Issue 这个功能反馈意见,与项目开发者讨论,还可...

oschina
2015/12/26
17.1K
30

没有更多内容

加载失败,请刷新页面

加载更多

微服务分布式事务实现

https://www.processon.com/view/link/5b2144d7e4b001a14d3d2d30

WALK_MAN
今天
2
0
《大漠烟尘》读书笔记及读后感文章3700字

《大漠烟尘》读书笔记及读后感文章3700字: 在这个浮躁的社会里,你有多久没有好好读完一本书了? 我们总觉得自己和别人不一样,所以当看到别人身上的问题时,很少有“反求诸己”,反思自己。...

原创小博客
今天
4
0
大数据教程(9.5)用MR实现sql中的jion逻辑

上一篇博客讲解了使用jar -jar的方式来运行提交MR程序,以及通过修改YarnRunner的源码来实现MR的windows开发环境提交到集群的方式。本篇博主将分享sql中常见的join操作。 一、需求 订单数据表...

em_aaron
今天
3
0
十万个为什么之什么是resultful规范

起源 越来越多的人开始意识到,网站即软件,而且是一种新型的软件。这种"互联网软件"采用客户端/服务器模式,建立在分布式体系上,通过互联网通信,具有高延时(high latency)、高并发等特点...

尾生
今天
3
0
Terraform配置文件(Terraform configuration)

Terraform配置文件 翻译自Terraform Configuration Terraform用文本文件来描述设备、设置变量。这些文件被称为Terraform配置文件,以.tf结尾。这一部分将讲述Terraform配置文件的加载与格式。...

buddie
今天
5
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部