[{"data":1,"prerenderedAt":452},["ShallowReactive",2],{"docs-navigation:de":3,"content-page:blog:-FeO6fFJdoICgryblAk0mWm6JFpH3UxUI6rc9beZlX8":241,"content-page-surround:blog:wCztaQc0fD9HHxro8fPu9riv4GYA7r5hMPiV4wZFVNY":437,"i-lucide:file":446,"i-lucide:clipboard":450},[4,23,44,77,118,151,171,197,221],{"title":5,"id":6,"canonicalKey":7,"locale":8,"draft":9,"navigation":10,"icon":12,"sidebar":13,"path":14,"children":15},"Dokumentation","content:de:1.dokumentation:1.erste-schritte:.navigation.yml","1","de",false,{"icon":11},"lucide:rocket","lucide:book-open","section","\u002Fde\u002Fdokumentation\u002Ferste-schritte",[16],{"title":17,"id":18,"canonicalKey":19,"locale":8,"draft":9,"navigation":20,"icon":21,"path":22},"Installation","content:de:1.dokumentation:1.erste-schritte:2.installation.md","1\u002F2",{"title":17,"icon":21},"lucide:download","\u002Fde\u002Fdokumentation\u002Ferste-schritte\u002Finstallation",{"title":24,"page":9,"canonicalKey":25,"locale":8,"id":26,"draft":9,"icon":27,"sidebar":28,"children":29},"Konzepte","2","content:de:1.dokumentation:2.konzepte:.navigation.yml","lucide:boxes","group",[30,37],{"title":31,"id":32,"canonicalKey":33,"locale":8,"draft":9,"navigation":34,"icon":35,"path":36},"Funktionsweise","content:de:1.dokumentation:2.konzepte:1.so-funktioniert-ginko-docs.md","2\u002F1",{"title":31,"icon":35},"lucide:workflow","\u002Fde\u002Fdokumentation\u002Fkonzepte\u002Fso-funktioniert-ginko-docs",{"title":38,"id":39,"canonicalKey":40,"locale":8,"draft":9,"navigation":41,"icon":42,"path":43},"Inhalte und Routen","content:de:1.dokumentation:2.konzepte:2.inhalte-und-routen.md","2\u002F2",{"icon":42},"lucide:route","\u002Fde\u002Fdokumentation\u002Fkonzepte\u002Finhalte-und-routen",{"title":45,"page":9,"canonicalKey":46,"locale":8,"id":47,"draft":9,"icon":48,"sidebar":28,"children":49},"Inhalte schreiben","3","content:de:1.dokumentation:3.inhalte:.navigation.yml","lucide:pen-line",[50,56,63,70],{"title":45,"id":51,"canonicalKey":52,"locale":8,"draft":9,"navigation":53,"icon":54,"path":55},"content:de:1.dokumentation:3.inhalte:1.inhalte-schreiben.md","3\u002F1",{"title":45,"icon":54},"lucide:file-pen-line","\u002Fde\u002Fdokumentation\u002Finhalte\u002Finhalte-schreiben",{"title":57,"id":58,"canonicalKey":59,"locale":8,"draft":9,"navigation":60,"icon":61,"path":62},"Navigation","content:de:1.dokumentation:3.inhalte:2.navigation.md","3\u002F2",{"title":57,"icon":61},"lucide:panel-left","\u002Fde\u002Fdokumentation\u002Finhalte\u002Fnavigation",{"title":64,"id":65,"canonicalKey":66,"locale":8,"draft":9,"navigation":67,"icon":68,"path":69},"Links","content:de:1.dokumentation:3.inhalte:3.links.md","3\u002F3",{"title":64,"icon":68},"lucide:link","\u002Fde\u002Fdokumentation\u002Finhalte\u002Flinks",{"title":71,"id":72,"canonicalKey":73,"locale":8,"draft":9,"navigation":74,"icon":75,"path":76},"Komponenten verwenden","content:de:1.dokumentation:3.inhalte:4.komponenten-verwenden.md","3\u002F4",{"title":71,"icon":75},"lucide:blocks","\u002Fde\u002Fdokumentation\u002Finhalte\u002Fkomponenten-verwenden",{"title":78,"page":9,"canonicalKey":79,"locale":8,"id":80,"draft":9,"icon":81,"sidebar":28,"children":82},"Funktionen","4","content:de:1.dokumentation:4.funktionen:.navigation.yml","lucide:sparkles",[83,90,97,104,111],{"title":84,"id":85,"canonicalKey":86,"locale":8,"draft":9,"navigation":87,"icon":88,"path":89},"Lokalisierung","content:de:1.dokumentation:4.funktionen:1.lokalisierung.md","4\u002F1",{"title":84},"lucide:languages","\u002Fde\u002Fdokumentation\u002Ffunktionen\u002Flokalisierung",{"title":91,"id":92,"canonicalKey":93,"locale":8,"draft":9,"navigation":94,"icon":95,"path":96},"Suche","content:de:1.dokumentation:4.funktionen:2.suche.md","4\u002F2",{"title":91},"lucide:search","\u002Fde\u002Fdokumentation\u002Ffunktionen\u002Fsuche",{"title":98,"id":99,"canonicalKey":100,"locale":8,"draft":9,"navigation":101,"icon":102,"path":103},"Blog","content:de:1.dokumentation:4.funktionen:3.blog.md","4\u002F3",{"title":98},"lucide:newspaper","\u002Fde\u002Fdokumentation\u002Ffunktionen\u002Fblog",{"title":105,"id":106,"canonicalKey":107,"locale":8,"draft":9,"navigation":108,"icon":109,"path":110},"SEO und Social Cards","content:de:1.dokumentation:4.funktionen:4.seo-und-social-cards.md","4\u002F4",{"title":105},"lucide:globe-2","\u002Fde\u002Fdokumentation\u002Ffunktionen\u002Fseo-und-social-cards",{"title":112,"id":113,"canonicalKey":114,"locale":8,"draft":9,"navigation":115,"icon":116,"path":117},"Agentenlesbare Ausgabe","content:de:1.dokumentation:4.funktionen:5.agentenlesbare-ausgabe.md","4\u002F5",{"title":112},"lucide:bot","\u002Fde\u002Fdokumentation\u002Ffunktionen\u002Fagentenlesbare-ausgabe",{"title":119,"page":9,"canonicalKey":120,"locale":8,"id":121,"draft":9,"icon":122,"sidebar":28,"children":123},"Anpassung","5","content:de:1.dokumentation:5.anpassung:.navigation.yml","lucide:paintbrush",[124,131,138,145],{"title":125,"id":126,"canonicalKey":127,"locale":8,"draft":9,"navigation":128,"icon":129,"path":130},"Website konfigurieren","content:de:1.dokumentation:5.anpassung:1.website-konfigurieren.md","5\u002F1",{"title":125},"lucide:settings-2","\u002Fde\u002Fdokumentation\u002Fanpassung\u002Fwebsite-konfigurieren",{"title":132,"id":133,"canonicalKey":134,"locale":8,"draft":9,"navigation":135,"icon":136,"path":137},"Startseite","content:de:1.dokumentation:5.anpassung:2.startseite.md","5\u002F2",{"title":132},"lucide:layout-template","\u002Fde\u002Fdokumentation\u002Fanpassung\u002Fstartseite",{"title":139,"id":140,"canonicalKey":141,"locale":8,"draft":9,"navigation":142,"icon":143,"path":144},"Design und Overrides","content:de:1.dokumentation:5.anpassung:3.design-und-overrides.md","5\u002F3",{"title":139},"lucide:palette","\u002Fde\u002Fdokumentation\u002Fanpassung\u002Fdesign-und-overrides",{"title":146,"id":147,"canonicalKey":148,"locale":8,"draft":9,"navigation":149,"icon":75,"path":150},"Eigene Komponenten","content:de:1.dokumentation:5.anpassung:4.eigene-komponenten.md","5\u002F4",{"title":146},"\u002Fde\u002Fdokumentation\u002Fanpassung\u002Feigene-komponenten",{"title":152,"page":9,"canonicalKey":153,"locale":8,"id":154,"draft":9,"icon":155,"sidebar":28,"children":156},"Betrieb","6","content:de:1.dokumentation:6.betrieb:.navigation.yml","lucide:cloud-cog",[157,164],{"title":158,"id":159,"canonicalKey":160,"locale":8,"draft":9,"navigation":161,"icon":162,"path":163},"Bereitstellung","content:de:1.dokumentation:6.betrieb:1.bereitstellung.md","6\u002F1",{"title":158,"icon":162},"lucide:cloud-upload","\u002Fde\u002Fdokumentation\u002Fbetrieb\u002Fbereitstellung",{"title":165,"id":166,"canonicalKey":167,"locale":8,"draft":9,"navigation":168,"icon":169,"path":170},"Fehlerbehebung","content:de:1.dokumentation:6.betrieb:2.fehlerbehebung.md","6\u002F2",{"title":165,"icon":169},"lucide:wrench","\u002Fde\u002Fdokumentation\u002Fbetrieb\u002Ffehlerbehebung",{"title":172,"page":9,"canonicalKey":173,"locale":8,"id":174,"draft":9,"icon":175,"sidebar":13,"children":176},"Referenz","7","content:de:1.dokumentation:7.referenz:.navigation.yml","lucide:braces",[177,184,190],{"title":178,"id":179,"canonicalKey":180,"locale":8,"draft":9,"navigation":181,"icon":182,"path":183},"Content-Konfiguration","content:de:1.dokumentation:7.referenz:1.content-config.md","7\u002F1",{"title":178,"icon":182},"lucide:database","\u002Fde\u002Fdokumentation\u002Freferenz\u002Fcontent-config",{"title":185,"id":186,"canonicalKey":187,"locale":8,"draft":9,"navigation":188,"icon":129,"path":189},"App-Konfiguration","content:de:1.dokumentation:7.referenz:2.app-config.md","7\u002F2",{"title":185,"icon":129},"\u002Fde\u002Fdokumentation\u002Freferenz\u002Fapp-config",{"title":191,"id":192,"canonicalKey":193,"locale":8,"draft":9,"navigation":194,"icon":195,"path":196},"Frontmatter und Schemas","content:de:1.dokumentation:7.referenz:3.frontmatter.md","7\u002F3",{"title":191,"icon":195},"lucide:file-json-2","\u002Fde\u002Fdokumentation\u002Freferenz\u002Ffrontmatter",{"title":198,"page":9,"canonicalKey":199,"locale":8,"id":200,"draft":9,"icon":75,"sidebar":28,"children":201},"Komponenten","8","content:de:1.dokumentation:8.komponenten:.navigation.yml",[202,208,215],{"title":203,"id":204,"canonicalKey":205,"locale":8,"draft":9,"navigation":206,"icon":75,"path":207},"MDC-Komponenten","content:de:1.dokumentation:8.komponenten:1.mdc-komponenten.md","8\u002F1",{"title":203,"icon":75},"\u002Fde\u002Fdokumentation\u002Fkomponenten\u002Fmdc-komponenten",{"title":209,"id":210,"canonicalKey":211,"locale":8,"draft":9,"navigation":212,"icon":213,"path":214},"API-Referenzpanels","content:de:1.dokumentation:8.komponenten:2.api-referenz.md","8\u002F2",{"title":209,"icon":213},"lucide:table-properties","\u002Fde\u002Fdokumentation\u002Fkomponenten\u002Fapi-referenz",{"title":216,"id":217,"canonicalKey":218,"locale":8,"draft":9,"navigation":219,"icon":75,"path":220},"Komponenten-Showcase","content:de:1.dokumentation:8.komponenten:3.komponenten-showcase.md","8\u002F3",{"title":216,"icon":75},"\u002Fde\u002Fdokumentation\u002Fkomponenten\u002Fkomponenten-showcase",{"title":222,"page":9,"canonicalKey":223,"locale":8,"id":224,"draft":9,"icon":225,"sidebar":28,"children":226},"Ressourcen","9","content:de:1.dokumentation:9.ressourcen:.navigation.yml","lucide:library",[227,234],{"title":228,"id":229,"canonicalKey":230,"locale":8,"draft":9,"navigation":231,"icon":232,"path":233},"Öffentliche Exporte","content:de:1.dokumentation:9.ressourcen:1.oeffentliche-exporte.md","9\u002F1",{"title":228,"icon":232},"lucide:package-open","\u002Fde\u002Fdokumentation\u002Fressourcen\u002Foeffentliche-exporte",{"title":235,"id":236,"canonicalKey":237,"locale":8,"draft":9,"navigation":238,"icon":239,"path":240},"Anforderungen und Upgrades","content:de:1.dokumentation:9.ressourcen:2.anforderungen-und-upgrades.md","9\u002F2",{"title":235,"icon":239},"lucide:refresh-cw","\u002Fde\u002Fdokumentation\u002Fressourcen\u002Fanforderungen-und-upgrades",{"title":242,"description":243,"badge":244,"date":245,"readingTime":246,"author":247,"body":273,"type":418,"id":419,"canonicalKey":25,"draft":9,"partial":9,"locale":8,"collection":420,"navigationFile":9,"file":421,"sitemap":425,"resolvedRefs":427,"route":428,"resolution":434},"Eine skalierbare Dokumentationsnavigation gestalten","Halte eine wachsende Sidebar mit Bereichen, Gruppen und klarer Seitenreihenfolge vorhersehbar.","Informationsarchitektur","2026-05-20","5 Min. Lesezeit",{"slug":248,"name":249,"role":250,"bio":251,"avatar":252,"id":253,"type":254,"title":249,"canonicalKey":255,"draft":9,"partial":9,"locale":8,"collection":256,"navigationFile":9,"file":257,"body":261,"route":262,"resolution":270},"ginko-docs-team","Ginko Docs Team","Documentation Engineering","Maintainer des Ginko-Docs-Nuxt-Layers und seiner zweisprachigen Referenz-Site.","\u002Ffavicon.svg","content:de:authors:ginko-docs-team.json","json","authors\u002Fginko-docs-team","authors",{"source":258,"path":259,"stem":260,"dir":256,"extension":254},"content","de\u002Fauthors\u002Fginko-docs-team.json","de\u002Fauthors\u002Fginko-docs-team",null,{"resolvedPath":263,"alternates":264},"\u002Fde\u002Fauthors\u002Fginko-docs-team",[265,269],{"locale":266,"path":267,"source":268},"en","\u002Fauthors\u002Fginko-docs-team","variant",{"locale":8,"path":263,"source":268},{"requested":271,"resolved":272,"usedFallback":9},{"locale":8},{"locale":8},{"type":274,"children":275,"toc":409},"root",[276,284,289,296,301,306,312,332,337,358,363,369,374,379,385,390,395],{"type":277,"tag":278,"props":279,"children":280},"element","p",{},[281],{"type":282,"value":283},"text","Leser verwenden eine Dokumentations-Sidebar für drei Fragen: Wo bin ich? Welche Seiten gehören zu diesem Thema? Wo finde ich eine andere Art von Antwort? Eine gute Struktur macht diese Antworten sichtbar, ohne jeden Ordner in ein Bedienelement zu verwandeln.",{"type":277,"tag":278,"props":285,"children":286},{},[287],{"type":282,"value":288},"Ginko Docs leitet die Sidebar aus dem Content-Baum ab. Dadurch bleiben Dateireihenfolge, öffentliche Routen, Breadcrumbs, Vor-\u002FZurück-Links und Suchnavigation aufeinander abgestimmt. Die Informationsarchitektur entsteht im Content und nicht in einem zweiten Frontend-Menü.",{"type":277,"tag":290,"props":291,"children":293},"h2",{"id":292},"beginne-mit-der-absicht-des-lesers",[294],{"type":282,"value":295},"Beginne mit der Absicht des Lesers",{"type":277,"tag":278,"props":297,"children":298},{},[299],{"type":282,"value":300},"Trenne lernorientierte Seiten von Nachschlagewerken. Ein Schnellstart führt zu einem funktionierenden Ergebnis. Ein Leitfaden erledigt eine Aufgabe. Eine Referenzseite beschreibt eine öffentliche Oberfläche vollständig.",{"type":277,"tag":278,"props":302,"children":303},{},[304],{"type":282,"value":305},"Stehen diese Seitentypen in einer ungegliederten Liste, erkennen Leser nicht, ob ein Link einen Ablauf erklärt oder eine Optionstabelle öffnet. Große Bereiche wie Dokumentation und Referenz schaffen die erste Entscheidung. Lokale Gruppen wie Inhalte, Funktionen oder Komponenten verkleinern die nächste.",{"type":277,"tag":290,"props":307,"children":309},{"id":308},"gib-jeder-ebene-eine-aufgabe",[310],{"type":282,"value":311},"Gib jeder Ebene eine Aufgabe",{"type":277,"tag":278,"props":313,"children":314},{},[315,317,323,325,330],{"type":282,"value":316},"Verwende ",{"type":277,"tag":318,"props":319,"children":320},"code",{},[321],{"type":282,"value":322},"sidebar: section",{"type":282,"value":324}," für Hauptbereiche im Bereichsumschalter. Verwende ",{"type":277,"tag":318,"props":326,"children":327},{},[328],{"type":282,"value":329},"sidebar: group",{"type":282,"value":331}," für eine sichtbare Überschrift innerhalb des aktiven Bereichs. Lasse einen normalen Ordner nur dann unmarkiert, wenn seine Kinder ein echtes verschachteltes Thema bilden, das Leser ein- und ausklappen sollen.",{"type":277,"tag":278,"props":333,"children":334},{},[335],{"type":282,"value":336},"Halte den häufigsten Pfad flach:",{"type":277,"tag":338,"props":339,"children":342},"pre",{"language":282,"filename":340,"class":341},"Navigationstiefe","shiki shiki-themes light-plus dark-plus dark:dark-plus",[343],{"type":277,"tag":318,"props":344,"children":346},{"class":345},"language-text",[347],{"type":277,"tag":348,"props":349,"children":352},"span",{"class":350,"style":351},"line","display: inline",[353],{"type":277,"tag":348,"props":354,"children":355},{},[356],{"type":282,"value":357},"Bereich → Gruppe → Seite",{"type":277,"tag":278,"props":359,"children":360},{},[361],{"type":282,"value":362},"Eine vierte Ebene kann für echte Varianten sinnvoll sein, etwa getrennte Installationen für Nuxt und Vue. Sie sollte nicht entstehen, nur weil ein zusätzlicher Quellordner bequem war.",{"type":277,"tag":290,"props":364,"children":366},{"id":365},"indexseiten-brauchen-einen-eigenen-wert",[367],{"type":282,"value":368},"Indexseiten brauchen einen eigenen Wert",{"type":277,"tag":278,"props":370,"children":371},{},[372],{"type":282,"value":373},"Eine Indexseite ist sinnvoll, wenn sie orientiert, ein gemeinsames Konzept der Unterseiten erklärt oder bei einer Auswahl hilft. Listet sie nur dieselben Links wie die Sidebar, fügt sie einen weiteren Stopp ohne neue Information hinzu.",{"type":277,"tag":278,"props":375,"children":376},{},[377],{"type":282,"value":378},"Strukturelle Gruppen benötigen keine Indexseite. Die Sidebar kann ihr Label anzeigen, während der Bereichsumschalter zur ersten echten Seite führt.",{"type":277,"tag":290,"props":380,"children":382},{"id":381},"gestalte-desktop-und-mobil-gemeinsam",[383],{"type":282,"value":384},"Gestalte Desktop und Mobil gemeinsam",{"type":277,"tag":278,"props":386,"children":387},{},[388],{"type":282,"value":389},"Auf dem Desktop können Dokumentbaum und Inhaltsverzeichnis gleichzeitig sichtbar sein. Mobil fehlt dieser Platz. Halte beide Bedienelemente getrennt: Das eine beantwortet „Welche Seite?“, das andere „Welche Überschrift auf dieser Seite?“. Eine Zusammenlegung spart einen Button, vermischt aber zwei Navigationsmodelle.",{"type":277,"tag":278,"props":391,"children":392},{},[393],{"type":282,"value":394},"Die Suche ist ein dritter Weg und kein Ersatz für Struktur. Sie hilft Lesern, die die gesuchten Begriffe bereits kennen. Die Sidebar dient weiterhin Menschen, die das Vokabular des Produkts erst lernen.",{"type":277,"tag":278,"props":396,"children":397},{},[398,400,407],{"type":282,"value":399},"Der ",{"type":277,"tag":401,"props":402,"children":404},"a",{"href":403},"$docs\u002Fauthoring\u002Fnavigation",[405],{"type":282,"value":406},"Navigationsleitfaden",{"type":282,"value":408}," beschreibt die genauen Sidecar-Metadaten. Prüfe bei Änderungen die Struktur anhand von Leseraufgaben und Scan-Tiefe – nicht danach, ob jeder Ordner irgendwo sichtbar ist.",{"title":410,"searchDepth":411,"depth":411,"links":412},"",4,[413,415,416,417],{"id":292,"depth":414,"text":295},2,{"id":308,"depth":414,"text":311},{"id":365,"depth":414,"text":368},{"id":381,"depth":414,"text":384},"markdown","content:de:2.blog:2.navigationsqualitaet.md","blog",{"source":258,"path":422,"stem":423,"dir":420,"extension":424},"de\u002F2.blog\u002F2.navigationsqualitaet.md","de\u002F2.blog\u002F2.navigationsqualitaet","md",{"lastmod":426},"2026-05-20T00:00:00.000Z",{"$docs\u002Fauthoring\u002Fnavigation":62},{"requestedPath":429,"resolvedPath":429,"alternates":430},"\u002Fde\u002Fblog\u002Fnavigationsqualitaet",[431,433],{"locale":266,"path":432,"source":268},"\u002Fblog\u002Fnavigation-quality",{"locale":8,"path":429,"source":268},{"requested":435,"resolved":436,"usedFallback":9},{"locale":8},{"locale":8},{"previous":438,"next":442},{"title":439,"id":440,"canonicalKey":7,"locale":8,"draft":9,"path":441},"Statische oder serverbasierte Docs bereitstellen","content:de:2.blog:1.statische-docs-pipeline.md","\u002Fde\u002Fblog\u002Fstatische-docs-pipeline",{"title":443,"id":444,"canonicalKey":46,"locale":8,"draft":9,"path":445},"Dokumentation für Menschen und Agenten veröffentlichen","content:de:2.blog:3.prerender-seo-suche.md","\u002Fde\u002Fblog\u002Fprerender-seo-suche",{"left":447,"top":447,"width":448,"height":448,"rotate":447,"vFlip":9,"hFlip":9,"body":449},0,24,"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M6 22a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8a2.4 2.4 0 0 1 1.704.706l3.588 3.588A2.4 2.4 0 0 1 20 8v12a2 2 0 0 1-2 2z\"\u002F>\u003Cpath d=\"M14 2v5a1 1 0 0 0 1 1h5\"\u002F>\u003C\u002Fg>",{"left":447,"top":447,"width":448,"height":448,"rotate":447,"vFlip":9,"hFlip":9,"body":451},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"8\" height=\"4\" x=\"8\" y=\"2\" rx=\"1\" ry=\"1\"\u002F>\u003Cpath d=\"M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2\"\u002F>\u003C\u002Fg>",1786539660741]