Gitbook-基本的使用方法

GitBook使用

环境

  1. 需要nodejs环境。安装参考 nodejs安装
  2. 安装Gitbook:gitbook-cli
    1
    $npm install -g gitbook-cli

初始化

初始化

1
2
3
$ mkdir testBook
$ cd testBook
$ gitbook init

效果:
会生成 README.md 和 SUMMARY.md 两个文件.

启动服务-本地

可以预览书籍的排版

1
$ gitbook serve

本地构建并运行服务,默认访问 http://localhost:4000 实时预览.

构建静态内容

本地构建但不运行服务,默认输出到 _book/ 目录.

1
$ gitbook build

组织文章

  1. README.md 说明文件
    也是默认首页

  2. SUMMARY.md 目录文件

    1
    2
    3
    4
    5
    6
    7
    # Summary
    * [0. tes1](chapters/0.md)
    * [1. chapter1](chapters/1.md)
    * [2. chapter1](chapters/2.md)
    * [3. chapter1](chapters/3.md)
    * [4. chapter1](chapters/4.md)
    * [5. chapter1](chapters/5.md)
  3. 任意文件夹管理章节 列-chapters

    个性化

  4. book.json 手动追加文件

  5. 书名—title”: “第一个BOOK测试”,

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    {
    "title": "第一个BOOK测试",
    "links": {
    "sidebar": {
    "我的链接": "https://google.com",
    "我的链接2": "https://google.com"
    },
    "sharing": {
    "google": null,
    "facebook": null,
    "twitter": null,
    "weibo": null,
    "all": null
    }
    }
    }

各种插件

以后另开一篇

发布书籍

【_book】文件夹里就是生成的书记,放到你的Web服务器里就可以被外部访问了。

为测试做了一本道德经整理

测试–道德经整理