【gitbook】gitbook的安装

【前端工具】nodejs+npm+vue 安装

安装

npm install gitbook-cli -g

gitbook命令：

gitbook init //初始化目录文件 gitbook help //列出gitbook所有的命令 gitbook --help //输出gitbook-cli的帮助信息 gitbook build //生成静态网页 gitbook serve //生成静态网页并运行服务器 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 serve这个可以在本地生成预览。本地启动http://localhost:4000即可预览。 gitbook build 后有个静态目录_book

配置

自己在项目根目录下添加book.json文件

{ "plugins": [ "-lunr", "-search", "search-pro", "collapsible-menu", "anchor-navigation-ex", "tbfed-pagefooter", "disqus", "expandable-chapters", "advanced-emoji", "pageview-count" ], "title": "我的test", "description" : "只是试试", "language" : "zh-hans", "pluginsConfig": { "tbfed-pagefooter": { "copyright":"Copyright &copy ershouche-FE 2019", "modify_label": "文件修订时间：", "modify_format": "YYYY-MM-DD HH:mm:ss" }, "disqus": { "shortName": "gitbookuse" } } }

使用 gitbook install 下载插件，可能有点慢

利用nginx部署

nginx基础请看我的nginx教程

server { listen 4000; server_name localhost; location / { root /home/apibook/_book; index index.html; try_files $uri $uri/ =404; } }

利用Jenkins自动生成

Jenkins基础请查看我的教程

[ -e back-wiki.tar ] && rm -f back-wiki.tar tar cf back-wiki.tar back-wiki/* sudo mv back-wiki.tar /home/ cd /home/ [ -e back-wiki.bak ] && sudo rm -rf back-wiki.bak sudo mv back-wiki back-wiki.bak sudo tar xf back-wiki.tar [ -e back-wiki.bak/node_modules ] && sudo mv back-wiki.bak/node_modules back-wiki/ cd /home/back-wiki if [ "$add_module" = "true" ]; then sudo gitbook install fi sudo gitbook build