{% extends "base.html" %} {# Custom theme overrides for SEO: - Canonical URL per page - OpenGraph + Twitter card metadata - JSON-LD SoftwareApplication schema on the home page Registered via `theme.custom_dir: docs/overrides` in mkdocs.yml. #} {% block extrahead %} {{ super() }} {# ---------- Canonical URL ---------- #} {% if page and page.canonical_url %} {% endif %} {# ---------- OpenGraph ---------- #} {% set og_title = page.meta.title if page and page.meta and page.meta.title else (page.title ~ " — " ~ config.site_name if page and page.title else config.site_name) %} {% set og_description = page.meta.description if page and page.meta and page.meta.description else config.site_description %} {% set og_image = page.meta.image if page and page.meta and page.meta.image else (config.site_url ~ "assets/social-preview.png") %} {% set og_url = page.canonical_url if page and page.canonical_url else config.site_url %} {% set og_type = "website" if page and page.is_homepage else "article" %} {# ---------- Twitter card ---------- #} {# ---------- JSON-LD: SoftwareApplication on the home page ---------- #} {% if page and page.is_homepage %} {% endif %} {% endblock %}