[{"data":1,"prerenderedAt":459},["ShallowReactive",2],{"docs-navigation:en":3,"content-page-surround:blog:0mI5krwGEy4WLN7RUU7eHXuEl8kPc8G2JyMP00GYqS4":242,"content-page:blog:lYPUr32V3gBprNvk1vd922Qh29rVRfhkH3GqOojSyP8":248},[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",{"previous":243,"next":247},{"title":244,"id":245,"canonicalKey":46,"locale":8,"draft":9,"path":246},"Publish documentation for humans and agents","content:en:2.blog:3.prerender-seo-search.md","\u002Fblog\u002Fprerender-seo-search",null,{"title":249,"description":250,"badge":251,"date":252,"readingTime":253,"author":254,"body":279,"type":441,"id":442,"canonicalKey":80,"draft":9,"partial":9,"locale":8,"collection":443,"navigationFile":9,"file":444,"sitemap":448,"route":450,"resolution":456},"Use images without breaking the reading flow","Choose Markdown images, figures, dimensions, captions, and bleed from the image's role in the article.","Images","2026-06-02","6 min read",{"slug":255,"name":256,"role":257,"bio":258,"avatar":259,"id":260,"type":261,"title":256,"canonicalKey":262,"draft":9,"partial":9,"locale":8,"collection":263,"navigationFile":9,"file":264,"body":247,"route":268,"resolution":276},"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":265,"path":266,"stem":267,"dir":263,"extension":261},"content","en\u002Fauthors\u002Fginko-docs-team.json","en\u002Fauthors\u002Fginko-docs-team",{"resolvedPath":269,"alternates":270},"\u002Fauthors\u002Fginko-docs-team",[271,273],{"locale":8,"path":269,"source":272},"variant",{"locale":274,"path":275,"source":272},"de","\u002Fde\u002Fauthors\u002Fginko-docs-team",{"requested":277,"resolved":278,"usedFallback":9},{"locale":8},{"locale":8},{"type":280,"children":281,"toc":432},"root",[282,290,303,310,315,324,329,335,340,349,381,387,392,400,405,411,416,421],{"type":283,"tag":284,"props":285,"children":286},"element","p",{},[287],{"type":288,"value":289},"text","An image earns its place in documentation when it explains a state, sequence, relationship, or result faster than prose. Its presentation should follow that job. A screenshot that supports one sentence needs a different treatment from a diagram readers must inspect closely.",{"type":283,"tag":284,"props":291,"children":292},{},[293,295,301],{"type":288,"value":294},"Ginko Docs renders ordinary Markdown images through Nuxt Image and can add click-to-zoom behavior. The ",{"type":283,"tag":296,"props":297,"children":298},"code",{},[299],{"type":288,"value":300},"figure",{"type":288,"value":302}," component adds explicit dimensions, a caption, aspect-ratio control, and optional bleed without requiring a page-specific Vue template.",{"type":283,"tag":304,"props":305,"children":307},"h2",{"id":306},"use-markdown-for-an-image-in-the-reading-flow",[308],{"type":288,"value":309},"Use Markdown for an image in the reading flow",{"type":283,"tag":284,"props":311,"children":312},{},[313],{"type":288,"value":314},"Use standard image syntax when the surrounding paragraph already supplies the context and the image does not need a caption.",{"type":283,"tag":284,"props":316,"children":317},{},[318],{"type":283,"tag":319,"props":320,"children":323},"img",{"src":321,"alt":322},"\u002Fimages\u002Fcontent-demo-workspace.jpg","Bright workspace prepared for an editorial planning session",[],{"type":283,"tag":284,"props":325,"children":326},{},[327],{"type":288,"value":328},"Write alt text for the information a reader needs from the image. Do not repeat “image of” or use the filename. If the image is decorative and carries no information, use empty alt text rather than inventing a description.",{"type":283,"tag":304,"props":330,"children":332},{"id":331},"use-a-figure-for-a-caption-and-stable-geometry",[333],{"type":288,"value":334},"Use a figure for a caption and stable geometry",{"type":283,"tag":284,"props":336,"children":337},{},[338],{"type":288,"value":339},"Add a figure when the caption contributes meaning or when you need explicit dimensions to prevent layout shift.",{"type":283,"tag":300,"props":341,"children":348},{"src":342,"alt":343,"caption":344,"width":345,"height":346,"aspect":347},"\u002Fimages\u002Fcontent-demo-detail.png","Detailed planning material arranged for a website content session","A caption can identify the state or decision the reader should notice.","1200","800","video",[],{"type":283,"tag":284,"props":350,"children":351},{},[352,354,359,361,366,368,373,374,379],{"type":288,"value":353},"The ",{"type":283,"tag":296,"props":355,"children":356},{},[357],{"type":288,"value":358},"width",{"type":288,"value":360}," and ",{"type":283,"tag":296,"props":362,"children":363},{},[364],{"type":288,"value":365},"height",{"type":288,"value":367}," props describe the source image. They let the browser reserve the correct space before the file loads. The ",{"type":283,"tag":296,"props":369,"children":370},{},[371],{"type":288,"value":372},"aspect",{"type":288,"value":360},{"type":283,"tag":296,"props":375,"children":376},{},[377],{"type":288,"value":378},"fit",{"type":288,"value":380}," props control presentation; they should not compensate for an incorrectly cropped source asset.",{"type":283,"tag":304,"props":382,"children":384},{"id":383},"reserve-bleed-for-important-detail",[385],{"type":288,"value":386},"Reserve bleed for important detail",{"type":283,"tag":284,"props":388,"children":389},{},[390],{"type":288,"value":391},"A wider figure can help with dense diagrams, comparison screenshots, or editorial photography that loses useful detail inside the text measure.",{"type":283,"tag":300,"props":393,"children":399},{"src":394,"alt":395,"caption":396,"width":345,"height":397,"bleed":398,"aspect":347},"\u002Fimages\u002Fcontent-demo-workshop.jpg","Workshop table with notes for a multilingual documentation launch","A controlled bleed adds inspection space on wide screens while returning to the content width on mobile.","900","outside",[],{"type":283,"tag":284,"props":401,"children":402},{},[403],{"type":288,"value":404},"Do not use bleed as decoration on every page. Repeated width changes interrupt scanning and make ordinary screenshots look more important than the instructions around them.",{"type":283,"tag":304,"props":406,"children":408},{"id":407},"keep-text-and-media-in-sync",[409],{"type":288,"value":410},"Keep text and media in sync",{"type":283,"tag":284,"props":412,"children":413},{},[414],{"type":288,"value":415},"Place an image after the sentence that introduces it. Explain the conclusion in text as well; a screenshot should not be the only place a required value or error message appears. Update screenshots when labels, routes, or defaults change.",{"type":283,"tag":284,"props":417,"children":418},{},[419],{"type":288,"value":420},"For zoomable images, make sure the reduced view still exposes the main subject and the original asset is sharp enough to inspect. A larger blurred screenshot does not become more useful when opened in a dialog.",{"type":283,"tag":284,"props":422,"children":423},{},[424,426,430],{"type":288,"value":425},"The final asset should have a stable public path, meaningful alt text, intrinsic dimensions when using ",{"type":283,"tag":296,"props":427,"children":428},{},[429],{"type":288,"value":300},{"type":288,"value":431},", and a caption only when the caption adds information not already present in the paragraph.",{"title":433,"searchDepth":434,"depth":434,"links":435},"",4,[436,438,439,440],{"id":306,"depth":437,"text":309},2,{"id":331,"depth":437,"text":334},{"id":383,"depth":437,"text":386},{"id":407,"depth":437,"text":410},"markdown","content:en:2.blog:4.editorial-image-systems.md","blog",{"source":265,"path":445,"stem":446,"dir":443,"extension":447},"en\u002F2.blog\u002F4.editorial-image-systems.md","en\u002F2.blog\u002F4.editorial-image-systems","md",{"lastmod":449},"2026-06-02T00:00:00.000Z",{"requestedPath":451,"resolvedPath":451,"alternates":452},"\u002Fblog\u002Feditorial-image-systems",[453,454],{"locale":8,"path":451,"source":272},{"locale":274,"path":455,"source":272},"\u002Fde\u002Fblog\u002Fredaktionelle-bildstrecken",{"requested":457,"resolved":458,"usedFallback":9},{"locale":8},{"locale":8},1786530425253]