Benutzerdefinierte Favicons und OpenGraph-Metadaten stellen sicher, dass Ihre Dokumentation professionell aussieht, wenn sie in Browser-Tabs als Lesezeichen gespeichert oder über soziale Netzwerke und Kommunikationskanäle geteilt wird.
Favicon-Konfiguration
Platzieren Sie Ihre Favicon-Datei (z. B. favicon.svg oder favicon.ico) in Ihrem assets/-Verzeichnis und konfigurieren Sie die Eigenschaft favicon in docmd.config.json:
{
"title": "Dokumentations-Kern",
"favicon": "/assets/favicon.svg"
}
docmd verwaltet die Pfadauflösung und Cache-Busting-Header während der Kompilierung automatisch.
Globale SEO- & Social-Metadaten
Konfigurieren Sie das integrierte SEO-Plugin in docmd.config.json, um website-weite Meta-Tags und Social-Card-Vorschauen zu generieren:
{
"url": "https://docs.docmd.io",
"plugins": {
"seo": {
"defaultDescription": "Technische Dokumentation für docmd.",
"openGraph": {
"defaultImage": "/assets/og-banner.png"
},
"twitter": {
"siteUsername": "@docmd_io",
"cardType": "summary_large_image"
}
}
}
}
Metadaten-Überschreibungen auf Seitenebene
Überschreiben Sie website-weite SEO-Standards für bestimmte Seiten mithilfe der Eigenschaft seo im Seiten-Frontmatter:
---
title: "Ankündigung des Haupt-Releases"
description: "Übersicht über neue Funktionen in docmd."
seo:
image: "/assets/v09-banner.png"
keywords: ["release", "v09", "dokumentation", "performance"]
---
Die Konfigurationseinstellung favicon auf oberster Ebene deckt primäre Browseranforderungen ab. Für Favicon-Sets mit mehreren Auflösungen (wie Apple Touch Icons oder Android-Web-Manifeste) injizieren Sie zusätzliche <link>-Header über benutzerdefinierte Plugins oder Template-Head-Slots.