Project homepage: https://github.com/xianmin/hugo-theme-jane .

Update Content

  • Using Pico CSS as the color scheme, with switchable theme colors and dark/light mode support.
  • Custom homepage.
  • Added STYLE SETTINGS, located in /assets/sass/_settings.scss
  • Deprecated Category page, merged into Archive page.

Since there are many modifications, some areas are still not perfect. Thank you for your understanding!

Customize Your Homepage

The original homepage was a paginated article list, which could be somewhat monotonous. Now you can have a more personalized homepage.

Copy /exampleSite/content/_index.md to your website’s /content/_index.md and modify the parameters.

For multilingual sites, create similar _index.language.md files, such as _index.zh-cn.md.

Personalize Your Website Through STYLE SETTINGS

Copy /assets/sass/_settings.scss and /assets/sass/_custom.scss to your website’s root directory (Note: path names and file names must match).

Modify variables in _settings.scss and add custom styles in /assets/sass/_custom.scss.

Upgrading from Old Version to v3

Due to the new version using the latest Sass language features, Dart Sass needs to be installed.

Installation guide can be found in the official documentation: https://gohugo.io/hugo-pipes/transpile-sass-to-css/#dart-sass

If you’re using CI/CD automation tools, remember to install Dart Sass as well: https://gohugo.io/hugo-pipes/transpile-sass-to-css/#installing-in-a-production-environment

Note: You might encounter some compatibility issues after upgrading. If you face any difficulties, feel free to open an issue.

Theme Development Philosophy

  1. No node_modules, fewer dependencies mean easier maintenance
  2. Encouraging users to modify the theme according to their preferences for a more personalized website
  3. Reading experience is always the top priority
  4. Deploy once, focus on writing, no more tinkering

Afterword

I’ve been using this website theme for seven years. Except for frequent changes in the first year, it hasn’t been modified much since then.

I’ve always believed that for personal blogs, the written content is the most important, and as for the website style, it just needs to be acceptable.

This major revision was a sudden inspiration to completely change the color scheme and upgrade the Hugo version while at it.

I hope users will enjoy it.