Skip to content

chlorine3545/hugo-theme-hermeneutics

Repository files navigation

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, no third-party dependencies except for the optional commenting system and Shiki)
  • Extremely beautiful interface and animations (at least in my opinion)
  • Fully responsive
  • Rich shortcodes and additional features:
    • LaTeX support
    • GitHub Alert support for native Markdown
    • Announcement feature
    • Comment support (currently only supports Twikoo)
    • bilibili video card support (note: not a player)
    • GitHub / GitLab / Gitea card support (Codeberg can use Gitea)
    • 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, I do not guarantee any effective help.

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 heavily 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.

About

But I call them all delusion —— beautiful delusion.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published