搭建本地的Gitbook
搭建本地的Gitbook
搭桥过河 发表于2个月前
搭建本地的Gitbook
  • 发表于 2个月前
  • 阅读 4
  • 收藏 0
  • 点赞 0
  • 评论 0
摘要: gitbook的本地安装及预览的简单使用

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":"© 戴桥",
      "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
×
搭桥过河
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: