Guides

Guides explain the workflows used to build and maintain a Sarde site. Use them
when the task spans several reference entries or when the order of steps matters.

Start with content

Read these first when setting up a new site or moving existing Markdown into
Sarde:

• Project Structure explains where content,
  templates, assets, and configuration live.
• Content and Collections explains how
  folders become docs, blogs, courses, and other collections.
• Writing Content covers frontmatter, page
  bundles, drafts, scheduled content, and expiring pages.
• Internal Links covers link syntax, resolution
  rules, anchor validation, and URL composition across languages and versions.
• Navigation and Sidebar covers sidebar
  ordering, grouping, icons, badges, and manual overrides.
• Tabbed Navigation explains tab-based
  navigation for multi-area docs collections.
• Blog and Taxonomies covers blog
  collections, tags, categories, and taxonomy pages.

Polish the site

Use these guides after the core content exists:

• Search explains the offline search index and search
  UI.
• SEO and Feeds covers metadata, feeds, sitemap,
  robots.txt, and social cards.
• Link Validation and Linting covers
  link checks, content linting, and report formats.
• Icons explains inline SVG icons from Iconify sets and
  local files.
• Page Banners covers per-page and cascading
  banner notices via frontmatter.

Customize the output

Use these when changing the appearance or output behavior:

• Themes and Styling covers presets, tokens,
  dark mode, and CSS layer order.
• Layouts and Templates explains layout
  selection, template lookup, components, and partials.
• Images and Assets covers responsive images,
  static files, bundled CSS, and bundled JavaScript.
• Homepage covers the eight homepage templates and
  hero configuration.
• Code Blocks covers syntax highlighting, line
  highlighting, diffs, titles, and code groups.
• Internationalization covers multi-language
  sites, localized URLs, and RTL support.
• Versioning covers multi-version documentation with
  version switcher and search scoping.
• Slides and Presentations links to the
  Teaching section for slide decks, presentation layout, and
  course integration.