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. |