基于 Chirpy 主题定制化的个人博客,博客内容已转移到 blog
分支,master
将作为模板使用。此处进入我的博客。
使用之前请先参考原版 Chirpy 的使用教程。
与原版 Chirpy 不同的点在于:
-
在原版支持的评论系统 Disqus,Utterances 和 Giscus 外,增加对 Waline 评论系统的支持,参见
_config.yml
里的comments.waline
。 -
使用知乎式 404 界面,可以返回首页或者返回上一页。
-
新增了分享到 Line,QQ,QQ 空间和微博,参见
_data/share.yml
。 -
使用 iconfont 取代 Font Awesome,有更多的图标选择空间。注意:自 2022-12-29 起,iconfont 路径配置从
_config.yml
迁移到了_data/origin/cors.yml
及_data/origin/basic.yml
中的iconfont.css
,以支持下载 css 到本地。 -
右侧边栏添加了外部链接块,参见
_data/external_links.yml
。 -
可以自由地控制在帖子中显示右侧边栏哪些块。参见
_config.yml
里的panel
。 -
添加了子域页。参见
_data/subdomain.yml
。不需要该页面的情况下删除_tabs/subdomain.md
即可。 -
添加了
<details>
标签的样式,同时调整了 blockquote 的样式。 -
使用改自
just the docs
的表格样式。 -
将代码染色应用到了行内代码段,例如
`let fuck_rust = 114514;`{:.language-rust}
。 -
使用 Fira Code 作为代码段字体。默认对行内代码不开启连体(Ligature),对块代码开启。因为某些原因,在 shell 语言中禁用连体。
-
暗色主题时,标题和加粗内容在白色文字之中难以区分,增加发光效果以突出显示。
-
可以配置高亮代码段中的某些行,参考此处。
-
运行代码显示输出结果(开发中,目前支持部分语言),需要在代码段的下一行添加
{: run="lang" }
,例如:```rust fn main() { println!("hello world"); } ``` {: run="rust" }
语言支持情况:
已支持的语言 run="lang"
参数后端 C++ run="cpp"
Coliru JavaScript run="javascript"
N/A (本地) Python run="python"
Online Python Rust run="rust"
Rust Playground -
(2022-11-29) 支持同名的多级 categories,如果你是从旧版本更新到当前版本,请在本地运行
bundle update
。原版 Chirpy 使用jekyll-archives
插件生成 categories,该插件将所有 categories 视为同等级别关系,这导致在 Chirpy 中无法使用相同名字的二级 categories,这个问题在本分支中得以修复,可以使用任何同名的多级 categories 了。注意:由于将jekyll-archives
下载到本地.gems
目录,并且将Gemfile
指向本地路径,因此本地需要bundle update
之后才能生效。 -
(2022-12-12) 添加了动画背景效果和鼠标点击效果,考虑到不是所有人都喜欢特效,默认情况下这两都是禁用的。如需开启,请在
_config.yml
中配置backgroud_animation
和mouse_click_effect
为true
。
通常,每周会至少 merge 一次 upstream/master
以追踪新的功能。