gitbook简单使用

gitbook简单使用

gitbook 是开发人员写文档，写书比较不错的一个工具。

推荐一个不错的gitbook使用教程资料

本文主要是用命令行操作，使用客户端的非常简单，直接去下载安装就可以直接使用。

准备条件：

• nodejs
• git
• 会用markdown

安装：

  npm install gitbook-cli -g

gitbook常用命令：

  //查看gitbook的版本
  gitbook -V

  //初始化一个项目
  gitbook init

  //列出所有的gitbook的命令
  gitbook help

  //显示gitbook-cli的帮助信息
  gitbook --help

  // 生成静态页面html
  gitbook build

  //生成静态网页并且启动本地的一个server
  gitbook serve

  //列出本地所有gitbook的版本
  //列出远端可用的gitbook的最新版本
  gitbook ls
  gitbook ls-remote

  //更新到gitbook最新的版本
  gitbook update

  //卸载对应的gitbook版本
  gitbook uninstall 2.0.1

  //指定log的级别
  gitbook build --log=debug

  //输出错误信息
  gitbook build --debug

  //gitbook安装插件
  gitbook install ./

使用步骤：

新建书籍：

• 创建一个目录 —— 书的项目文件夹
• 执行命令：gitbook init。会创建2个文件夹，一个是目录(SUMMARY.md)，一个是章节内容(README.md) 默认这是书的首页。
• 启动一个serve：gitbook serve (注：这里是serve不是server)
• 本地查看 localhost:4000
• 自己设置一下自己喜欢的样式 mstyle.css