GitBook基本使用

1. 安装

(1) 安装Node.js

官网下载:https://nodejs.org/en/

(2) 安装GitBook

使用 npm 安装 gitbook:npm install gitbook-cli -g

如果太慢或失败,建议使用 cnpm 安装
首先,使用 npm 安装 cpmnnpm install -g cnpm --registry=https://registry.npm.taobao.org
然后,再用 cnpm 安装 gitbook:cnpm install gitbook-cli -g

2. 创建

在当前目录创建一本书:gitbook init

3. 目录

目录中有两个.md文件
README.md 简介 - 书籍的简单介绍(必填)
SUMMARY.md 目录(参见目录管理)(可选)
一般来说,目录的结构如下:

# 目录
* [简介](README.md)
* [天气]()
    * [好天气](weather/good.md)
    * [坏天气](weather/bad.md)
* [人生]()
    * [明天](life/tomorrow.md)
    * [密码](life/password.md)
    * [累](life/boring.md)
* [某个人]()
    * [女孩](someone/girl.md)
    * [女人](someone/women.md)

其中,[] 内的内容是标题,() 内是文档的路径,章节和子章节用四个空格或者tab键来分级。

4. 预览

预览书:gitbook serve
预览地址:http://localhost:4000
构建静态网站:gitbook build
创建后,找到_book文件夹下的index.html,双击即可在浏览器预览

参考:gitbook中文文档-http://gitbook.hushuang.me/pages.html

你可能感兴趣的:(GitBook基本使用)