Add structured data for better agent access

_includes/head.html

@@ -33,6 +33,7 @@
   <meta name="view-transition" content="same-origin">
   <title>{{ title }}</title>
   <meta name="description" content="{{ description }}">
+  {% include structured-data.html title=title description=description image=image %}
 
   <link rel="canonical" href="{{ page.url | replace:'index.html','' | prepend: site.baseurl | prepend: site.url }}">
   <link rel="alternate" type="application/rss+xml" title="Blog posts" href="/rss.xml">

_includes/structured-data.html

@@ -0,0 +1,97 @@
+  {% assign canonical_url = page.url | replace:'index.html','' | prepend: site.baseurl | prepend: site.url %}
+  {% assign article_image = include.image %}
+  {% unless article_image %}
+    {% assign article_image = site.url | append: '/assets/branding/covers/cover_001.png' %}
+  {% endunless %}
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@graph": [
+      {
+        "@type": "Organization",
+        "@id": "{{ site.url }}/#organization",
+        "name": "{{ site.title }}",
+        "url": "{{ site.url }}",
+        "logo": {
+          "@type": "ImageObject",
+          "url": "{{ site.url }}/assets/branding/favicons/android-chrome-512x512.png"
+        },
+        "sameAs": [
+          "https://github.com/{{ site.github_username }}",
+          "https://{{ site.mastodon_server }}/@{{ site.mastodon_username }}",
+          "https://bsky.app/profile/{{ site.bluesky_username }}",
+          "https://twitter.com/{{ site.twitter_username }}"
+        ]
+      },
+      {
+        "@type": "WebSite",
+        "@id": "{{ site.url }}/#website",
+        "name": "{{ site.title }}",
+        "url": "{{ site.url }}",
+        "description": "{{ site.description | strip | escape }}",
+        "inLanguage": "{{ site.lang }}"
+      },
+      {
+        "@type": "WebPage",
+        "@id": "{{ canonical_url }}#webpage",
+        "url": "{{ canonical_url }}",
+        "name": "{{ include.title | default: page.title | strip | escape }}",
+        "description": "{{ include.description | default: page.description | default: site.description | strip | escape }}",
+        "isPartOf": {
+          "@id": "{{ site.url }}/#website"
+        },
+        "inLanguage": "{{ site.lang }}"
+      }
+      {% if page.layout == "blog" %}
+      ,{
+        "@type": "Article",
+        "@id": "{{ canonical_url }}#article",
+        "headline": "{{ page.title | strip | escape }}",
+        "description": "{{ include.description | default: page.description | default: site.description | strip | escape }}",
+        "url": "{{ canonical_url }}",
+        "image": {
+          "@type": "ImageObject",
+          "url": "{{ article_image }}"
+        },
+        "datePublished": "{{ page.date | date_to_xmlschema }}",
+        "dateModified": "{{ page.last_modified_at | default: page.date | date_to_xmlschema }}",
+        "publisher": {
+          "@id": "{{ site.url }}/#organization"
+        },
+        "mainEntityOfPage": {
+          "@id": "{{ canonical_url }}#webpage"
+        },
+        "inLanguage": "{{ site.lang }}"
+      }
+      {% elsif page.layout == "doc" %}
+      ,{
+        "@type": "TechArticle",
+        "@id": "{{ canonical_url }}#techarticle",
+        "headline": "{{ include.title | default: page.title | strip | escape }}",
+        "description": "{{ include.description | default: page.description | default: site.description | strip | escape }}",
+        "url": "{{ canonical_url }}",
+        "publisher": {
+          "@id": "{{ site.url }}/#organization"
+        },
+        "mainEntityOfPage": {
+          "@id": "{{ canonical_url }}#webpage"
+        },
+        "inLanguage": "{{ site.lang }}"
+      }
+      {% elsif page.url == "/" or page.url == "/index.html" %}
+      ,{
+        "@type": "SoftwareApplication",
+        "@id": "{{ site.url }}/#software",
+        "name": "{{ site.title }}",
+        "applicationCategory": "MultimediaApplication",
+        "operatingSystem": "Android",
+        "description": "{{ site.description | strip | escape }}",
+        "url": "{{ site.url }}",
+        "publisher": {
+          "@id": "{{ site.url }}/#organization"
+        }
+      }
+      {% endif %}
+    ]
+  }
+  </script>

llms.txt

@@ -0,0 +1,33 @@
+---
+layout: null
+---
+# AntennaPod
+
+Official website and documentation for the AntennaPod open-source Android podcast app.
+
+## Canonical
+- Website: {{ site.url }}
+- Documentation hub: {{ site.url }}/documentation
+- Blog: {{ site.url }}/blog, {{ site.url }}/rss.xml
+- Sitemap: {{ site.url }}/sitemap.xml
+
+## Documentation guide
+- Use documentation pages under `/documentation` as primary user-help references.
+- Localized versions of the documentation are available:
+{%- assign languages = site.data.locales | sort_natural: 'name' -%}
+{%- for language in languages -%}
+{% if site.languages contains language.code %}
+  - {{ language.name }} on {{ site.url }}{% if language.code != 'en' %}/{{ language.code }}/documentation{% endif %}
+{%- endif -%}
+{% endfor %}
+- You can find a full index of all documentation pages on {{ site.url }}/assets/datasets/documentation_index.json (around 60kB). Excerpt:
+```
+[
+    {
+      "title"    : "Automatic deletion",
+      "url"      : "/documentation/automation/deletion",
+      "excerpt"  : "Why are some downloaded episodes deleted? AntennaPod has several mechanisms ...",
+      "content"  : "..."
+    },
+    ...
+```

robots.txt

@@ -0,0 +1,7 @@
+---
+layout: null
+---
+User-agent: *
+Allow: /
+
+Sitemap: {{ site.url }}/sitemap.xml