文档章节

搭建本地的Gitbook

搭桥过河
 搭桥过河
发布于 2017/09/08 14:09
字数 455
阅读 10
收藏 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
西安
部门经理
用 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
requests+正则表达式 爬取 妹子图

  做了一个爬取妹子图某张索引页面的爬虫,主要用request和正则表达式。   感谢 崔庆才大神的 爬虫教学视频 和 gitbook:      B站:https://www.bilibili.com/video/av18202461/ind...

pertinence
04/24
0
0
markdown 文档转 html 工具 - mddoc

mddoc 是一个开源的 markdown 文档转 html 文档工具,它使用 php 开发,支持 php >= 5.4。它生成的 html 可以直接放在网站上,支持全文搜索、自定义 html 模版。 mddoc 同时支持命令行、git...

宇润
06/27
0
0
Centos 7 下 GitBook 的安装与使用

文前说明 作为码农中的一员,需要不断的学习,我工作之余将一些分析总结和学习笔记写成博客与大家一起交流,也希望采用这种方式记录自己的学习之旅。 本文仅供学习交流使用,侵权必删。 不用...

羽杰
2017/09/21
0
0
ASP.NET Core MVC 和 Entity Framework Core 入门教程

前言 本文翻译自:Getting started with ASP.NET Core MVC and Entity Framework Core using Visual Studio 示例应用程序是虚构的Contoso大学的网站, 包括学生入学,课程创建和教师任务等功...

程序员长春
2017/10/12
0
0

没有更多内容

加载失败,请刷新页面

加载更多

自定义Ubuntu/Windows双系统引导菜单主题

学习Linux自然少不了要装双系统,其中Ubuntu便是我们用的最多的Linux系统。装完双系统后,Ubuntu会自动生成grub开机引导及菜单,及其丑陋,而且很多我们用不到的选项。今天我们就介绍burg:修...

Linux就该这么学
3分钟前
0
0
Go 并发(二)

Go Mutex 通过Mutex和信道处理竞态条件。 临界区 当程序并发运行时,多个协程不应该同时访问那些修改共享资源的代码,这些修改共享资源的代码称为临界区。 Go中通过Mutex可以避免同时访问临界...

春哥大魔王的博客
5分钟前
0
0
CentOS 7安装和部署Docker

Docker 要求 CentOS 系统的内核版本高于 3.10 ,查看本页面的前提条件来验证你的CentOS 版本是否支持 Docker 。通过 uname -r 命令查看你当前的内核版本 uname -r3.10.0-514.el7.x86_64 1、...

狼王黄师傅
9分钟前
0
0
php扩展可以通过pecl 或者phpize 安装

pecl 算是 php 扩展的一个官方聚合平台,一些比较有名,有特点的扩展会被 pecl 收录,收录后可以通过 pecl 的方式安装。但是更多的扩展是没有收录在 pecl 上的,这些扩展还是需要通过 phpize...

bengozhong
9分钟前
0
0
CentOS中如何安装7ZIP

执行以下命令下载安装: wget http://nchc.dl.sourceforge.net/project/p7zip/p7zip/9.20.1/p7zip_9.20.1_src_all.tar.bz2tar -jxvf p7zip_9.20.1_src_all.tar.bz2cd p7zip_9.20.1make......

凯文加内特
15分钟前
0
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部