文档章节

搭建本地的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
Centos 7 下 GitBook 的安装与使用

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

羽杰
2017/09/21
0
0
markdown 文档转 html 工具 - mddoc

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

宇润
06/27
0
0
requests+正则表达式 爬取 妹子图

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

pertinence
04/24
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

没有更多内容

加载失败,请刷新页面

加载更多

下一页

angular指令监听ng-repeat渲染完成后执行自定义事件方法

今天工作中遇到需要用到ng-repeat遍历渲染完后执行某个操作,angular本身并没有提供监听ng-repeat渲染完成的指令,所以需要自己创建自定义指令。 在ng-repeat模板实例内部会暴露出一些特殊属...

孟飞阳
35分钟前
1
0
URLEncoder和URLDecoder

public static void main(String[] args) { String str1 = "https://test1-life.pingan.com/ilifecore/productMall/loading.html?productId=8000000241&channelCode=XCX00001&productCode=00......

鬼才王
44分钟前
2
0
对象及变量的并发访问-第一篇

方法内部的变量为线程安全变量 “非线程安全”问题存在于“共享变量”中,如果是方法内部的私有变量,则不存在“非线程安全”问题,所得结果也就是“线程安全”的。 package chaprer3;/**...

简心
45分钟前
1
0
程序媛眼中的程序猿原来是这样子的!

一直都想写一篇关于描述程序员的文章,但是一直没能开头,一来因为文笔不好,更主要的原因是貌似对程序员既熟悉又不熟悉,很怕写出来的是以偏概全,给大家造成对程序员的既定印象,不过,管他...

Java小铺
今天
1
0
bean标签

声明:本栏目所使用的素材都是凯哥学堂VIP学员所写,学员有权匿名,对文章有最终解释权;凯哥学堂旨在促进VIP学员互相学习的基础上公开笔记。 bean标签 bean标签中的init-method属性,该属性...

凯哥学堂
今天
0
0

没有更多内容

加载失败,请刷新页面

加载更多

下一页

返回顶部
顶部