{#-
  Theme override for the YazSes docs site.
  Extends MkDocs Material's base to inject crawler directives and, if ever
  needed, search-engine verification tags.

  Google Search Console
  ---------------------
  A URL-prefix property for https://mskazemi.com/ was verified on 2026-08-07 via
  the DNS ("Domain name provider") method, which covers this /yazses/ subdirectory
  and needs no meta tag at all. The token hooks below therefore stay EMPTY on
  purpose — they exist only as a fallback if DNS verification is ever lost.

  To use the fallback: add a URL-prefix property in GSC (NOT on
  mskazemi.github.io — that host now 301-redirects here and serves no content),
  pick the "HTML tag" method, and paste the token into mkdocs.yml under
  extra.google_site_verification. Same pattern for Bing via
  extra.bing_site_verification. Both are conditional, so an empty value emits
  nothing and the build stays green.
-#}
{% extends "base.html" %}

{% block extrahead %}
  {{ super() }}
  {#- Explicit crawler directives. Without this no robots meta is emitted at all:
      indexing still defaults to allowed, but the snippet and image-preview
      limits below are what let Google show a full-length snippet and a large
      image rather than truncating both to its conservative defaults. -#}
  <meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1">
  {% if config.extra.google_site_verification %}
  <meta name="google-site-verification" content="{{ config.extra.google_site_verification }}">
  {% endif %}
  {% if config.extra.bing_site_verification %}
  <meta name="msvalidate.01" content="{{ config.extra.bing_site_verification }}">
  {% endif %}
{% endblock %}