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 bundler4.检查是否安装成功,查看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博客网站