{% extends "base.html" %}

{#
  Link-preview metadata. Material only emits these when its `social` plugin is
  enabled, and that plugin needs cairo/pango on every machine that builds the
  docs -- including CI, where `mkdocs build --strict` would then fail hard if
  the system packages were missing. These six tags are the part that matters
  (a title, a sentence and a card image instead of a bare URL) and they cost
  nothing at build time, so they are emitted here instead.
#}
{% block extrahead %}
  {% set title = config.site_name %}
  {% if page and page.title and not page.is_homepage %}
    {% set title = page.title ~ " - " ~ config.site_name %}
  {% endif %}
  {% set description = config.site_description %}
  {% if page and page.meta and page.meta.description %}
    {% set description = page.meta.description %}
  {% endif %}
  {% set image = config.site_url ~ "assets/social-card.png" %}

  <meta property="og:type" content="website">
  <meta property="og:site_name" content="{{ config.site_name }}">
  <meta property="og:title" content="{{ title }}">
  <meta property="og:description" content="{{ description }}">
  <meta property="og:url" content="{{ page.canonical_url if page else config.site_url }}">
  <meta property="og:image" content="{{ image }}">
  <meta property="og:image:width" content="1200">
  <meta property="og:image:height" content="630">
  <meta property="og:image:alt" content="{{ config.site_name }} - {{ config.site_description }}">
  <meta name="twitter:card" content="summary_large_image">
  <meta name="twitter:title" content="{{ title }}">
  <meta name="twitter:description" content="{{ description }}">
  <meta name="twitter:image" content="{{ image }}">
{% endblock %}