Skip to content

Fix Custom Section Layouts #58

Description

@AliParvini

Description:

The website includes several custom-designed section pages — Issues, Interviews, Staff profiles, and Contests — each with its own layout file. These layouts were written against the old version of hextra and Hugo, and two breaking changes have left them visually broken. The pages may technically load without a hard error, but the layout and styling are incorrect because the underlying APIs and class names have changed.


Problems to Fix:

  1. Broken breadcrumb navigation:

    • The breadcrumb partial updated its expected input in hextra v0.10. The custom layouts still pass the old format, which results in missing or non-functional breadcrumb navigation on all affected section pages.
  2. Broken page styling:

    • Hextra v0.10 changed the prefix for all its CSS utility classes from hx- to hx:. Every custom layout file still uses the old prefix, meaning none of the hextra-specific styles are applied — resulting in broken spacing, alignment, and visual structure across all custom pages.
  3. Deprecated Hugo template API usage:

    • Some layouts use .Scratch, which is the old Hugo API for storing temporary values during rendering. This has been replaced in modern Hugo versions.

Tasks:

  • Fix breadcrumb partial calls in all affected layout files to use the updated input format
  • Update all hextra CSS utility class prefixes across every custom layout file
  • Replace deprecated .Scratch API usage with the current Hugo equivalent where applicable
  • Visually review each section page in the browser after fixes — Issues, Interviews, Staff, Contests
  • Confirm both English and Persian versions of each section render correctly

Expected Outcome:

All custom section pages should display with correct layout, spacing, and styling. Breadcrumb navigation should appear and work correctly on all affected pages. No visual regressions compared to the previous working version.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions