使用Gitbook搭建静态网站,并配合Git实现自动发布

本文将实现在本地通过Git push后,服务器端自动gitbook build静态网页文件到nginx网站目录,达到自动更新gitbook网站的效果。大概的思路是这样的:服务器搭建git,本地电脑与其实现远程连接,本地电脑上完成gitbook的写作后,通过git将变化提交到服务器端git,再通过服务器端git hooks,有新的提交时触发该hooks,生成静态网站文件到配置的nginx目录,实现自动更新网站。

安装并配置Nginx

静态网站由nginx来承担功能,请参考Nginx简易教程安装并配置Nginx。

安装并配置Gitbook

安装nodejs

gitbook基于nodejs,因此首先得安装nodejs。顺着nodejs官网,一路找下去,给出的安装方法如下:

curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash -
sudo apt-get install -y nodejs

建议按照上述链接进行安装,这样安装的是最新版,相应的npm也是最新版。本人之前踩过的坑:gitbook的安装使用npm,而Ubuntu官方包里面的nodejs版本较低,相应的npm也是,所以通过npm安装gitbook的时候始终很慢很慢...刚开始安装在本地,以为是网络问题,后来切换到服务器端也是一样,后来发现问题出在npm的版本上,只能通过安装最新版本的nodejs来更新npm,总之,装新版的nodejs。 通过以下命令查看nodejs版本,来确认是否安装成功。

nodejs -v

安装Gitbook

通过以下命令安装gitbook:

sudo npm install gitbook-cli -g

再输入gitbook -V查看版本号,首次运行需等待gitbook初始化完成(时间稍长,耐心等待😂):

gitbook -V

配置gitbook

切换到当前用户主目录:

cd ~/

新建文件夹zimohan.com,并初始化为gitbook,用于存放/中转我们的创造内容:

sudo mkdir zimohan.com
cd zimohan.com
sudo gitbook init

安装并配置Git

一般的Linux的发行版都安装有Git吧,所以就不介绍安装了。直接开始。

配置SSH密钥

密钥用于本地git与服务器端的git连接。如果之前已经使用过相关的功能,那么本地电脑应该已经生成了密钥。密钥路径为~/.ssh。可以查看其是否包含id_rsa及id_rsa.pub俩密钥文件。如果没用则可以通过以下命令生成。

ssh-keygen -t rsa -C 'youremail@example.com'

登录远程服务器,并将本地id_rsa.pub公钥文件的内容加入服务器端的~/.ssh/authorized_keys文件中。如果服务器中没有该文件,将新建,如果包含该文件,那么应该新起一行,再粘贴入本地的公钥。

sudo vi ~/.ssh/authorized_keys

建立服务器git仓,并克隆到本地

在服务器端建立裸仓。这里的示例是在当前用户的目录下建立zimohan.com.git的裸仓。

cd ~/
git init zimohan.com.git --bare

本地电脑克隆服务器端建立的裸仓

git clone <username>@zimohan.com:/home/<username>/zimohan.com.git

请将<username>替换你自己的用户名,"/home//zimohan.com.git"是git裸仓的具体路径,请根据实际情况完善。完成操作后,本地电脑的当前路径下将会出现一个名称为zimohan的文件夹,该文件夹就是从服务器克隆下来zimohan.com.git裸仓。 如果SSH使用的是非标准的22端口,则按如下操作:

git clone ssh://<username>@zimohan.com:端口/home/<username>/zimohan.com.git

配置hooks操作

进入hooks目录并新建post-receive文件,意思是在git receive到信息之后运行该文件中的命令。

cd ~/zimohan.com.git/hooks/
sudo vi post-receive

并粘贴入以下内容:

#!/bin/bash
sudo git --work-tree=/home/<username>/zimohan.com --git-dir=/home/<username>/zimohan.com.git checkout -f
sudo gitbook build /home/<username>/zimohan.com --output= /var/www/zimohan.com/

请将<username>替换你自己的用户名,“/home//”是相应文件夹的路径,请根据实际情况做适当修改。 以上命令大概是这么个意思:当有新的内容通过git提交时,git-dir后面的git仓内容导出到work-tree所在文件夹,然后将build后面的gitbook库生成网页静态文件到output所在文件夹(nginx所配置的网站所在文件夹)。 然后赋予post-receive可执行权限:

sudo chmod +x post-receive

实现自动发布

再次回到本地电脑端,相应的本地端也需要安装gitbook,请参照上面的步骤安装。 回到之前操作提到的克隆到本地的git仓所在文件夹zimohan.com,将其初始化为gitbook:

gitbook init

打开其中的README.md:

sudo vi README.md

将其内容修改为:

# Introduction
自动提交配置成功!

完成git操作:

git add *
git commit -am "git test"

最后将本地的修改推送到服务器端:

git push

现在浏览器访问https://zimohan.com即可看到效果了 以后本地通过gitbook增减文章后,git完成相关操作后,push到服务器,服务器即可自动生成并发布到网站,实现自动更新。

results matching ""

    No results matching ""

    results matching ""

      No results matching ""