第一篇文章-jekyll的配置


layout: post
title: "第一篇文章-jekyll的配置"
date: 2021-04-04 20:47:14 +0800
categories: envs

tags: [jekyll, envs, ruby, web, blog]

记录心得:

第一次使用jekyll搭建博客,记录下之间的过程。

  1. 为什么使用jekyll
  2. 怎样的搭建过程
  3. 怎么维护和更新
  4. 遇到的问题

1. 为什么使用jekyll

之前使用过hexo,具体的地址是在实验室的主页上:xialab

优点是:

  • 容易更改主题
  • 中文支持
  • 使用nodejs,容易部署。

缺点是:

  • 需要自己生成页面,只能把静态页面推送到github仓库,而src源码文件需要额外备份

因为这个缺点,我选择了jekyll

但是jekyll缺点也很明显,就是ruby这个环境真的很麻烦,目前也没怎么用过,期望只是初期配置麻烦一点吧。

2. 搭建过程

我在云服务器和本地PC设立了两个仓库

  • 云服务器在腾讯云,CentOS
  • 本地PC是Windows,基于WSL搭建环境

2.1 CentOS搭建

通过yum安装ruby (此条不行),因为版本比较老,是2.0版本,jekyll需要2.4

sudo yum install ruby

遂通过源码安装

wget https://cache.ruby-lang.org/pub/ruby/2.7/ruby-2.7.1.tar.gz
tar -zxvf ruby-2.7.1.tar.gz
cd ruby-2.7.1
mkdir -p /usr/local/ruby
./configure --prefix=/usr/local/ruby
make && make install

修改profile,添加到全局变量

nano /etc/profile

将如下内容添加到末尾

export PATH="/usr/local/ruby/bin:$PATH"

然后按Ctrl+X保存,然后激活

source /etc/profile

2.1.1 安装及配置jekyll

使用gem直接安装即可

gem install jekyll

然后查看一下版本,这里我是3.7

jekyll -v

生成页面文件(如果是新建博客站点的话)

jekyll new myblog

2.1.2 修改_config.yml

目前我的配置文件如下,以后还需要修改

# 站点文件路径
#source: .
#destination: ./_site
encoding: utf-8

# 目标网站路径设置
permalink: :year/:month/:title.html
markdown: Kramdown

# 时区
timezone: Asia/Shanghai

# 设置导航目录
nav:
- name: Home
  link: /
- name: About
  link: /about.html

2.1.3 修改Gemfile

这个文件,主要是管着jekyll的构建环境

我参照谷歌来的教程,直接使用了如下内容

source 'https://mirrors.cloud.tencent.com/rubygems/'
require 'json'
require 'open-uri'
versions = JSON.parse(open('https://pages.github.com/versions.json').read)
gem 'github-pages', versions['github-pages'] 

这里的source使用的是腾讯云的源,因为官方源太慢了。此外,还有一个淘宝源,不过好像已经死了,连不上。

使用bundle可以直接安装Gemfile要求的环境

bundle install

这样,就和github的构建环境一致了。

2.1.4 运行

直接通过bundle运行

bundle exec jekyll serve

默认是 http://127.0.0.1:4000

2.2 Windows搭建

不要使用windows下的exe文件来安装,比如rubyinstall,总是因为msys2,出现一堆问题,我放弃了,然后直接使用的WSL下的Ubuntu 18搭建完成。

首先更新一下apt

sudo apt update

然后安装ruby-dev,这个里面就包含了gem,我的源里面是ruby2.5,也够用了。

sudo apt install ruby-dev

然后安装bundle和jekyll

gem install jekyll
gem install bundle

然后通过bundle运行即可(为什么要bundle,当成python中的conda管理就行了)

bundle exec jekyll serve

3. 怎么维护和更新

我这里采用的是github + webhook的方法

通过在本地修改,然后上传到github,然后github触发webhook,自动同步到腾讯云的主机上。

3.1 构建webhook

webhook是什么,可以自行谷歌。

因为云主机是使用的宝塔面板,所以比较方便,在面板软件中心安装webhook管理器即可

参考的是宝塔论坛

在运行脚本内添加如下内容:

#!/bin/bash
echo ""
#输出当前时间
date --date='0 days ago' "+%Y-%m-%d %H:%M:%S"
echo "Start"
#判断宝塔WebHook参数是否存在
if [ ! -n "$1" ];
then 
    echo "param参数错误"
    echo "End"
    exit
fi

#git项目路径
gitPath="/www/wwwroot/$1"
#git 网址
gitHttp="git@github:com/$1.git"

echo "Web站点路径:$gitPath"

#判断项目路径是否存在
if [ -d "$gitPath" ]; then
    echo "目录存在"
    cd $gitPath
    #判断是否存在git目录
    if [ ! -d ".git" ]; then
        echo "在该目录下克隆 git"
        git clone $gitHttp gittemp
        mv gittemp/.git .
        rm -rf gittemp
    fi
        #拉取最新的项目文件
    git reset --hard origin/main
    git pull
    #设置目录权限
    chown -R www:www $gitPath
    source /etc/profile
    bundle exec jekyll build
    echo "End"
    exit
else
    echo "该项目路径不存在"
    echo "End"
    exit
fi

需要注意的坑: 一定要注意缩进,shell语言对缩进比较严,然后就是判断语句中的[]这个括号,其中的内容和括号之间要有空格,不然不会进行判断。

然后会生成如下的url:

http://[ipaddress]:[port]/hook?access_key=DzsH8SQdasdQTBOllSy3477asdasQwJN8XP9VWIt2kajsdkj&param=xxx.github.io
  • ipaddress: ip地址
  • port:端口
  • access_key:生成的接入码
  • param: 设定的参数,建议直接设置为你的github page的网址

然后来到Github的项目页面,依次'Setting'>'Webhooks'>'Add webhook'
将url填入,然后在选项“Which events would you like to trigger this webhook?”中选择“Just the push event.”
那么以后当push到github时,就能自动在自己的服务器刷新网站内容了。

4. 遇到的问题

  • 图片还不知道怎么管理比较好
  • 文章的分类

暂且先上线,后续再管

评论

暂无评论