website-htmx-rustelo-code/site/templates/build-tools

Site-Info Documentation Templates

This directory contains the Tera templates used by the site-info system to generate documentation from code analysis.

Structure

site-info/
├── documentation/          # Main page templates
│   ├── base.tera           # Base layout template
│   ├── summary.tera        # Summary pages with metrics
│   ├── reference.tera      # Detailed reference docs
│   ├── automation.tera     # Automation guide
│   └── top_level.tera      # Top-level overview
├── partials/               # Reusable components
│   ├── route_table.tera    # Route information table
│   ├── component_card.tera # Component display card
│   ├── source_link.tera    # Source reference links
│   ├── metrics_summary.tera # Statistics summary
│   └── nav_breadcrumbs.tera # Navigation breadcrumbs
├── i18n/                   # Language-specific templates
│   ├── en/                 # English templates
│   └── es/                 # Spanish templates
└── README.md               # This file

Configuration

Templates are configured in config/site-info.toml:

[templates]
engine = "tera"
templates_path = "site/templates/site-info"
default_language = "en"
supported_languages = ["en", "es"]

Internationalization

Labels and text are loaded from FTL files in:

• site/content/i18n/site-info/en/templates.ftl (English)
• site/content/i18n/site-info/es/templates.ftl (Spanish)

Template Context

Templates receive a DocumentationContext with:

• doc.routes - API route information
• doc.components - Component definitions
• doc.pages - Page route configurations
• i18n.labels - Localized text labels
• summary - Statistical information
• metadata - Generation metadata
• theme - Display configuration

Custom Filters

Available Tera filters:

• anchor - Generate kebab-case anchors
• source_link - Format source reference links
• pluralize - Handle singular/plural forms
• method_color - HTTP method color coding

Custom Functions

Available Tera functions:

• toc(items) - Generate table of contents
• format_number(number) - Format numbers with commas

Environment Variables

• SITE_TEMPLATES_PATH - Base templates directory (default: "site/templates")
• SITE_I18N_PATH - I18n content directory (default: "site/content")
• SITE_CONFIG_PATH - Configuration directory (default: "config")

Usage

Templates are automatically loaded by the site-info build system. To customize:

1. Edit templates in this directory
2. Update FTL files for text changes
3. Modify config/site-info.toml for settings
4. Rebuild the project to regenerate documentation