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
81 commits 2 branches 0 tags 2.8 MiB
Find a file
Exact
Chlorine 95c170e17d
 docs: rename README.zh-CN to README.zh-Hans
2025-10-25 15:18:13 +08:00
archetypes docs: rename README.zh-CN to README.zh-Hans 2025-10-25 15:18:13 +08:00
assets MERGE 'custom' 2025-10-25 14:59:10 +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 MERGE 'custom' 2025-10-25 14:59:10 +08:00
static MERGE 'custom' 2025-10-25 14:59:10 +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 build(npm): update npm packages to latest 2025-10-25 15:14:29 +08:00
Justfile MERGE 'custom' 2025-10-25 14:59:10 +08:00
LICENSE INIT 2025-06-26 13:33:44 +08:00
package.json build(npm): update npm packages to latest 2025-10-25 15:14:29 +08:00
README.md docs: rename README.zh-CN to README.zh-Hans 2025-10-25 15:18:13 +08:00
README.zh-Hans.md docs: rename README.zh-CN to README.zh-Hans 2025-10-25 15:18:13 +08:00
theme.toml chore: move hugo.toml to tmpl repo 2025-10-25 15:15:10 +08:00
uno.config.ts MERGE 'custom' 2025-10-25 14:59:10 +08:00

README.md

Hugo Theme Hermeneutics

简体中文/zh-Hans

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.