Description:
The IAUbbmag/hextra theme fork was created from a very early version of [imfing/hextra](https://github.com/imfing/hextra), roughly around v0.9. The upstream theme has since been updated to v0.12.3 with significant structural reorganization, new components, and API changes that are required for compatibility with Hugo v0.146 and later. The current fork is missing several files and uses an outdated structure that causes build errors.
Problems to Fix:
-
Missing partial files:
- Several partials that the theme now depends on were added in upstream v0.10–v0.12 and are absent from the fork, causing fatal build errors when those sections are rendered
-
Outdated scripts pipeline:
- The
scripts.html partial references individual JavaScript files that have been reorganized in the upstream theme, causing a build failure on every page render
-
Reserved i18n key conflict:
- The translation files (
en.yaml, fa.yaml) use the key description, which Hugo now reserves for internal use — this causes a fatal error that prevents the entire site from building
-
Layout directory structure:
- Hugo v0.146 changed how layout directories are organized. The old
partials/ folder is now _partials/, and shortcodes/ is now _shortcodes/. The fork needs to reflect this.
Tasks:
Expected Outcome:
The hextra fork should build cleanly against Hugo v0.162.1 with no missing partials, no i18n key conflicts, and no JavaScript pipeline errors. All existing custom sections should continue to function as before.
Description:
The
IAUbbmag/hextratheme fork was created from a very early version of [imfing/hextra](https://github.com/imfing/hextra), roughly around v0.9. The upstream theme has since been updated to v0.12.3 with significant structural reorganization, new components, and API changes that are required for compatibility with Hugo v0.146 and later. The current fork is missing several files and uses an outdated structure that causes build errors.Problems to Fix:
Missing partial files:
Outdated scripts pipeline:
scripts.htmlpartial references individual JavaScript files that have been reorganized in the upstream theme, causing a build failure on every page renderReserved i18n key conflict:
en.yaml,fa.yaml) use the keydescription, which Hugo now reserves for internal use — this causes a fatal error that prevents the entire site from buildingLayout directory structure:
partials/folder is now_partials/, andshortcodes/is now_shortcodes/. The fork needs to reflect this.Tasks:
descriptionkey in all i18n files and update every template that references itExpected Outcome:
The hextra fork should build cleanly against Hugo v0.162.1 with no missing partials, no i18n key conflicts, and no JavaScript pipeline errors. All existing custom sections should continue to function as before.