[{"data":1,"prerenderedAt":453},["ShallowReactive",2],{"docs-navigation:en":3,"content-page:blog:Fiiz5UqGxoYVVNZAkEjGVYbIJeOS6W3jxzLWyy3Edi8":242,"content-page-surround:blog:vpyeA5xhq0HcMvfD-8wNVlXUqjMvK96OWNsqeJtTToY":438,"i-lucide:file":447,"i-lucide:clipboard":451},[4,23,44,78,119,152,172,198,222],{"title":5,"id":6,"canonicalKey":7,"locale":8,"draft":9,"navigation":10,"icon":12,"sidebar":13,"path":14,"children":15},"Documentation","content:en:1.docs:1.getting-started:.navigation.yml","1","en",false,{"icon":11},"lucide:rocket","lucide:book-open","section","\u002Fdocs\u002Fgetting-started",[16],{"title":17,"id":18,"canonicalKey":19,"locale":8,"draft":9,"navigation":20,"icon":21,"path":22},"Installation","content:en:1.docs:1.getting-started:2.installation.md","1\u002F2",{"title":17,"icon":21},"lucide:download","\u002Fdocs\u002Fgetting-started\u002Finstallation",{"title":24,"page":9,"canonicalKey":25,"locale":8,"id":26,"draft":9,"icon":27,"sidebar":28,"children":29},"Concepts","2","content:en:1.docs:2.concepts:.navigation.yml","lucide:boxes","group",[30,37],{"title":31,"id":32,"canonicalKey":33,"locale":8,"draft":9,"navigation":34,"icon":35,"path":36},"How it works","content:en:1.docs:2.concepts:1.how-ginko-docs-works.md","2\u002F1",{"title":31,"icon":35},"lucide:workflow","\u002Fdocs\u002Fconcepts\u002Fhow-ginko-docs-works",{"title":38,"id":39,"canonicalKey":40,"locale":8,"draft":9,"navigation":41,"icon":42,"path":43},"Content and routes","content:en:1.docs:2.concepts:2.content-and-routes.md","2\u002F2",{"icon":42},"lucide:route","\u002Fdocs\u002Fconcepts\u002Fcontent-and-routes",{"title":45,"page":9,"canonicalKey":46,"locale":8,"id":47,"draft":9,"icon":48,"sidebar":28,"children":49},"Authoring","3","content:en:1.docs:3.authoring:.navigation.yml","lucide:pen-line",[50,57,64,71],{"title":51,"id":52,"canonicalKey":53,"locale":8,"draft":9,"navigation":54,"icon":55,"path":56},"Write content","content:en:1.docs:3.authoring:1.write-content.md","3\u002F1",{"title":51,"icon":55},"lucide:file-pen-line","\u002Fdocs\u002Fauthoring\u002Fwrite-content",{"title":58,"id":59,"canonicalKey":60,"locale":8,"draft":9,"navigation":61,"icon":62,"path":63},"Navigation","content:en:1.docs:3.authoring:2.navigation.md","3\u002F2",{"title":58,"icon":62},"lucide:panel-left","\u002Fdocs\u002Fauthoring\u002Fnavigation",{"title":65,"id":66,"canonicalKey":67,"locale":8,"draft":9,"navigation":68,"icon":69,"path":70},"Links","content:en:1.docs:3.authoring:3.links.md","3\u002F3",{"title":65,"icon":69},"lucide:link","\u002Fdocs\u002Fauthoring\u002Flinks",{"title":72,"id":73,"canonicalKey":74,"locale":8,"draft":9,"navigation":75,"icon":76,"path":77},"Use components","content:en:1.docs:3.authoring:4.use-components.md","3\u002F4",{"title":72,"icon":76},"lucide:blocks","\u002Fdocs\u002Fauthoring\u002Fuse-components",{"title":79,"page":9,"canonicalKey":80,"locale":8,"id":81,"draft":9,"icon":82,"sidebar":28,"children":83},"Features","4","content:en:1.docs:4.features:.navigation.yml","lucide:sparkles",[84,91,98,105,112],{"title":85,"id":86,"canonicalKey":87,"locale":8,"draft":9,"navigation":88,"icon":89,"path":90},"Localization","content:en:1.docs:4.features:1.localization.md","4\u002F1",{"title":85},"lucide:languages","\u002Fdocs\u002Ffeatures\u002Flocalization",{"title":92,"id":93,"canonicalKey":94,"locale":8,"draft":9,"navigation":95,"icon":96,"path":97},"Search","content:en:1.docs:4.features:2.search.md","4\u002F2",{"title":92},"lucide:search","\u002Fdocs\u002Ffeatures\u002Fsearch",{"title":99,"id":100,"canonicalKey":101,"locale":8,"draft":9,"navigation":102,"icon":103,"path":104},"Blog","content:en:1.docs:4.features:3.blog.md","4\u002F3",{"title":99},"lucide:newspaper","\u002Fdocs\u002Ffeatures\u002Fblog",{"title":106,"id":107,"canonicalKey":108,"locale":8,"draft":9,"navigation":109,"icon":110,"path":111},"SEO and social cards","content:en:1.docs:4.features:4.seo-and-social-cards.md","4\u002F4",{"title":106},"lucide:globe-2","\u002Fdocs\u002Ffeatures\u002Fseo-and-social-cards",{"title":113,"id":114,"canonicalKey":115,"locale":8,"draft":9,"navigation":116,"icon":117,"path":118},"Agent-readable output","content:en:1.docs:4.features:5.agent-readable-output.md","4\u002F5",{"title":113},"lucide:bot","\u002Fdocs\u002Ffeatures\u002Fagent-readable-output",{"title":120,"page":9,"canonicalKey":121,"locale":8,"id":122,"draft":9,"icon":123,"sidebar":28,"children":124},"Customization","5","content:en:1.docs:5.customization:.navigation.yml","lucide:paintbrush",[125,132,139,146],{"title":126,"id":127,"canonicalKey":128,"locale":8,"draft":9,"navigation":129,"icon":130,"path":131},"Site configuration","content:en:1.docs:5.customization:1.site-configuration.md","5\u002F1",{"title":126},"lucide:settings-2","\u002Fdocs\u002Fcustomization\u002Fsite-configuration",{"title":133,"id":134,"canonicalKey":135,"locale":8,"draft":9,"navigation":136,"icon":137,"path":138},"Landing page","content:en:1.docs:5.customization:2.landing-page.md","5\u002F2",{"title":133},"lucide:layout-template","\u002Fdocs\u002Fcustomization\u002Flanding-page",{"title":140,"id":141,"canonicalKey":142,"locale":8,"draft":9,"navigation":143,"icon":144,"path":145},"Theming and overrides","content:en:1.docs:5.customization:3.theming-and-overrides.md","5\u002F3",{"title":140},"lucide:palette","\u002Fdocs\u002Fcustomization\u002Ftheming-and-overrides",{"title":147,"id":148,"canonicalKey":149,"locale":8,"draft":9,"navigation":150,"icon":76,"path":151},"Custom components","content:en:1.docs:5.customization:4.custom-components.md","5\u002F4",{"title":147},"\u002Fdocs\u002Fcustomization\u002Fcustom-components",{"title":153,"page":9,"canonicalKey":154,"locale":8,"id":155,"draft":9,"icon":156,"sidebar":28,"children":157},"Operations","6","content:en:1.docs:6.operations:.navigation.yml","lucide:cloud-cog",[158,165],{"title":159,"id":160,"canonicalKey":161,"locale":8,"draft":9,"navigation":162,"icon":163,"path":164},"Deployment","content:en:1.docs:6.operations:1.deployment.md","6\u002F1",{"title":159,"icon":163},"lucide:cloud-upload","\u002Fdocs\u002Foperations\u002Fdeployment",{"title":166,"id":167,"canonicalKey":168,"locale":8,"draft":9,"navigation":169,"icon":170,"path":171},"Troubleshooting","content:en:1.docs:6.operations:2.troubleshooting.md","6\u002F2",{"title":166,"icon":170},"lucide:wrench","\u002Fdocs\u002Foperations\u002Ftroubleshooting",{"title":173,"page":9,"canonicalKey":174,"locale":8,"id":175,"draft":9,"icon":176,"sidebar":13,"children":177},"Reference","7","content:en:1.docs:7.reference:.navigation.yml","lucide:braces",[178,185,191],{"title":179,"id":180,"canonicalKey":181,"locale":8,"draft":9,"navigation":182,"icon":183,"path":184},"Content configuration","content:en:1.docs:7.reference:1.content-config.md","7\u002F1",{"title":179,"icon":183},"lucide:database","\u002Fdocs\u002Freference\u002Fcontent-config",{"title":186,"id":187,"canonicalKey":188,"locale":8,"draft":9,"navigation":189,"icon":130,"path":190},"App configuration","content:en:1.docs:7.reference:2.app-config.md","7\u002F2",{"title":186,"icon":130},"\u002Fdocs\u002Freference\u002Fapp-config",{"title":192,"id":193,"canonicalKey":194,"locale":8,"draft":9,"navigation":195,"icon":196,"path":197},"Frontmatter and schemas","content:en:1.docs:7.reference:3.frontmatter.md","7\u002F3",{"title":192,"icon":196},"lucide:file-json-2","\u002Fdocs\u002Freference\u002Ffrontmatter",{"title":199,"page":9,"canonicalKey":200,"locale":8,"id":201,"draft":9,"icon":76,"sidebar":28,"children":202},"Components","8","content:en:1.docs:8.components:.navigation.yml",[203,209,216],{"title":204,"id":205,"canonicalKey":206,"locale":8,"draft":9,"navigation":207,"icon":76,"path":208},"MDC components","content:en:1.docs:8.components:1.mdc-components.md","8\u002F1",{"title":204,"icon":76},"\u002Fdocs\u002Fcomponents\u002Fmdc-components",{"title":210,"id":211,"canonicalKey":212,"locale":8,"draft":9,"navigation":213,"icon":214,"path":215},"API reference panels","content:en:1.docs:8.components:2.api-reference.md","8\u002F2",{"title":210,"icon":214},"lucide:table-properties","\u002Fdocs\u002Fcomponents\u002Fapi-reference",{"title":217,"id":218,"canonicalKey":219,"locale":8,"draft":9,"navigation":220,"icon":76,"path":221},"Component showcase","content:en:1.docs:8.components:3.component-showcase.md","8\u002F3",{"title":217,"icon":76},"\u002Fdocs\u002Fcomponents\u002Fcomponent-showcase",{"title":223,"page":9,"canonicalKey":224,"locale":8,"id":225,"draft":9,"icon":226,"sidebar":28,"children":227},"Resources","9","content:en:1.docs:9.resources:.navigation.yml","lucide:library",[228,235],{"title":229,"id":230,"canonicalKey":231,"locale":8,"draft":9,"navigation":232,"icon":233,"path":234},"Public exports","content:en:1.docs:9.resources:1.public-exports.md","9\u002F1",{"title":229,"icon":233},"lucide:package-open","\u002Fdocs\u002Fresources\u002Fpublic-exports",{"title":236,"id":237,"canonicalKey":238,"locale":8,"draft":9,"navigation":239,"icon":240,"path":241},"Requirements and upgrades","content:en:1.docs:9.resources:2.requirements-and-upgrades.md","9\u002F2",{"title":236,"icon":240},"lucide:refresh-cw","\u002Fdocs\u002Fresources\u002Frequirements-and-upgrades",{"title":243,"description":244,"badge":245,"date":246,"readingTime":247,"author":248,"body":274,"type":419,"id":420,"canonicalKey":25,"draft":9,"partial":9,"locale":8,"collection":421,"navigationFile":9,"file":422,"sitemap":426,"resolvedRefs":428,"route":429,"resolution":435},"Design documentation navigation that scales","Use sections, groups, and page order to keep a growing sidebar predictable.","Information architecture","2026-05-20","5 min read",{"slug":249,"name":250,"role":251,"bio":252,"avatar":253,"id":254,"type":255,"title":250,"canonicalKey":256,"draft":9,"partial":9,"locale":8,"collection":257,"navigationFile":9,"file":258,"body":262,"route":263,"resolution":271},"ginko-docs-team","Ginko Docs Team","Documentation engineering","Maintainers of the Ginko Docs Nuxt layer and its bilingual reference site.","\u002Ffavicon.svg","content:en:authors:ginko-docs-team.json","json","authors\u002Fginko-docs-team","authors",{"source":259,"path":260,"stem":261,"dir":257,"extension":255},"content","en\u002Fauthors\u002Fginko-docs-team.json","en\u002Fauthors\u002Fginko-docs-team",null,{"resolvedPath":264,"alternates":265},"\u002Fauthors\u002Fginko-docs-team",[266,268],{"locale":8,"path":264,"source":267},"variant",{"locale":269,"path":270,"source":267},"de","\u002Fde\u002Fauthors\u002Fginko-docs-team",{"requested":272,"resolved":273,"usedFallback":9},{"locale":8},{"locale":8},{"type":275,"children":276,"toc":410},"root",[277,285,290,297,302,307,313,333,338,359,364,370,375,380,386,391,396],{"type":278,"tag":279,"props":280,"children":281},"element","p",{},[282],{"type":283,"value":284},"text","Readers use a documentation sidebar to answer three questions: Where am I? What sits beside this page? Where should I look for a different kind of answer? A useful structure makes those answers visible without turning every folder into a control.",{"type":278,"tag":279,"props":286,"children":287},{},[288],{"type":283,"value":289},"Ginko Docs derives the sidebar from the content tree. That keeps file order, public routes, breadcrumbs, previous and next links, and search navigation aligned. The design work therefore happens in the content structure, not in a second frontend menu.",{"type":278,"tag":291,"props":292,"children":294},"h2",{"id":293},"start-with-reader-intent",[295],{"type":283,"value":296},"Start with reader intent",{"type":278,"tag":279,"props":298,"children":299},{},[300],{"type":283,"value":301},"Separate pages that teach from pages that list. A quickstart should lead to a working result. A guide should complete one task. A reference page should describe one public surface exhaustively.",{"type":278,"tag":279,"props":303,"children":304},{},[305],{"type":283,"value":306},"When these page types share an undifferentiated list, readers cannot tell whether a link will teach a workflow or present an option table. Broad sections such as Documentation and Reference provide that first decision. Local groups such as Authoring, Features, or Components make the next decision smaller.",{"type":278,"tag":291,"props":308,"children":310},{"id":309},"give-each-level-one-job",[311],{"type":283,"value":312},"Give each level one job",{"type":278,"tag":279,"props":314,"children":315},{},[316,318,324,326,331],{"type":283,"value":317},"Use ",{"type":278,"tag":319,"props":320,"children":321},"code",{},[322],{"type":283,"value":323},"sidebar: section",{"type":283,"value":325}," for the major areas shown by the section switcher. Use ",{"type":278,"tag":319,"props":327,"children":328},{},[329],{"type":283,"value":330},"sidebar: group",{"type":283,"value":332}," for a visible heading within the current section. Leave an ordinary folder unmarked only when its children form a real nested topic that readers should expand and collapse.",{"type":278,"tag":279,"props":334,"children":335},{},[336],{"type":283,"value":337},"Keep the common path shallow:",{"type":278,"tag":339,"props":340,"children":343},"pre",{"language":283,"filename":341,"class":342},"Navigation depth","shiki shiki-themes light-plus dark-plus dark:dark-plus",[344],{"type":278,"tag":319,"props":345,"children":347},{"class":346},"language-text",[348],{"type":278,"tag":349,"props":350,"children":353},"span",{"class":351,"style":352},"line","display: inline",[354],{"type":278,"tag":349,"props":355,"children":356},{},[357],{"type":283,"value":358},"section → group → page",{"type":278,"tag":279,"props":360,"children":361},{},[362],{"type":283,"value":363},"A fourth level can be useful for genuine variants, such as separate Nuxt and Vue installation instructions. It should not exist only because the source files were convenient to store in another folder.",{"type":278,"tag":291,"props":365,"children":367},{"id":366},"make-index-pages-earn-their-route",[368],{"type":283,"value":369},"Make index pages earn their route",{"type":278,"tag":279,"props":371,"children":372},{},[373],{"type":283,"value":374},"An index page is useful when it orients the reader, defines a concept shared by its children, or helps someone choose among several paths. An index page that only lists the same links already visible in the sidebar adds another stop without adding information.",{"type":278,"tag":279,"props":376,"children":377},{},[378],{"type":283,"value":379},"Structural groups do not need an index page. The sidebar can show the label while the section switcher resolves to the first real page.",{"type":278,"tag":291,"props":381,"children":383},{"id":382},"design-desktop-and-mobile-together",[384],{"type":283,"value":385},"Design desktop and mobile together",{"type":278,"tag":279,"props":387,"children":388},{},[389],{"type":283,"value":390},"Desktop has room for the document tree and the current page's table of contents at the same time. Mobile does not. Keep those controls separate: one answers “Which page?” and the other answers “Which heading on this page?” Combining them saves one button but mixes two navigation models.",{"type":278,"tag":279,"props":392,"children":393},{},[394],{"type":283,"value":395},"Search is a third path, not a replacement for structure. It helps readers who know the words they want. The sidebar still serves readers who are learning the vocabulary of the product.",{"type":278,"tag":279,"props":397,"children":398},{},[399,401,408],{"type":283,"value":400},"The ",{"type":278,"tag":402,"props":403,"children":405},"a",{"href":404},"$docs\u002Fauthoring\u002Fnavigation",[406],{"type":283,"value":407},"navigation guide",{"type":283,"value":409}," describes the exact sidecar metadata. When the corpus changes, review the structure by reader task and scan depth—not by whether every folder appears somewhere on screen.",{"title":411,"searchDepth":412,"depth":412,"links":413},"",4,[414,416,417,418],{"id":293,"depth":415,"text":296},2,{"id":309,"depth":415,"text":312},{"id":366,"depth":415,"text":369},{"id":382,"depth":415,"text":385},"markdown","content:en:2.blog:2.navigation-quality.md","blog",{"source":259,"path":423,"stem":424,"dir":421,"extension":425},"en\u002F2.blog\u002F2.navigation-quality.md","en\u002F2.blog\u002F2.navigation-quality","md",{"lastmod":427},"2026-05-20T00:00:00.000Z",{"$docs\u002Fauthoring\u002Fnavigation":63},{"requestedPath":430,"resolvedPath":430,"alternates":431},"\u002Fblog\u002Fnavigation-quality",[432,433],{"locale":8,"path":430,"source":267},{"locale":269,"path":434,"source":267},"\u002Fde\u002Fblog\u002Fnavigationsqualitaet",{"requested":436,"resolved":437,"usedFallback":9},{"locale":8},{"locale":8},{"previous":439,"next":443},{"title":440,"id":441,"canonicalKey":7,"locale":8,"draft":9,"path":442},"Choose a static or server deployment for your docs","content:en:2.blog:1.static-docs-pipeline.md","\u002Fblog\u002Fstatic-docs-pipeline",{"title":444,"id":445,"canonicalKey":46,"locale":8,"draft":9,"path":446},"Publish documentation for humans and agents","content:en:2.blog:3.prerender-seo-search.md","\u002Fblog\u002Fprerender-seo-search",{"left":448,"top":448,"width":449,"height":449,"rotate":448,"vFlip":9,"hFlip":9,"body":450},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":448,"top":448,"width":449,"height":449,"rotate":448,"vFlip":9,"hFlip":9,"body":452},"\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>",1786530423457]