## Documentation index This index lists every available documentation page and its Markdown source. - [Documentation](https://vara.varavel.com/docs/index.md) - [Introduction](https://vara.varavel.com/docs/introduction/index.md) - [Getting Started](https://vara.varavel.com/docs/getting-started/index.md) - [Installation](https://vara.varavel.com/docs/getting-started/installation/index.md) - [Quick Start](https://vara.varavel.com/docs/getting-started/quick-start/index.md) - [Composing a Landing Page](https://vara.varavel.com/docs/getting-started/composing-landing-page/index.md) - [Fundamentals](https://vara.varavel.com/docs/fundamentals/index.md) - [Project Structure](https://vara.varavel.com/docs/fundamentals/project-structure/index.md) - [Page Generators](https://vara.varavel.com/docs/fundamentals/page-generators/index.md) - [Site Settings](https://vara.varavel.com/docs/fundamentals/site-settings/index.md) - [Search and LLM Output](https://vara.varavel.com/docs/fundamentals/search-and-llms/index.md) - [Customization](https://vara.varavel.com/docs/fundamentals/customization/index.md) - [Functions and Filters](https://vara.varavel.com/docs/fundamentals/functions-and-filters/index.md) - [Templates](https://vara.varavel.com/docs/templates/index.md) - [vara-landing](https://vara.varavel.com/docs/templates/landing/index.md) - [vara-docs](https://vara.varavel.com/docs/templates/docs/index.md) - [vara-docs-raw](https://vara.varavel.com/docs/templates/docs-raw/index.md) - [vara-docs-search-index](https://vara.varavel.com/docs/templates/docs-search-index/index.md) - [vara-docs-llms-txt](https://vara.varavel.com/docs/templates/docs-llms-txt/index.md) - [vara-docs-llms-full-txt](https://vara.varavel.com/docs/templates/docs-llms-full-txt/index.md) - [vara-sitemap-xml](https://vara.varavel.com/docs/templates/sitemap-xml/index.md) - [vara-404](https://vara.varavel.com/docs/templates/404/index.md) - [Components](https://vara.varavel.com/docs/components/index.md) - [Alert](https://vara.varavel.com/docs/components/alert/index.md) - [Badge](https://vara.varavel.com/docs/components/badge/index.md) - [Button](https://vara.varavel.com/docs/components/button/index.md) - [Container](https://vara.varavel.com/docs/components/container/index.md) - [Icon](https://vara.varavel.com/docs/components/icon/index.md) - [Keyboard Key](https://vara.varavel.com/docs/components/kbd/index.md) - [Header](https://vara.varavel.com/docs/components/header/index.md) - [Hero](https://vara.varavel.com/docs/components/hero/index.md) - [Content Split](https://vara.varavel.com/docs/components/content-split/index.md) - [Features](https://vara.varavel.com/docs/components/features/index.md) - [Stats](https://vara.varavel.com/docs/components/stats/index.md) - [FAQ](https://vara.varavel.com/docs/components/faq/index.md) - [Testimonial](https://vara.varavel.com/docs/components/testimonial/index.md) - [Carousel](https://vara.varavel.com/docs/components/carousel/index.md) - [Call to Action](https://vara.varavel.com/docs/components/cta/index.md) - [Footer](https://vara.varavel.com/docs/components/footer/index.md) - [Troubleshooting](https://vara.varavel.com/docs/troubleshooting/index.md) ## Documentation content The documentation for the current page follows, reproduced verbatim. # Troubleshooting A few issues come up often enough that it is worth having the answers handy. If your problem is not here, start with the page that covers the feature - most topics in this documentation have a "when it breaks" note near the end. ## The page looks unstyled or blank Check that `veta.yaml` points at the theme's stylesheet: ```yaml tailwindcss: stylesheets: - styles.css minify: true ``` If you created your own `public/styles.css`, make sure it imports the theme's styles first: ```css @import "./styles_vara.css"; ``` ## A component does not render Components are resolved after Markdown, as custom tags. The usual culprits: - The tag name has a typo or does not start with `vara-`. - The component file is not in `components/` with a `.j2` extension. - The tag is inside a fenced code block, where it is shown as code on purpose. - A paired component is missing its closing tag. ## The search dialog reports a configuration error The search dialog shows an error when it cannot load the index. Make sure your generator creates a page with the `vara-docs-search-index` template at `docs_search_index_permalink` (default `/docs/vara-docs-search-index.json`), or disable search with `docs_search: false`. See [Search and LLM output](../fundamentals/search-and-llms/). ## A heading does not appear in the table of contents The TOC is built from the `h2` and `h3` headings that live in the page's prose. Headings inside components are excluded because components render with a `not-prose` marker. Move the heading out of the component if you want it to be navigable. See [vara-docs](../templates/docs/). ## The 404 page does not show The theme generates a static `404.html`. Most static hosts serve it automatically for missing routes; if yours does not, point the host at `404.html` as the custom error page. ## An icon renders a warning glyph The icon name does not match a file in the theme's icon set. Check the spelling, and remember that brand icons use the `si-` prefix when they collide with a Lucide name. See [Icon](../components/icon/). ## A draft page still appears on the site The theme skips pages whose frontmatter has `draft: true`, but only when your generator applies that filter. If you wrote your own generator, add the same `draft` check. See [Page generators](../fundamentals/page-generators/). ## Links look wrong after deploying Set `site_url` to your public origin in `data/site.yaml`. Interactive navigation stays relative, while canonical tags, the sitemap, and LLM output use the absolute base URL. See [Site settings](../fundamentals/site-settings/). ## The year in the footer is not replaced The footer replaces the `%year%` placeholder (with flexible spacing and any casing). If you wrote your own footer, use the `vara_component_footer_copyright` function, which reads the year from the theme data. See [Footer](../components/footer/).