快速搭建
本文博客基于 Chirpy Jekyll Theme 搭建。
Chirpy Starter
官方推荐，可专注于写作，升级简单。
- 进入项目地址：https://github.com/cotes2020/chirpy-starter
- 点击右上角Use this template -> Create a new repository
- 在Repository Name中填写username.github.io，username为github的用户名, 其他选项默认即可
- 创建成功
Github Page
一项静态站点托管服务, 它直接从GitHub上的仓库获取HTML、CSS和JavaScript文件, (可选)通过构建过程运行文件, 然后发布网站。
- 回到仓库页
- 点击上方Settings
- 左侧Code and automation -> Pages -> Build and deployment 的Source 选择 Github Actions, 意味着任何提交推送到分支都会触发Actions自动构建与部署。
- 浏览页面: 同样在Pages内可点击Visit site浏览。
CodeSpace
GitHub Codespaces 是一个基于云的即时开发环境，它使用容器为你提供用于开发的通用语言、工具和实用程序。
- 回到仓库页
- 绿色的Code -> Codespaces -> Create a codespaces on main
- Codesace是Vscode的IDE，构建好后即可开始写作。
- 写作完成后点击源代码管理 - 鼠标移至”更改”栏点击”+”, 意味着将此次更改暂存至工作树
- 在”消息”内填写此次更改的备注后点击提交 - 点击同步更改
- 等待Actions自动构建与部署后，可在个人网站查看到更新内容
项目树结构
-
_config.yml：配置文件, 主要修改url, avatar, timezone和lang。其他内容可点击链接查看修改。
中文样例:
url为博客网址, 在仓库页的Pagers里可找到。例如: https://dengyaqi.github.io/
avatar需要把图片上传到路径./asserts/img内后在配置文件的avatar标签中设置url路径，例如: https://dengyaqi.github.io/assets/img/avatar.jpg
timezone: Asia/Shanghai, 配置内有链接可查找。
lang: zh-CH, 首页中的关键词会自动翻译。
-
_post: 文章存放位置, 在该文件夹内新增格式为
YYYY-MM-DD-TITLE.md的文档即可, 至于markdown语法建议边写边学, 不用专门学习, 例如可以对照代码版本与网页版本了解哪些语法对应哪些格式。 -
_data: 元数据, 例如用户信息，联系信息等。可创建一个authors.yml用于配置用户信息, 这样可自动覆盖其他需要用户信息的配置，无须再手动配置。
-
favicons: 网站图标教程
GitHub Discussions
利用 GitHub Discussions 实现的评论系统
- 点击标题链接 - “仓库”栏内容完成 - 填写仓库名称
- 填写完成后在”启动giscus”有相关信息
- 在_config.yml找到giscus标签, 填入对应信息。
常见问题
- 文章内链接只支持https确保安全，如需支持http浏览该回答
其他
如需了解更多详细内容, 可直接浏览官网: https://chirpy.cotes.page/