User Guides

  • Getting Started — Quick start guide for using helix-docs as a remote theme on GitHub Pages or locally via RubyGems.
  • Working with Layouts — Detailed reference and frontmatter schemas for all nine built-in layouts.
  • Home Pages & the vCard Pattern — Composing the site home page (index.md) with the default layout and vCard-style sections.
  • Theme Configuration — Complete reference of _config.yml keys, collection settings, and cascade defaults.
  • UI Components & Elements — Using responsive cards, tables, callout notices, button groups, and Mermaid diagrams.
  • 18-Language Translation — Configuring and customizing the Google Translate integration and persistent cookie system.

Community Wiki

Looking for deep technical internals, CSS design tokens, or Liquid layout schemas? Explore our Technical Wiki Directory.