taragen static sites from one binary

Errors and troubleshooting

Symptom Cause and fix
Page shows & or <p> where HTML should be You inserted an HTML string as text. Wrap it in raw(): {raw(post.body)}.
TypeError from JSX A child or attribute is an unsupported value, like an object as a child. Render a field of it instead.
"partial not found" The path in partial() is from the site root and without extension: partial("_partials/footer").
A page appears in serve but not in build It's a draft: draft: true or a future date.
[[ in a Markdown page breaks it Markdown runs through the template engine first. Write it as [[ "[[" ]], or use JSX for that page.
URL collision error Two things produce one URL (a page and static file, an output and a page, two aliases). The error names both; rename or remove one.
A tag page isn't generated params() only sees real, non-draft pages (in build). Check the source page has the tag and isn't a draft.
A card fails with an unknown font family Add the font file to the site (e.g. _assets/fonts/) and use its family name exactly. System fonts aren't used.
A link isn't in backlinks Links in layouts don't count; links to aliases, outputs, and static files don't count; absolute links need siteURL.
A relative link counts toward the wrong page Relative links resolve against <path>/ for clean-URL pages, as in the browser. Prefer root-relative links (/docs/setup).
A wildcard redirect works in serve but not on the host It couldn't be expanded into redirect pages (see the build warning). Use a host that reads _redirects, or point it at a path with :splat.
Code isn't colored Taragen emits classes, not colors. Add Chroma CSS to your stylesheet.
Logs print twice Bodies that call pages() are parsed twice so listings see every page.
[ txt · edit on github · card ]