本仓库为我的个人博客。博客使用了自己从头打造的 Jekyll 主题,主要存放一些技术性文章以及个人笔记。更新频率飘忽不定,尽量每个月尽量更新一篇。
站点目前使用 GitHub Pages 托管,使用 Cloudflare 做 DNS 解析。
你可以自由地将本博客的主题用于你的博客。
推荐使用 Visual Studio Code 编辑器,安装插件 Shopify Liquid
、markdownlint
和 Live Server
以获得更好的开发体验。
构建前先安装好 Ruby 和 Jekyll,然后安装依赖:
bundle install
启动本地服务:
jekyll serve
然后直接使用 Live Server
预览实时更新。
绝大多数设置都在 _config.yml
文件中,你可以根据自己的需求进行修改。
博客文章存放在 _posts
文件夹中,命名格式为 YYYY-MM-DD-title.md
。博客文章的文件头应该包含以下信息:
layout: post
title: "原神游玩指南"
date: 2000-01-01 00:00:00 +0800
categories: 游戏 // 只能有一个分类
tags: 开放世界 RPG 原神 // 可以有多个标签,用空格分隔
comments: true // 如果设置为 true,文章会显示评论区;否则不显示
mathjax: true // 可省略,默认为 false。如果设置为 true,会启用数学公式支持
mermaid: false // 可省略,默认为 false。如果设置为 true,会启用流程图支持
copyrights: 原创 // 如果设置为原创,文末会显示版权声明;否则不显示
draft: true // 可省略,默认为 false。如果设置为 true,文章不会显示在主页上
您可能还需要修改 .github
文件夹下的工作流程文件、网站图标 favicon.svg
以及 CNAME
,以适应您的需求。
文章中的图片存放在 assets/post/images
文件夹中。如果需要引用图片,请使用相对路径,例如:
![图片描述](/assets/post/images/图片文件名.webp)
assets/post
文件夹下提供了脚本,可以帮助将图片转换为 webp 格式。如果你需要使用,请先安装好 webp 工具。
你可以使用 _test
文件夹下的测试文章进行测试。
- 个性主题
- 文章分类
- 文章标签
- 文章系列
- 代码高亮
- 代码复制
- RSS 订阅
- 响应式设计
- SEO 优化
- 版权声明
- 性能优化
- 文章搜索
- 相关文章推荐
- 评论系统
- 文章目录
- 文章分享
- 主题切换
- 公式支持
- 流程图支持
- 无障碍访问
- 更多功能...
本博客所有文章采用 CC BY-NC-SA 4.0 许可协议。转载请注明出处。
本博客其余代码采用 MIT 许可协议。