hugo-theme-journal/layouts, branch 2026.09.19

Link the tag list from the homepage

2026-09-20T00:00:00Z

Tags reach a dead end in gemtext. The entry metadata names them, but a gemtext link must occupy a whole line, so the names are plain text and the tag pages the theme generates cannot be reached from the homepage at all. The web homepage links each entry's own tags inline, yet neither format links the tag list itself, so a site had to add it to the navigation links by hand. Add a tags section to both homepage templates, holding a single link to the taxonomy list page, and place it between the navigation links and the feed. One link rather than one per term keeps the homepage short however many tags a site accumulates, and keeps the two output formats in step. Render it only when the taxonomy page exists and has terms, so that a site whose entries carry no tags, or which disables the taxonomy kinds outright, gains no heading and no dead link. The link is labelled from a new "tagList" string rather than reusing "tags", which would have read as a link named after the heading above it. As elsewhere in the theme, the taxonomy is found by lowercasing the "tags" string, so a translated site finds its own taxonomy: an example site built in Spanish links "Lista de etiquetas" under "Etiquetas". Co-Authored-By: Claude Opus 5

Link the homepage feed from the homepage

2026-09-20T00:00:00Z

The homepage was the one listing page with a feed but no link to it, so a reader could only find it through the autodiscovery element in the document head, which the capsule has no equivalent of. Sites worked around this by adding the feed to the navigation links by hand. Add a feeds section to both homepage templates, modelled on the one the taxonomy, term and section templates carry, and place it below the navigation links and above the entry list. As on those pages, it is rendered only when the home kind lists the Atom output format, so a site that omits the format gains nothing to link. The example site's homepage gains the section in both output formats and is otherwise byte-identical, as are the pages of every other kind. Co-Authored-By: Claude Opus 5

Add Atom feeds for sections

2026-09-20T00:00:00Z

Sections were the one listing kind without a feed of their own, though the section templates already linked one whenever the output format was configured. Add the two feed templates, modelled on the taxonomy and term ones, and turn the format on for sections in the example site. Co-Authored-By: Claude Opus 5

End generated capsule pages with a newline

2026-09-20T00:00:00Z

The templates gained a final newline, but the gemtext pages they build did not: the base template trimmed its own away, so every .gmi file ended mid-line and was not a POSIX text file either. The web pages and the feeds already ended with one. Stop trimming the newline after the footer partial in the gemtext base template. The footer partial keeps its own trim marker, so that the newline is emitted once rather than twice. Every generated file in the example site, gemtext and web alike, now ends with exactly one newline, and the capsule pages are otherwise byte-identical. Co-Authored-By: Claude Opus 5

End every template file with a newline

2026-09-20T00:00:00Z

Fifteen templates ended without a final newline, so they were not text files by the POSIX definition: tools that read whole lines, including sed, wc -l, read and shells' command substitution, drop or mangle the last line, and diffs of them carry a "\ No newline at end of file" marker that hides which side changed. Add the newline. The gemtext output may not change, so the four templates whose last action is emitted verbatim into a capsule page trim it away again with "-}}". The templates that end by closing a define block need no marker, since the newline then falls outside the block and is never executed, as section.gmi and single.gmi already showed. The capsule builds byte-identical gemtext and the feeds are unchanged. Web pages gain the trailing newline their templates now have, which ends the generated HTML with an EOL too. Co-Authored-By: Claude Opus 5

Drop whitespace trimming from HTML and XML templates

2026-09-20T00:00:00Z

Whitespace has no effect on the HTML and Atom output, so the trim markers on nearly every action in those templates bought nothing and made them harder to read and to edit: a maintainer had to carry the markers along with the change. The markers are load-bearing in the gemtext templates alone, where output whitespace is the formatting. Remove them from the HTML and Atom templates. The audio partial keeps its markers, since the gemtext single template uses it too. The two markup render hooks keep theirs as well, because their output is spliced inline into prose, where the newlines an untrimmed hook emits render as a space before the punctuation that follows a link. The Atom templates compute their author and entry variables before emitting anything, so untrimmed they put blank lines ahead of the XML declaration and left every feed malformed. Emit the declaration first instead; whitespace is allowed after it but not before it. The example site builds byte-identical gemtext and content-identical feeds, and its HTML differs only by a space after a "p" start tag that the whitespace processing model drops. Co-Authored-By: Claude Opus 5

Add section templates

2026-09-19T23:21:32Z

Every build logged "found no layout file for html for kind section", and the section URL that Hugo generates for the entry directory was rendered as an empty page in both output formats. The warning was left for each site using the theme to work around. List the section's pages the way the term templates do, and link the section feed when the site configures one. Co-Authored-By: Claude Opus 5

Handle missing optional site files gracefully

2026-09-19T23:00:02Z

Two site files the theme reads were assumed to exist. A site without templates/logo.txt got an empty preformatted block at the top of every page in both output formats, styled with the logo's margins, rather than no logo at all. A typo in params.custom_css produced a nil pointer error naming only the template line, since the result of resources.Get was used without checking it. Skip the header entirely when there is no logo, and report a missing stylesheet by name. Co-Authored-By: Claude Opus 5

Ignore blank lines between front matter and entry body

2026-09-19T22:26:10Z

.RawContent keeps the newline that follows the closing front matter delimiter, and only trailing whitespace was being chomped. An entry written with a blank line there, which is what the entry archetype produces, got one more blank line under its pageinfo line in the gemtext than an entry written without one. The same leading newline also hid a heading on the first line from the check that decides whether to add a separating newline, since that pattern is anchored to the start of the content. Co-Authored-By: Claude Opus 5

Drop scripting URL schemes from links and images

2026-09-19T20:34:32Z

Both render hooks passed the destination through safeURL, which bypasses the sanitising that html/template would otherwise apply, so a javascript: or data:text/html destination in Markdown became a live scripting URL in the page. That matters for any site built from content its author did not write. safeURL cannot simply be dropped: it is what allows gemini:// and other schemes html/template does not recognise to survive, which this theme depends on. Reject the scripting schemes explicitly instead, render the link text on its own, and warn during the build so the author can see what was dropped. data: is still allowed for images, where it is a legitimate way to inline one. Co-Authored-By: Claude Opus 5