docs: add Open Graph and Twitter card meta tags so shared links show rich previews

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 2 people

docs/overrides/main.html

@@ -0,0 +1,31 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+  {% if page and page.title %}
+    {% set page_title = page.title ~ " - " ~ config.site_name %}
+  {% else %}
+    {% set page_title = config.site_name %}
+  {% endif %}
+  {% if page and page.meta and page.meta.description %}
+    {% set page_desc = page.meta.description %}
+  {% else %}
+    {% set page_desc = config.site_description %}
+  {% endif %}
+  {% if page and page.canonical_url %}
+    {% set page_url = page.canonical_url %}
+  {% else %}
+    {% set page_url = config.site_url %}
+  {% endif %}
+
+  <!-- Open Graph -->
+  <meta property="og:type" content="website">
+  <meta property="og:title" content="{{ page_title }}">
+  <meta property="og:description" content="{{ page_desc }}">
+  <meta property="og:url" content="{{ page_url }}">
+  <meta property="og:site_name" content="{{ config.site_name }}">
+
+  <!-- Twitter Card -->
+  <meta name="twitter:card" content="summary">
+  <meta name="twitter:title" content="{{ page_title }}">
+  <meta name="twitter:description" content="{{ page_desc }}">
+{% endblock %}

mkdocs.yml

@@ -8,6 +8,7 @@ copyright: Copyright © 2025–2026 Computerlove Technologies
 
 theme:
   name: material
+  custom_dir: docs/overrides
   palette:
     - media: "(prefers-color-scheme: light)"
       scheme: default