airbozh / halo-theme-chirpy

一个Halo生态，简约且功能丰富的技术博客主题。A minimal, responsive and feature-rich Halo theme for technical writing.

Chirpy Halo Theme

A minimal, responsive and feature-rich Halo theme for technical writing.
一个简洁、响应式且功能丰富的Halo主题，适用于技术写作。

Live Demo 演示 →

Wiki

⭐The full effects of the theme need to be used in conjunction with the plugin
主题全部效果需要和插件搭配使用⭐

📕For detailed instructions on theme usage, please refer to the Wiki
主题使用说明详见Wiki📕

Credits 致谢

This theme has been refactored from the Chirpy Jekyll Theme. Express my gratitude to the contributors.
该主题是从Chirpy Jekyll Theme主题进行重构的。对贡献者表示感谢。
The avatar and favicon design come from Clipart Max.
头像和网站图标的设计来自Clipart Max。

Thanks to Halo-Dev for their exceptional work in creating Halo, which is truly a fantastic project and ecosystem that this theme is a part of.
感谢Halo-Dev团队为创建Halo所做的卓越工作，Halo是一个非常出色的项目和生态系统，而本主题是其中的一部分。

Contributors ✨

Thanks goes to these wonderful people (emoji key):

AirboZH 💻 🚧 📖 👀	Hilary Liu 💻	Waite Wang 💻 🤔 🐛	大葱 🐛	mareep 🐛	Ailelix 🐛	Yuhang Shen 🤔 🐛
Cheney Wong 🤔	Jamtoal 🐛	BugKing 🐛	Halo 💵 🔌 🧑‍🏫	linzx 🤔	IObsession 🐛	Camellia 🤔

This project follows the all-contributors specification. Contributions of any kind welcome!

Sponsors 赞助

License

Chirpy Halo Theme is published under MIT License .
Chirpy Halo主题在MIT许可证下发布。

本项目使用 JetBrains IDEA 进行开发

halo-theme-chirpy's Issues

试用主题后的几点建议反馈

前言

• 首先感谢作者的辛勤努力和付出.
• 最近一直在为弃用wordperss找合适方案,并在halo和hexo之间徘徊.
• 无意间在halo的社区看到作者的主题发布,风格很是喜欢,简约大方,就像作者的slogan所说,非常适合写作
• 下载源码仔细查看后(尽管我对java一脸懵逼)但还是能感受到代码的思维逻辑及布局方案十分清晰且简化明了
• 希望作者后续升级还可以保持现有的极简风格,如若必要仅写作的必要功能和边框及颜色方案上做修改足够

---

试用后的几点建议

文章的封面图问题

1. 可以修改为单独设置或者如若有文章配图的话,可以直接引用文章配图;
2. 优化首页封面图的完整缩略显示;
3. 进入文章后,封面图没有必要在头部凸显,如若直接进入文章内容更加适配主题初心.

• #120
• #122

代码块的问题

1. 代码的样式对于我来说没有强大的需求,能够适配主题就够用;
2. 考虑到其他同学的审美需求您可酌情考虑修改或者列几个样式发起投票;
3. 比较实用的就是一键复制功能了,建议作者将其内置;我试过从后台注入代码,不能对其改变;

• #28

插件问题

1. 作者的插件既美观又实用,测试后发现只能兼容默认编辑器,不能够兼容其他的Markdown编辑插件
2. 建议作者能够优化该插件的兼容性,让更多同学都能使用上该插件的功能;

副标题的问题

1. 副标题的这个排版位置更倾向于瞬间或者说说之类的功能,建议作者修改
2. 这个副标题如若当作简单的介绍或者关键词句来使用的话,输入内容过多会出现排版不美观的现象,默认居左应该

• #119

页脚站点信息栏的问题

1. 这栏卡片单独在右下显示总感觉怪怪的,跟该主题感觉不适配;
2. 作者可以考虑放在最底部显示,也方便大家后期能够加入站点统计或者监控等代码输出的美观性;

0~0分钟 阅读

1. 这项功能我没有看懂他的作用,如果是统计阅读时长的好像又有点不对
2. 是否能修改成阅读次数和转发引用量

---

最后再次感谢作者的付出,这个主题真的很棒,期待后期的升级,我也因此款主题决定留在halo与大家共同学习

问题配图

适配评论插件

后台设置中的评论设置是打开的，文章的评论也是打开的。
开启其他主题，有评论框。
开始 chirpy 主题没有评论框。

http://gpio.me/

主题颜色切换时的JS错误

halo.js:5  Uncaught TypeError: Cannot read properties of null (reading 'shadowRoot')
    at Object.flipMode (halo.js:5:42)
    at ModeToggle.flipMode ((索引):183:14)
    at HTMLButtonElement.<anonymous> (mode-watcher.js:18:16)
    at HTMLButtonElement.dispatch (jquery.js:5135:27)
    at H.handle (jquery.js:4939:28)

判断评论插件不存在时不执行此方法

移除文章内容中上方的封面图

自定义页面page获取title失败，值为null

• 问题描述：设置自定义页面的title动态获取失败，值为null
• 解决方案：修改page.html:
  • 原有实现

    th:replace="~{modules/layout :: html (title =${post.spec.title}

  • 期望实现

    th:replace="~{modules/layout :: html (title =${singlePage.spec.title}

如何修改字体？

如何修改全局的字体呢？

---

见：#127 (comment)

强烈建议支持以Github的Markdown样式展示文章正文

目前正在使用halo-theme-chirpy主题，全部文章都是使用markdown编写的，个人感觉markdown样式做的最好的就是Github。VSCode中的markdown插件有提供Github Markdown样式，以前免费现在付费的Typora也支持Github样式的主题。Github的markdown样式呈现效果是结构清晰，美观又大方。强烈建议halo-theme-chirpy主题支持以Github的markdown样式展示文章正文。目前的halo-theme-chirpy主题展示文章中的代码段时的表现一言难尽。

[bug] 评论组件黑色模式下仍显示为白色

rt

分享文章

主页新增备案号

作者你好，这个主题听好看的，请问怎么在主页增加备案号，不太懂这方面

设置默认头像

当站点头像信息为空时，设置默认头像。

文章内容样式优化

• #28

• AirboZH/halo-plugin-chirpy#4

• #111

halo's official website url error

At the bottom, halo's official website address, you seem to have forgotten to modify

适配暗色模式下搜索插件颜色

halo version: 2.8.0
theme version: 1.0.4

在黑暗模式下点击搜索框屏幕表现仍与亮色模式相
希望改进：白色的半透明改为黑色的半透明，搜索框底色改为黑

Github Workflow

• 自动打包
• 自动发布

选择框

左上角目录和右上角搜索失灵

• ios端首页点进去一篇文章之后左上角的目录按钮和右上角的搜索按钮失效，无法点击
  safari和chrome都如此

• 深色模式下标题字体太黑

[bug] LaTex渲染后公式过长无法自动换行

参考页面
https://www.novashen.top/archives/1696694989387

建议适配瞬间和相册

RT

更多阅读

404 页面

归档页面文字未对齐

归档页面中日期显示以DD/MM方式进行
DD为一位数时和两位数时会有一个字符的缩进未处理

俩图一样，那个加载快就看哪个

然后呢我的初步想法是DD为一位数时在前方添加前导0，如图

或者是在数字前方进行缩进以对齐两位数的第二位数字
检查中弄不出来，不清楚能不能做
😂😂
辛苦啦

高亮代码块

推荐文章

• #26

• #27

侧栏 FontAwesome X-Twitter 图标不显示

如题
Halo 2.8.0由1Panel部署
Chirpy 1.0.1 深色模式
侧栏 fab fa-x-twitter 与 fab fa-square-x-twitter 均不显示

目录 与 分类 的优化建议

目录的建议

1. 在目录列表内增加一二三....标题级别的序号;
2. 目录列表自动拉取二级标题到目录,不识别一级标题;
3. 这里补充下附图上口误,我又实验了下,不是拷贝文章时才拉取二级标题
   我手打文章同样只拉取二级标题,一级标题时不识别的;
4. 另外就是附图上说的标题少不拉取,我又实验了下,手打是拉取的,2个标题也会拉取,
   我那篇不拉取的有可能是我拷贝的问题,但是我对文章又做了重新编排,还是不行,目前不知道什么原因.

类别的优化建议

1. 分类是不是可以优化个页面或列表出来,内容增大后无法完美细分,也不方便阅读者查找内容;
2. 一级分类目录和子目录应考虑有上下级的分类展示,方便读者内容的查找;
3. 子目录如果不在侧边栏调出使用,是不会有子目录的文章展示的,除非在一级分类目录的文章页面点击
   分类路径的地址,或者点击进入全部分类目录找到子目录进入查看.

问题附图

侧栏目录

右侧 Trending Tags 中标签跳转链接不对

目前跳转链接为 /tag/标签名，应该是 /tags/标签名。

文章摘要不显示

如题，在console端已设置文章自动生成摘要，但是首页列出的文章只包括标题，摘要不显示

从上游更新 6.2.x 版本

https://github.com/cotes2020/jekyll-theme-chirpy

独立页面样式错误

在浅色主题下，用户登录后，访问独立页面时，下方评论区，用户名称无法看清，显示的效果需优化。

Chirpy 版本 1.1.0
Chirpy Add-on 版本 0.0.2

文章页阅读时间和文章字数统计

完成文章页 阅读时间 和 文章字数 统计

适配友链页面

• 我今天闲着没事按照 RyanWang 的链接管理插件配置了下,400错误或500错误😅
• 我搞不来,还是您出手吧,给增加个友链的模板吧😄

【BUG】右上角搜索失灵

您好：
我再使用chirpy的时候，发现 pc端的搜索按钮没有反应。

chipy version：Chirpy
halo version：2.10.2

谢谢~

适配瞬间插件

[bug] LaTex渲染的公式编号错位

示例https://novashen.top/archives/1695311188786
如我文章所示，位置是完全不对的

由于我对halo的浅薄理解，我觉得这应该是渲染dom时的插件的问题，应该不是主题的问题
但还是来提个issue，辛苦看一下

自定义页面评论组件适配问题

移动端页面目录按钮失效

移动端页面中左上角的目录按钮失效，点击后无任何反应，使用的版本是 halo 2.9 + halo-theme-chirpy 1.1.0。

问题类似于之前的 issue #12

文章上下页

多语言适配

版权许可

更新关于文章封面图的文档说明

封面图比例的说明

异常页面标题重复展示

主题js和css加载失败

halo升级到2.8之后，主题的js和css加载失败，使用vpn才能成功加载资源

Markdown 代码样式想法

提一个小小的想法，Markdown语法在使用反引号`对行内代码进行标记时，显示的是这样的效果：

私以为，这个样式会对文章的可读性造成一定的影响，这导致我在用这个主题撰写文章的时候，需要额外的多在两个反引号` 的左右两边各插入一个空格，以提升可读性：

并且就算加了空格，代码周围的空白也会让我看着有点别扭。

因为需要用反引号进行标注的一般都是英文单词，在不使用等宽字体的情况下，英文字母i与m的宽度不一，所造成的单词与汉字之间的间隔(肉眼看起来)不一致，容易造成观感割裂。

• 改进意见：类似Github这样的行内代码显示效果我个人认为就挺不错的，即在被标记的文本后面加背景：

  

当然以上谨代表我个人想法，如果你有什么其他的想法或是觉得这个issue不妥，请指教或者直接close它，谢谢！

⚠️Halo版本需求错误

theme.yaml

require: ">=2.0.0"

头像显示位置偏移

出现问题的网站

https://www.airbozh.cn/

情况说明

#51 PR中设置的line-height属性可能会导致头像显示位置偏移

深色模式下标题字体为黑色

深色模式下标题字体没有变化

不支持评论组件嘛

好似不显示评论

文章页面包屑动态标题

文章页面包屑动态标题