gitbook使用教程

gitbook使用教程

centos安装

注意

这里安装的是13.14的node，高版本gitbook init会报错

gitbook init Error: TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be

下载地址：https://nodejs.org/download/release/v13.14.0/

tar -xvf node-v13.14.0-linux-x64.tar.gz -C /opt

# 添加环境变量
cat <<'EOF'>> /etc/profile
PATH=/opt/node-v13.14.0-linux-x64/bin:$PATH
EOF
source /etc/profile

[root@VM-0-13-centos gitbook]# node -v
v13.14.0

windows安装

下载地址：https://nodejs.org/download/release/v13.14.0/

添加环境变量：略

安装cnpm

npm install -g cnpm --registry=https://registry.npm.taobao.org

安装gitbook-cli

cnpm install -g gitbook-cli --registry=https://registry.npm.taobao.org

gitbook初始化

mkdir gitbook
cd gitbook
gitbook init

初始化成功的样子

[root@VM-0-13-centos gitbook]# gitbook init
warn: no summary file in this book 
info: create README.md 
info: create SUMMARY.md 
info: initialization is finished 
[root@VM-0-13-centos gitbook]# 

编辑SUMMARY.md

# Summary

* [Introduction](README.md)
* [基本安装](howtouse/README.md)
    * [Node.js安装](howtouse/nodejsinstall.md)
    * [Gitbook安装](howtouse/gitbookinstall.md)
    * [Gitbook命令行速览](howtouse/gitbookcli.md)
* [图书项目结构](book/README.md)
    * [README.md 与 SUMMARY编写](book/file.md)
    * [目录初始化](book/prjinit.md)
* [图书输出](output/README.md)
    * [输出为静态网站](output/outfile.md)
    * [输出PDF](output/pdfandebook.md)
* [发布](publish/README.md)
    * [发布到Github Pages](publish/gitpages.md)
* [结束](end/README.md)

编辑README.md、SUMMARY.md，再次初始化

# 可以使用 Gitbook 的命令行工具将这个目目录结构生成相应地目录及文件
[root@VM-0-13-centos gitbook]# gitbook init

启动项目

[root@VM-0-13-centos gitbook]# cd ..
[root@VM-0-13-centos ~]# gitbook serve gitbook
# 或者
[root@VM-0-13-centos ~]# gitbook serve .
# 或者
[root@VM-0-13-centos ~]# gitbook serve

访问

http://localhost:4000

静态网址

gitbook build ./{book_name} --output=./{outputFolde}

gitbook build .

打包成功之后，默认输出的文件放在 _book 文件夹里面，编译之后的入口： index.html

静态网址不会跳转问题

左侧导航栏无法跳转
gitbook生成的静态网页很像wiki，左侧有电子书的导航栏，很方便。但是，点击链接居然不会跳转。不会跳转的超链接能叫超链接吗？

此时，在_book文件夹内，找到gitbook文件夹，在里面找到theme.js

打开，用文本搜索工具搜索查找

if(m)for(n.handler&&
注意，文本时压缩过的，不要搜索if(m)，那样找不到。

找到后，将 if(m)改成if(false)

再次打开_book下的网页，左侧导航栏超级链接就可以正常跳转了。

输出 PDF

cnpm install -g gitbook-pdf --registry=https://registry.npm.taobao.org

cd ..
gitbook pdf gitbook

#如果，你已经在编写的 gitbook 当前目录，也可以使用相对路径
gitbook pdf .