使用jekyll搭建个人博客
Jekyll介绍
Jekyll是一个简单、可扩展的静态站点生成器。它将文本内容转换为静态网站和博客。Jekyll主题丰富，同时作者会提供详细的部署教程文档。
通过用Jekyll生成静态网站、Github Pages提供托管服务，就可以方便地实现个人博客/小型网站的托管。
Jekyll on Mac
安装步骤：
- 安装Homebrew
-
Homebrew是MacOS的包管理工具，方便软件的安装和更新。
-
brew的安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 检查brew信息：
# 查看版本
brew - v
# 升级并检查brew
brew update && brew doctor
- 安装Ruby
虽然macOS预装了Ruby，但考虑到此版本过时且无法更新，因此并不建议使用系统Ruby。
- 使用brew安装Ruby：
brew install ruby chruby
# 添加ruby路径到环境变量
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
若终端为bash:
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
- 检查ruby信息：
which ruby
ruby -v
参考博客Ruby on Mac
- 安装jekyll
- 可以考虑换国内源：
gem sources --remove https://rubygems.org/
gem sources -a 'https://gems.ruby-china.com'
gem sources -l
- 使用
gem安装jekyll：
gem install jekyll bundler
- 检查jekyll信息：
jekyll -v
总结：
zshbrew-
chruby：切换ruby版本 -
ruby-install：ruby下载 -
ruby：使用gem安装bundler和jekyll -
bundler：用于安装jekyll插件 -
jekyll：将纯文本转换为静态博客网站
Jekyll on Windows
安装步骤：
- 安装Scoop：
- Scoop之于Windows一如brew之于Mac，推荐下载Scoop作为包管理器
- 安装Scoop，基本语法科普
PS G:\> iex "& {$(irm get.scoop.sh)} -RunAsAdmin"
- 从官网下载Ruby（形如
Ruby+Devkit文件）
-
安装Ruby，勾选
MSYS2 and MINGW development tool chain选项 -
命令行验证是否安装成功：
ruby -v
gem -v
未出现报错即安装成功
- 如果没有弹出命令行安装界面或者不小心关掉：再次输出
ridk install以重新进入安装界面
- 安装Jekyll
gem install jekyll bundler
命令行验证：
jekyll -v
未出现报错即安装成功，Jekyll 开发环境搭建完成
- 本地能够编译运行Jekyll博客：
- 安装Jekyll主题，或
git clone拉取Github项目文件，进入项目根目录中 - 安装依赖包：
bundle install
- 如果安装过程过于缓慢，可以尝试换源
bundle config mirror.https://rubygems.org https://gems.ruby-china.com
然后继续bundle install
- 运行jekyll服务
bundle exec jekyll serve
若成功，则可以通过http://localhost:4000/ 来查看网页部署。
总结：
PS G:\> iex "& {$(irm get.scoop.sh)} -RunAsAdmin"
PS G:\> scoop install git
'git' (2.46.0) was installed successfully!
PS G:\> scoop install ruby
'ruby' (3.3.4-1) was installed successfully!
PS G:\> scoop install msys2
'msys2' (2024-07-27) was installed successfully!
PS G:\> msys2
Initial setup complete. MSYS2 is now ready to use.
PS G:\> ridk install
Install MSYS2 and MINGW development toolchain succeeded
PS G:\> ruby -v
ruby 3.3.4 (2024-07-09 revision be1089c8ec) [x64-mingw-ucrt]
PS G:\> gem -v
3.5.11
PS G:\> gem install jekyll bundler
30 gems installed
PS G:\> jekyll -v
jekyll 4.3.3
PS G:\website> bundle install
Resolving dependencies...
Bundle complete!
PS G:\website> bundle exec jekyll serve
博客的更新与维护
Jekyll模版修改
# 网页全局的语言，例如将侧边的“home”改成“主页”等，可选项在_data/locales/下，这里改成中文
lang: zh-CN
# 站点标题，显示在网站标签页和左上角
title:
# github名，改成自己的github名字
github:
username:
格式要求：
Chirpy主题有特定的格式要求，在上传markdown之前要先了解一下。
-
文件位置和命名： 须在本地的
_posts文件夹下创建markdown文档，文件名格式为YYYY-MM-DD-TITLE.md -
文件内容： 前几行的格式为：
---
title: 使用jekyll搭建个人博客
date: 2024-7-7 12:00:00 +0800
categories: [Blog, Build]
tags: [blog]
---
- date：文章的日期，
- categories：文章分类，类似树状态结构
- tages:文章的标签
预览和提交
可以参考Git中常见命令
Enjoy Reading This Article?
Here are some more articles you might like to read next: