chlorine/hugo-theme-hermeneutics
1
0
Fork 0
Code Issues Pull requests Projects Activity
But I call them all delusion——beautiful delusion. https://chlo.is
71 commits 1 branch 0 tags 2.6 MiB
Find a file
Exact
Chlorine 4dec102598
 revert: revert social.html for further test
2025-09-17 08:26:19 +08:00
archetypes refactor: major restructure of directory layout to follow latest Hugo conventions 2025-07-04 17:01:32 +08:00
assets fix: fix prose table style error 2025-09-16 18:28:26 +08:00
data perf: various i18n, a11y and HTML structure optimization 2025-09-01 20:17:05 +08:00
i18n refactor: some minor rename work 2025-09-02 10:41:14 +08:00
layouts revert: revert social.html for further test 2025-09-17 08:26:19 +08:00
static INIT 2025-06-26 13:33:44 +08:00
.gitignore build: move uno.css build to website build steps 2025-09-01 21:26:34 +08:00
biome.json refactor: add Biome formatter 2025-08-26 10:51:37 +08:00
bun.lock fix: fix prose table style error 2025-09-16 18:28:26 +08:00
hugo.toml fix: fix prose table style error 2025-09-16 18:28:26 +08:00
Justfile refactor: split hero area in home.html and cleanup anim.css 2025-09-02 09:32:35 +08:00
LICENSE INIT 2025-06-26 13:33:44 +08:00
package.json fix: fix prose table style error 2025-09-16 18:28:26 +08:00
README.md perf: add role="button" to checkbox trick inputs 2025-09-01 23:36:12 +08:00
README.zh-CN.md perf: add role="button" to checkbox trick inputs 2025-09-01 23:36:12 +08:00
theme.toml INIT 2025-06-26 13:33:44 +08:00
uno.config.ts fix: fix prose table style error 2025-09-16 18:28:26 +08:00

README.md

Hugo Theme Hermeneutics

🇨🇳 简体中文

If it comes first, they call that true love

If it comes second, they call that infatuation

They call that memory when it is over

But I call them all delusion, all delusion, all delusion

Beautiful delusion

Hermeneutics, a Hugo theme, built from scratch by me and Cursor in about 25 hours.

Origin of the Name

The name comes from a song I really love. You can find the original video here.

This theme doesn't have much to do with the religious or philosophical meaning of "hermeneutics", so you don't have to expect its style to match your first impression of the word.

Features

  • Highly native (only uses UnoCSS in theme dev)
  • Extremely beautiful interface and animations (at least in my opinion)
  • Fully responsive
  • Rich shortcodes and additional features:
    • Atom Feed and JSON Feed
    • Obsidian Style Wiki Links ([[Link|Display]]) (Markdown file only)
    • LaTeX support
    • GitHub Alert support for native Markdown
    • Announcement feature
    • Comment support (currently supports Twikoo and Artalk)
    • Algolia Docsearch / PageFind
    • bilibili video card support (note: not a player)
    • GitHub / GitLab / Gitea / Forgejo card support
    • Gallery
    • Pure native JavaScript image lightbox
    • Wowbook word count
    • Shiki code highlighting (optional, requires configuration)

WIP (Work in Progress)

  • Support for more commenting systems
  • Comprehensive, CJK-friendly search functionality
  • Refactor code for consistent code style
  • Further SEO optimization
  • Theme documentation

Disclaimer

The original intention of this theme was to create a self-use theme according to my own aesthetics. Due to its extremely radical development strategy, the code style and structure may not be satisfactory. If you wish to use or contribute, it's sincerely welcomed—I'll do my best to help, but can't guarantee the results.

Acknowledgements

  • The theme's design draws heavily from 白い. Many thanks to Innei for his brilliant design and aesthetics. "白い" is closed-source, and I did not refer to any code from its open-source version, Shiro. Therefore, I believe this theme is not subject to the "copyleft" provisions of Shiro's AGPLv3 license.
  • Code completion and project construction relied on Cursor.
  • twikoo.css references some styles from AnZhiYu.

License

This theme is open-sourced and freely distributed under the MIT License, both free as in beer and free as in speech.