Merge pull request #1091 from ApolloAutomation/dev

Sync dev to main: link embed metadata

Author: bharvey88

layouts/apollo.yml

@@ -54,10 +54,11 @@ definitions:
   - &site_name >-
     {{ config.site_name }}
 
-  # Page title with site name
-  - &page_title_with_site_name >-
+  # Page title. No site name suffix: `og:site_name` already prints "Apollo
+  # Docs" on its own line directly above the title in an embed.
+  - &page_title >-
     {%- if not page.is_homepage -%}
-      {{ page.meta.get("title", page.title) }} - {{ config.site_name }}
+      {{ page.meta.get("title", page.title) }}
     {%- else -%}
       {{ config.site_name }}
     {%- endif -%}
@@ -83,7 +84,8 @@ tags:
 
   # Open Graph
   og:type: website
-  og:title: *page_title_with_site_name
+  og:site_name: *site_name
+  og:title: *page_title
   og:description: *page_description
   og:image: "{{ image.url }}"
   og:image:type: "{{ image.type }}"
@@ -93,7 +95,7 @@ tags:
 
   # Twitter
   twitter:card: summary
-  twitter:title: *page_title_with_site_name
+  twitter:title: *page_title
   twitter:description: *page_description
   twitter:image: "{{ image.url }}"
 

mkdocs.yml

@@ -8,6 +8,7 @@ extra_css:
   - stylesheets/osano.css
   - stylesheets/pmm.css
 site_name: Apollo Docs
+site_description: Setup guides, troubleshooting, and firmware documentation for Apollo Automation sensors.
 #site_url: https://apolloautomation.github.io/
 site_url: https://wiki.apolloautomation.com
 repo_url: https://github.com/ApolloAutomation/docs

overrides/main.html

@@ -0,0 +1,14 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+  {{ super() }}
+
+  {#-
+    Discord tints the vertical stripe on the left edge of a link embed with
+    this tag. Material does not emit one, because the palette here uses a
+    custom primary rather than a named color. It must be `name=` rather than
+    `property=`, so it cannot come from the social card layout, which emits
+    `property=` for everything.
+  -#}
+  <meta name="theme-color" content="#9ABC31">
+{% endblock %}