Mar 26, 2019 Eric Guo    1197

摘要：安装gitbook

本地搭建gitbook服务器

1、安装node.js

32 位安装包下载地址 : https://nodejs.org/dist/v4.4.3/node-v4.4.3-x86.msi
64 位安装包下载地址 : https://nodejs.org/dist/v4.4.3/node-v4.4.3-x64.msi
安装后执行 node --version 查看是否成功

2、输入命令，全局安装gitbook

npm install gitbook-cli -g

3、创建对应的文件夹

 mkdir   mybook

4、初始化目录文件

gitbook init

5、生成静态网页并运行服务器

gitbook build
gitbook serve

常用命令

    gitbook init //初始化目录文件
    gitbook help //列出gitbook所有的命令
    gitbook --help //输出gitbook-cli的帮助信息
    gitbook build //生成静态网页
    gitbook serve //生成静态网页并运行服务器 (gitbook serve --port 2333 可以指定任意端口)
    gitbook build --gitbook=2.0.1 //生成时指定gitbook的版本, 本地没有会先下载
    gitbook ls //列出本地所有的gitbook版本
    gitbook ls-remote //列出远程可用的gitbook版本
    gitbook fetch 标签/版本号 //安装对应的gitbook版本
    gitbook update //更新到gitbook的最新版本
    gitbook uninstall 2.0.1 //卸载对应的gitbook版本
    gitbook build --log=debug //指定log的级别
    gitbook builid --debug //输出错误信息

gitbook与github互联

• 登陆github创建空白仓库
• 仓库中添加 README.md SUMMARY.md 保存
• 登陆gitbook使用github登陆
• 创建新的organization 与 space
• 在右侧三个点图标下点击integrations
• 选中github 设置同步链接
• 选择主分支，选择github自动提交到gitbook
• 同步
• OK
• 在space出点击domain进行自定义域名设置
• 设置CNAME
• OK