⚾︎
2023-08-18
Today I Learned
When writing Zola page source with internal links to other pages, refer to the documentation. Internal links follow the build folder paths and file names, not the rendered site's folder paths and names.
That means an internal link might look like
[Zola internal links](@/pages/zola-internal-links.md)
referring to a file under your Zola site source folder like
content/pages/zola-internal-links.md
and render via "zola build" to something like
href="/blog/pages/zola-internal-links"
or via "zola serve", to
href="/pages/zola-internal-links"
The docs call out internal linking as a special case in the left doc section navbar, so it's not actually obscure, just inobvious when writing posts, and my first few tweaks of Markdown link format failed to get the links in sync.
The special @/content/page.md internal links are
checked at site build for consistency, and a broken link
will fail the site build.