文章

Create Github Pages+Jekyll Chirpy

Create Github Pages+Jekyll Chirpy

本文旨在搭建一个github.io个人主页项目 操作系统win11+vscode+docker

准备工作

Ruby&Jekll

下载Ruby&Jekll 1.选择最新版本进行,否则会导致后续出现问题,满足RubyGems version >=3.3.22,安装时将gem源改为清华源 2.打开exe执行文件 操作过程中会弹出cmd,需要输出选择选项 此时选择3 3.安装结束,打开新的cmd,安装Jekyll

1
gem install jekyll bundler

4.检查是否安装成功,查看jekyll版本

1
jekyll -v

Docker

1.windows系统安装Docker Deskbook,搭建linux环境 2.下载到本地之后,若有需要在指定盘进行安装(下文以D举例) 3.打开cmd

1
"D:\download\Docker Desktop Installer.exe"  install --installation-dir="PATH"

PS:最好不要修改默认保存路径,会死 4.若有汉化需求,打开此网站,找到对应的版本号(与docker版本一致),阅读readme进行安装

github-io

1.打开此网页进行快速化定制 2.Use this temple -> create a new respository 3.命名新仓库名称为 USERNAME.github.io , 这里面USERNAME 是你的Github的用户名。 在仓库中点击右上角设置后,找到pages设置,将Source修改为 Github Action。 修改仓库中 _config.yml 文件的第26行的 url,改为自己的 https://USERNAME.github.io即可

本地部署

1.打开Docker Desktop并且打开vscode 2.安装Dev Containers 3.vscode clone github.io 4.进行Docker配置 5.打开终端编辑,执行一下配置命令

1
bundle

基础设置

头像设置

将对应头像设置为avatar.png,存入asset 将_config.yml文件中的avatar路径修改为相对路径

语言/时间/侧边栏/标语

timezone: 中国输入 Asia/Shanghai

lang: 语言,默认英文。中文设置zh-CN

title: 侧边栏名称

tagline:自己的标语

本地调试及上传

打开终端,执行操作,并预留端口

1
bundle exec jekyll s

当上传至github时,可能遇到不能及时适配,在项目中的Action中build and deply 中run workflow

发布文章

jekyll适配markdown文件,所以文章其实是以markdown形式发出的 下载jekyll-compose 参考该项目 当需要写文章的时候在终端输入

1
bundle exec jekyll new _posts/(名字).md

若需要快速建立,可尝试使用shell脚本,在本文件中 /workspaces/rocky-lxj.github.io/create_post.sh 使用时在终端使用 bash create_post.sh 即输入当前需要的title

图片上传问题

将文件上传至github仓库 复制当前图片地址,blob变化为raw

参考地址

【避坑篇】使用Github Pages搭建个人主页or博客网站

【快速部署+客制化】Github Pages+Jekyll Chirpy 速搭个人主页

using-the-chirpy-starter

Windows10 docker安装D盘,更改docker镜像默认保存路径

本文由作者按照 CC BY 4.0 进行授权