Node.js环境搭建

安装gcc

如果已经是安装的可以不需要安装,忽略这步。

yum install gcc gcc-c++

下载nodejs

版本可在淘宝库自行选择

wget https://npm.taobao.org/mirrors/node/v10.14.1/node-v10.14.1-linux-x64.tar.gz

解压

mkdir /usr/local/node
tar -zxvf node-v10.14.1-linux-x64.tar.gz -C /usr/local/node

配置环境

vim /etc/profile

# 在最下面添加对应路径即可
export NODE_HOME=/usr/local/node  
export PATH=$NODE_HOME/bin:$PATH

刷新配置

source /etc/profile

查看版本号

node -v
npm -v

构建Gitbook

创建目录

mkdir /usr/local/gitbook

本地安装

npm install gitbook-cli -g

初始化

gitbook init

生成静态网站

这个命令和下面的打包构建都可以启动一个静态网站

gitbook serve

打包构建

gitbook build

访问效果

地址:http://ip:4000

Gitbook访问效果

新增一篇文章

使用ctrl + c停止服务,然后在gitbook文件下,新建一个以.md结尾的文件,如果你不会使用markdown写文章,建议参考一下这篇文章:Markdown语法

vim BuildGitbook.md

添加文章内容即可

编辑SUMMARY.md这个文件:

vim SUMMARY.md

* [从零搭建一个GitBook](BuildGitBook.md)

添加上面这样一行即可,其实这就是个超链接
[]中是展示的名字,()中方的是连接

重新运行gitbook serve即可。

新增文章的预览

预览新增文章效果

Summary

Summary展示的其实就是左侧的目录,完全可以使用MD的语法,比如下面无序目录:

  • 宴桃园豪杰三结义 斩黄巾英雄首立功
    • 第一回
    • 第二回
    • 第三回
  • 张翼德怒鞭督邮 何国舅谋诛宦臣
    • 第一回
    • 第二回
    • 第三回

安装插件

配置book.json

在gitbook目录下新建一个文件book.json

配置好book.json以后运行一次gitbook install会自动加载插件。

{
  "title": "这是我测试使用的Gitbook",
  "author": "笑凡尘",
  "description": "好久没有搭建了,搭建一个玩一玩",
  "language": "zh-hans",
  "plugins": [
    // 代码高亮
    "highlight",
    // 增强搜索 支持中文,默认不支持
    "-lunr",
    "-search",
    "search-pro",
    // 返回顶部
    "back-to-top-button",
    // 文章目录
    "expandable-chapters",
    // 代码展示
    "code",
    // 调整侧边宽度
    "splitter",
    // 底部版权
    "tbfed-pagefooter",
    // 阅读数
    "pageview-count",
    // 点击查看图片
    "popup",
    // 主题
    "theme-fexa"
  ],
  "pluginsConfig": {
   	"page-copyright": {
      "description": "纯粹测试玩的呀",
      "signature": "笑凡尘",
      "wisdom": "Designer, Frontend Developer & overall web enthusiast",
      "format": "2020-10-28 15:41:26",
      "copyright": "Copyright © 笑凡尘",
      "timeColor": "#666",
      "copyrightColor": "#666",
      "utcOffset": "8",
      "style": "normal",
      "noPowered": false
    }
  }
}

效果预览

安装插件后的预览

持续运行

创建文件

创建在gitbook文件夹中

vim start.sh

编写脚本

#!/bin/sh

rm -f tpid
nohup gitbook serve > gitbook.log 2>&1 &
echo $! > tpid
echo Start Success!

脚本授权

chmod +777 start.sh

运行脚本

sh start.sh

Q.E.D.

知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议

让人非我弱,得志莫离群