KamiMod: An Incremental PaperMod Fork

KamiMod makes a few incremental changes to PaperMod. This fork regularly syncs up with PaperMod.

Features

This theme adds the following features and quality improvements on top of PaperMod. They are features or improvements that have been left unmerged from PaperMod.

Related Posts

• Corresponding to adityatelange/hugo-PaperMod#1049, with different implementation.
• Configurable via params.RelatedPostsCount. 0 means no related posts. A positive number indicates the maximum number of related posts appended to the end of each post. Default: 0.
• See the Hugo doc for further configuration of the behavior of related posts.

Add last modified date to post header

• adityatelange/hugo-PaperMod#1337

Add an option params.showDescription to not display descriptions

• adityatelange/hugo-PaperMod#1533
• .Description is meant to be used for metadata purpose:

  Conceptually different from a content summary, a page description is typically used in metadata about the page.

• Set params.showDescription to true to display descriptions, or false to hide descriptions. Default: false.

Allow setting ShowFullTextinRSS in individual pages

• adityatelange/hugo-PaperMod#1542

Add an option to exclude pages from the RSS feed

• Setting params.excludeFromRSS to true in the frontmatter of a page to exclude it from the RSS feed.

Fixes and Changes

Replace thumbnailUrl with logo in the schema

• adityatelange/hugo-PaperMod#1488
• thumbnailUrl is not part of the Organization schema.

<image><link> in RSS should link to the permalink

• adityatelange/hugo-PaperMod#1545

Remove the use of accesskey to improve accessibility

• adityatelange/hugo-PaperMod#1494
• MDN advises not using accesskeys for general purpose websites for various reasons.
• WebAIM also recommends against using accesskeys generally.

Use .Summary as RSS description instead of .Description

• Hugo description is conceptually for metadata about a page. Using .Description in RSS leads to very little information for readers.

Installation

You may follow the installation instructions from PaperMod, with the following changes:

• Replace https://github.com/adityatelange/hugo-PaperMod with https://github.com/8hobbies/KamiMod.
• Replace all other occurrences of PaperMod with KamiMod.

Configurations

Except for the features listed above, please follow the PaperMod doc for configurations.

Demo

There is also a live demo, along with its source code.

Contribution

If you would like to report a bug, please use the GitHub issue tracker. Since KamiMod is an incremental fork of PaperMod, it is highly recommended to report to PaperMod if applicable.

If you would like to make code contribution, please make a pull request to PaperMod first if applicable. If the pull request does not get merged in a reasonable amount of time, feel free to port the pull request here. To maintain the incremental nature of this project, we will not consider pull requests that are applicable to PaperMod if they haven’t been submitted to PaperMod first.