Git
/
hugo-theme-wondermod
mirror of https://github.com/Wonderfall/hugo-WonderMod.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A fast, clean, responsive and hardened Hugo theme.
1,061 Commits 3 Branches 6 Tags 17 MiB
HTML 84.3%
CSS 11.4%
JavaScript 4.2%
Go to file
samsepi0l df6d059a85
Improve favicons 
- Add mask_icon color
- Add manifest
- Make icon type, apple-touch-icon type, and svg (mask_icon) type explicit
 		2023-12-16 12:18:23 +01:00
.github Merge remote-tracking branch 'upstream/master' 2023-06-16 14:26:10 +02:00
assets Merge remote-tracking branch 'upstream/master' 2023-06-16 14:26:10 +02:00
i18n chore: update french translations (#1222) 2023-06-04 18:29:55 +05:30
images images: update 2020-09-25 13:35:31 +05:30
layouts Improve favicons 2023-12-16 12:18:23 +01:00
LICENSE Update License year 2023-02-12 12:21:40 +05:30
Makefile built-in Chroma 2022-07-24 01:39:42 +02:00
README.md Bump minimum Hugo version to 0.97.1 2023-05-07 17:40:58 +05:30
go.mod built-in Chroma 2022-07-24 01:39:42 +02:00
theme.toml Merge remote-tracking branch 'upstream/master' 2023-06-16 14:26:10 +02:00

README.md

WonderMod (PaperMod fork - theme for Hugo)

WonderMod image

What is this?

WonderMod is a fork of an original theme for Hugo called PaperMod (made by adityatelange). Since PaperMod isn't interested in a few changes such as removing inline JavaScript, which I personally require to harden my websites, I decided to maintain my own fork (I didn't want to keep overwriting a bunch of files as a fork workflow is much cleaner). Don't expect a ton of changes, and unless you know me, you probably don't want to use WonderMod.

When implementing new features, I try to do as much as I can with pure CSS code instead of adding new JavaScript code. I'd like to keep the JavaScript part minimal and that's why WonderMod should be totally usable when disabling JavaScript. WonderMod is also designed with strong CSP headers in mind: no inline JavaScript or style, no calls to third-parties.

This fork is regularly synced with upstream changes from PaperMod. A merging workflow was chosen since rebasing WonderMod's changes every time could be less efficient. As such, commit history is a bit messy, but upstream changes will be merged on a best effort basis.

Main changes

Current "main" changes are as follows:

  • Remove inline JavaScript (2528906)
  • Improved YouTube shortcode (4dc3bee)
  • Built-in Chroma instead of client-side syntax highlighting with HLJS (841141)
  • Responsive Table of Contents with side display support (2303605)
  • Responsive "hamburger" menu for mobile (723ac4f)
  • Simple reading progress bar (13876be)
  • Bunch of CSS and other changes (see commit history)

Credits

Additional credits:

Configure

Most of the installation process and settings are shared with the original PaperMod, so check out their documentation. One noticeable difference though is that in order to enable syntax highlighting, you have to add this to your config.yml :

markup:
    highlight:
        style: dracula
        noClasses: false
        guessSyntax: true

See Hugo documentation for more options. Note: for some reason, the guessSyntax doesn't actually work but is required. Please make your code fences explicit for the time being.