第一篇文章-jekyll的配置
文章目录
layout: post
title: "第一篇文章-jekyll的配置"
date: 2021-04-04 20:47:14 +0800
categories: envs
tags: [jekyll, envs, ruby, web, blog]
记录心得:
第一次使用jekyll搭建博客,记录下之间的过程。
- 为什么使用jekyll
- 怎样的搭建过程
- 怎么维护和更新
- 遇到的问题
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/profile2.1.1 安装及配置jekyll
使用gem直接安装即可
gem install jekyll然后查看一下版本,这里我是3.7
jekyll -v生成页面文件(如果是新建博客站点的话)
jekyll new myblog2.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.html2.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 serve2.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 serve3. 怎么维护和更新
我这里采用的是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¶m=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. 遇到的问题
- 图片还不知道怎么管理比较好
- 文章的分类
暂且先上线,后续再管
评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论