Skip to content

Releases: joe-mccarthy/termfolio

Release list

v1.0.2

v1.0.2 Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 21 Jul 17:06
v1.0.2
This tag was signed with the committer’s verified signature.
joe-mccarthy Joe McCarthy
SSH Key Fingerprint: KyZ31IetaFZUWVGwBXjRM+21aGLTw/ri6CcIz/jDFPk
Verified
Learn about vigilant mode.
71173c3
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Termfolio v1.0.2 is a backward-compatible maintenance release that corrects taxonomy and page-language rendering across the supported Hugo range, expands the project documentation, and hardens the checks used to validate and publish the theme.

Highlights

  • Category, tag, and series indexes now list their terms consistently, while individual term pages retain their descriptions and post listings across supported Hugo versions.
  • The rendered <html lang> value now remains correct with both the recommended defaultContentLanguage setting and legacy languageCode configurations.
  • New configuration, content-authoring, development, contribution, support, and release guides provide copy-ready setup examples and clearer troubleshooting.
  • Continuous integration now exercises standard Hugo at the minimum and current supported versions, documentation and link checks, ShellCheck, release-candidate validation, and Lighthouse accessibility audits.
  • Release and example-site workflows now validate exact commits, use narrowly scoped permissions, and preserve immutable annotated-tag publication.

Upgrading from v1.0.1

No breaking theme changes are known in this release.

If your site still sets languageCode, Termfolio continues to use that value for the rendered page language. Hugo 0.158.0 and newer deprecate that configuration key, however, and builds using --panicOnWarning will fail while Hugo loads the configuration. Replace it with defaultContentLanguage to keep one warning-free configuration across Termfolio's supported Hugo range:

defaultContentLanguage: en-gb

Sites with custom taxonomy or term layout overrides should compare those overrides with the updated theme templates before upgrading, because site-owned layouts take precedence over the theme.

Compatibility

  • Requires Hugo 0.128.0 or newer.
  • Standard Hugo is supported; Hugo Extended is not required.
  • Hugo configuration may use YAML, TOML, or JSON.
  • The interface remains intentionally dark-only.

Installation

Git submodule

For a new installation:

git submodule add https://github.com/joe-mccarthy/termfolio themes/termfolio
git -C themes/termfolio checkout v1.0.2

For an existing submodule installation, fetch the release tag, check out v1.0.2, and commit the updated submodule reference in the parent site.

Release archive

Download the source ZIP or tar.gz archive from this release and extract it to themes/termfolio. Record the installed version so future upgrades remain reproducible.

The README and documentation cover complete configuration, content authoring, search, styling, development, contribution, and support workflows.

Known limitations

  • Termfolio does not provide a light colour scheme.
  • The built-in search index grows with published text; Pagefind remains the recommended provider for larger content collections.
  • Distribution consists of GitHub's source ZIP and tar.gz archives. No binary or package-registry artifacts are produced.

Termfolio is released under the MIT License. The bundled JetBrains Mono font files remain covered by the SIL Open Font License 1.1.

View the live demonstration.

Assets 2
Loading