[{"data":1,"prerenderedAt":901},["ShallowReactive",2],{"navigation_docs_en":3,"-en-concepts-internationalization":120,"-en-concepts-internationalization-surround":896},[4,40,75,100],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":6},"Getting Started",false,"/en/getting-started","en/1.getting-started",[10,15,20,25,30,35],{"title":11,"path":12,"stem":13,"icon":14},"Introduction","/en/getting-started/introduction","en/1.getting-started/2.introduction","i-lucide-house",{"title":16,"path":17,"stem":18,"icon":19},"Installation","/en/getting-started/installation","en/1.getting-started/3.installation","i-lucide-download",{"title":21,"path":22,"stem":23,"icon":24},"Project Structure","/en/getting-started/project-structure","en/1.getting-started/4.project-structure","i-lucide-folder-tree",{"title":26,"path":27,"stem":28,"icon":29},"Studio module","/en/getting-started/studio","en/1.getting-started/5.studio","i-lucide-mouse-pointer-2",{"title":31,"path":32,"stem":33,"icon":34},"Migration","/en/getting-started/migration","en/1.getting-started/6.migration","i-lucide-replace",{"title":36,"path":37,"stem":38,"icon":39},"Troubleshooting","/en/getting-started/troubleshooting","en/1.getting-started/7.troubleshooting","i-lucide-wrench",{"title":41,"path":42,"stem":43,"children":44,"page":6},"Core Concepts","/en/concepts","en/2.concepts",[45,50,55,60,65,70],{"title":46,"path":47,"stem":48,"icon":49},"Edition","/en/concepts/edition","en/2.concepts/2.edition","i-lucide-pencil",{"title":51,"path":52,"stem":53,"icon":54},"Configuration","/en/concepts/configuration","en/2.concepts/3.configuration","i-lucide-settings",{"title":56,"path":57,"stem":58,"icon":59},"Theme","/en/concepts/theme","en/2.concepts/4.theme","i-lucide-paint-roller",{"title":61,"path":62,"stem":63,"icon":64},"Customization","/en/concepts/customization","en/2.concepts/5.customization","i-lucide-pen-tool",{"title":66,"path":67,"stem":68,"icon":69},"Internationalization","/en/concepts/internationalization","en/2.concepts/6.internationalization","i-lucide-globe",{"title":71,"path":72,"stem":73,"icon":74},"Nuxt","/en/concepts/nuxt","en/2.concepts/8.nuxt","i-simple-icons-nuxt",{"title":76,"path":77,"stem":78,"children":79,"page":6},"Essentials","/en/essentials","en/3.essentials",[80,85,90,95],{"title":81,"path":82,"stem":83,"icon":84},"Markdown Syntax","/en/essentials/markdown-syntax","en/3.essentials/1.markdown-syntax","i-lucide-heading-1",{"title":86,"path":87,"stem":88,"icon":89},"Code Blocks","/en/essentials/code-blocks","en/3.essentials/2.code-blocks","i-lucide-code-xml",{"title":91,"path":92,"stem":93,"icon":94},"Components","/en/essentials/components","en/3.essentials/3.components","i-lucide-component",{"title":96,"path":97,"stem":98,"icon":99},"Images and Embeds","/en/essentials/images-embeds","en/3.essentials/4.images-embeds","i-lucide-image",{"title":101,"path":102,"stem":103,"children":104,"page":6},"AI","/en/ai","en/4.ai",[105,110,115],{"title":106,"path":107,"stem":108,"icon":109},"Assistant","/en/ai/assistant","en/4.ai/1.assistant","i-lucide-sparkles",{"title":111,"path":112,"stem":113,"icon":114},"MCP Server","/en/ai/mcp","en/4.ai/2.mcp","i-lucide-cpu",{"title":116,"path":117,"stem":118,"icon":119},"LLMs Integration","/en/ai/llms","en/4.ai/3.llms","i-lucide-message-circle-code",{"id":121,"title":66,"body":122,"description":888,"extension":889,"links":890,"meta":891,"navigation":892,"path":67,"seo":893,"stem":68,"__hash__":895},"docs_en/en/2.concepts/6.internationalization.md",{"type":123,"value":124,"toc":878},"minimark",[125,139,144,191,195,204,290,294,300,305,315,476,487,491,494,520,524,531,688,691,695,701,708,711,812,818,857,863,874],[126,127,128,129,133,134,138],"p",{},"Docus v4 introduces ",[130,131,132],"strong",{},"native internationalization support"," based on the ",[135,136,137],"code",{},"@nuxtjs/i18n"," module, allowing you to create documentation in multiple languages with automatic routing and content management.",[140,141,143],"h2",{"id":142},"features","Features",[145,146,147,156,170,176,182],"ul",{},[148,149,150,153,154],"li",{},[130,151,152],{},"Built-in i18n module",": Native integration with ",[135,155,137],{},[148,157,158,161,162,165,166,169],{},[130,159,160],{},"Dynamic locale routing",": Automatic URL prefixing with language codes (",[135,163,164],{},"/en/docs",", ",[135,167,168],{},"/fr/docs",")",[148,171,172,175],{},[130,173,174],{},"Content collections per locale",": Separate content management for each language",[148,177,178,181],{},[130,179,180],{},"Language switcher",": Built-in component for switching between locales",[148,183,184,187,188],{},[130,185,186],{},"Single-language configuration",": Simple locale configuration for single-language sites via ",[135,189,190],{},"app.config.ts",[140,192,194],{"id":193},"single-language-configuration","Single Language Configuration",[126,196,197,198,200,201,203],{},"If you're building documentation in a single language (without the full ",[135,199,137],{}," module), you can configure the locale through ",[135,202,190],{},". This is useful for setting the language for UI components and localizing built-in strings.",[205,206,211],"pre",{"className":207,"code":208,"filename":190,"language":209,"meta":210,"style":210},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineAppConfig({\n  docus: {\n    locale: 'fr', // Set your locale (default: 'en')\n  }\n})\n","ts","",[135,212,213,237,250,275,281],{"__ignoreMap":210},[214,215,218,222,225,229,233],"span",{"class":216,"line":217},"line",1,[214,219,221],{"class":220},"s7zQu","export",[214,223,224],{"class":220}," default",[214,226,228],{"class":227},"s2Zo4"," defineAppConfig",[214,230,232],{"class":231},"sTEyZ","(",[214,234,236],{"class":235},"sMK4o","{\n",[214,238,240,244,247],{"class":216,"line":239},2,[214,241,243],{"class":242},"swJcz","  docus",[214,245,246],{"class":235},":",[214,248,249],{"class":235}," {\n",[214,251,253,256,258,261,265,268,271],{"class":216,"line":252},3,[214,254,255],{"class":242},"    locale",[214,257,246],{"class":235},[214,259,260],{"class":235}," '",[214,262,264],{"class":263},"sfazB","fr",[214,266,267],{"class":235},"'",[214,269,270],{"class":235},",",[214,272,274],{"class":273},"sHwdD"," // Set your locale (default: 'en')\n",[214,276,278],{"class":216,"line":277},4,[214,279,280],{"class":235},"  }\n",[214,282,284,287],{"class":216,"line":283},5,[214,285,286],{"class":235},"}",[214,288,289],{"class":231},")\n",[140,291,293],{"id":292},"multi-language-setup","Multi-Language Setup",[126,295,296,297,299],{},"For multi-language documentation, use the full ",[135,298,137],{}," integration as described below.",[301,302,304],"h3",{"id":303},"setup-an-existing-project","Setup an existing project",[126,306,307,308,310,311,314],{},"To enable i18n in your Docus project, add the ",[135,309,137],{}," module to your ",[135,312,313],{},"nuxt.config.ts"," and define your locales:",[205,316,320],{"className":317,"code":318,"filename":313,"language":319,"meta":210,"style":210},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export default defineNuxtConfig({\n  modules: ['@nuxtjs/i18n'],\n  i18n: {\n    defaultLocale: 'en',\n    locales: [\n      { code: 'en', name: 'English' },\n      { code: 'fr', name: 'Français' },\n    ],\n  }\n})\n","typescript",[135,321,322,335,357,366,382,392,426,456,464,469],{"__ignoreMap":210},[214,323,324,326,328,331,333],{"class":216,"line":217},[214,325,221],{"class":220},[214,327,224],{"class":220},[214,329,330],{"class":227}," defineNuxtConfig",[214,332,232],{"class":231},[214,334,236],{"class":235},[214,336,337,340,342,345,347,349,351,354],{"class":216,"line":239},[214,338,339],{"class":242},"  modules",[214,341,246],{"class":235},[214,343,344],{"class":231}," [",[214,346,267],{"class":235},[214,348,137],{"class":263},[214,350,267],{"class":235},[214,352,353],{"class":231},"]",[214,355,356],{"class":235},",\n",[214,358,359,362,364],{"class":216,"line":252},[214,360,361],{"class":242},"  i18n",[214,363,246],{"class":235},[214,365,249],{"class":235},[214,367,368,371,373,375,378,380],{"class":216,"line":277},[214,369,370],{"class":242},"    defaultLocale",[214,372,246],{"class":235},[214,374,260],{"class":235},[214,376,377],{"class":263},"en",[214,379,267],{"class":235},[214,381,356],{"class":235},[214,383,384,387,389],{"class":216,"line":283},[214,385,386],{"class":242},"    locales",[214,388,246],{"class":235},[214,390,391],{"class":231}," [\n",[214,393,395,398,401,403,405,407,409,411,414,416,418,421,423],{"class":216,"line":394},6,[214,396,397],{"class":235},"      {",[214,399,400],{"class":242}," code",[214,402,246],{"class":235},[214,404,260],{"class":235},[214,406,377],{"class":263},[214,408,267],{"class":235},[214,410,270],{"class":235},[214,412,413],{"class":242}," name",[214,415,246],{"class":235},[214,417,260],{"class":235},[214,419,420],{"class":263},"English",[214,422,267],{"class":235},[214,424,425],{"class":235}," },\n",[214,427,429,431,433,435,437,439,441,443,445,447,449,452,454],{"class":216,"line":428},7,[214,430,397],{"class":235},[214,432,400],{"class":242},[214,434,246],{"class":235},[214,436,260],{"class":235},[214,438,264],{"class":263},[214,440,267],{"class":235},[214,442,270],{"class":235},[214,444,413],{"class":242},[214,446,246],{"class":235},[214,448,260],{"class":235},[214,450,451],{"class":263},"Français",[214,453,267],{"class":235},[214,455,425],{"class":235},[214,457,459,462],{"class":216,"line":458},8,[214,460,461],{"class":231},"    ]",[214,463,356],{"class":235},[214,465,467],{"class":216,"line":466},9,[214,468,280],{"class":235},[214,470,472,474],{"class":216,"line":471},10,[214,473,286],{"class":235},[214,475,289],{"class":231},[477,478,479,480,482,483,486],"warning",{},"Docus overrides the ",[135,481,137],{}," strategy to ",[135,484,485],{},"prefix",".",[140,488,490],{"id":489},"create-a-new-project-with-i18n-template","Create a new project with i18n template",[126,492,493],{},"When creating a new project, you can choose the i18n template for pre-configured internationalization:",[205,495,500],{"className":496,"code":497,"filename":498,"language":499,"meta":210,"style":210},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npx create-docus my-docs -t i18n\n","Terminal","bash",[135,501,502],{"__ignoreMap":210},[214,503,504,508,511,514,517],{"class":216,"line":217},[214,505,507],{"class":506},"sBMFI","npx",[214,509,510],{"class":263}," create-docus",[214,512,513],{"class":263}," my-docs",[214,515,516],{"class":263}," -t",[214,518,519],{"class":263}," i18n\n",[140,521,523],{"id":522},"directory-structure","Directory Structure",[126,525,526,527,530],{},"When i18n is enabled, organize your content by locale in the ",[135,528,529],{},"content/"," directory:",[205,532,534],{"className":496,"code":533,"language":499,"meta":210,"style":210},"content/\n├── en/                    # English content\n│   ├── index.md          # English homepage\n│   ├── getting-started/\n│   │   ├── installation.md\n│   │   └── configuration.md\n│   └── guide/\n│       └── advanced.md\n├── fr/                    # French content\n│   ├── index.md          # French homepage\n│   ├── getting-started/\n│   │   ├── installation.md\n│   │   └── configuration.md\n│   └── guide/\n│       └── advanced.md\n",[135,535,536,541,552,566,575,587,599,608,618,628,639,648,659,670,679],{"__ignoreMap":210},[214,537,538],{"class":216,"line":217},[214,539,540],{"class":506},"content/\n",[214,542,543,546,549],{"class":216,"line":239},[214,544,545],{"class":506},"├──",[214,547,548],{"class":263}," en/",[214,550,551],{"class":273},"                    # English content\n",[214,553,554,557,560,563],{"class":216,"line":252},[214,555,556],{"class":506},"│",[214,558,559],{"class":263},"   ├──",[214,561,562],{"class":263}," index.md",[214,564,565],{"class":273},"          # English homepage\n",[214,567,568,570,572],{"class":216,"line":277},[214,569,556],{"class":506},[214,571,559],{"class":263},[214,573,574],{"class":263}," getting-started/\n",[214,576,577,579,582,584],{"class":216,"line":283},[214,578,556],{"class":506},[214,580,581],{"class":263},"   │",[214,583,559],{"class":263},[214,585,586],{"class":263}," installation.md\n",[214,588,589,591,593,596],{"class":216,"line":394},[214,590,556],{"class":506},[214,592,581],{"class":263},[214,594,595],{"class":263},"   └──",[214,597,598],{"class":263}," configuration.md\n",[214,600,601,603,605],{"class":216,"line":428},[214,602,556],{"class":506},[214,604,595],{"class":263},[214,606,607],{"class":263}," guide/\n",[214,609,610,612,615],{"class":216,"line":458},[214,611,556],{"class":506},[214,613,614],{"class":263},"       └──",[214,616,617],{"class":263}," advanced.md\n",[214,619,620,622,625],{"class":216,"line":466},[214,621,545],{"class":506},[214,623,624],{"class":263}," fr/",[214,626,627],{"class":273},"                    # French content\n",[214,629,630,632,634,636],{"class":216,"line":471},[214,631,556],{"class":506},[214,633,559],{"class":263},[214,635,562],{"class":263},[214,637,638],{"class":273},"          # French homepage\n",[214,640,642,644,646],{"class":216,"line":641},11,[214,643,556],{"class":506},[214,645,559],{"class":263},[214,647,574],{"class":263},[214,649,651,653,655,657],{"class":216,"line":650},12,[214,652,556],{"class":506},[214,654,581],{"class":263},[214,656,559],{"class":263},[214,658,586],{"class":263},[214,660,662,664,666,668],{"class":216,"line":661},13,[214,663,556],{"class":506},[214,665,581],{"class":263},[214,667,595],{"class":263},[214,669,598],{"class":263},[214,671,673,675,677],{"class":216,"line":672},14,[214,674,556],{"class":506},[214,676,595],{"class":263},[214,678,607],{"class":263},[214,680,682,684,686],{"class":216,"line":681},15,[214,683,556],{"class":506},[214,685,614],{"class":263},[214,687,617],{"class":263},[477,689,690],{},"Each locale should mirror the same directory structure to maintain consistent navigation across languages.",[140,692,694],{"id":693},"locale-fallback","Locale fallback",[126,696,697,698,700],{},"Docus warns and skips any locale that does not exist in your ",[135,699,529],{}," directory. Missing locales are not registered.",[702,703,704,705,707],"prose-tip",{},"This is especially helpful when you extend Docus and use ",[135,706,137],{}," for the rest of your site, but only want the docs in a subset of languages.",[126,709,710],{},"Docus detects locales from your nuxt config:",[205,712,714],{"className":207,"code":713,"filename":313,"language":209,"meta":210,"style":210},"export default defineNuxtConfig({\n  modules: ['@nuxtjs/i18n'],\n  i18n: {\n    locales: ['en', 'fr', 'ja'],\n    defaultLocale: 'en'\n  }\n})\n",[135,715,716,728,746,754,789,802,806],{"__ignoreMap":210},[214,717,718,720,722,724,726],{"class":216,"line":217},[214,719,221],{"class":220},[214,721,224],{"class":220},[214,723,330],{"class":227},[214,725,232],{"class":231},[214,727,236],{"class":235},[214,729,730,732,734,736,738,740,742,744],{"class":216,"line":239},[214,731,339],{"class":242},[214,733,246],{"class":235},[214,735,344],{"class":231},[214,737,267],{"class":235},[214,739,137],{"class":263},[214,741,267],{"class":235},[214,743,353],{"class":231},[214,745,356],{"class":235},[214,747,748,750,752],{"class":216,"line":252},[214,749,361],{"class":242},[214,751,246],{"class":235},[214,753,249],{"class":235},[214,755,756,758,760,762,764,766,768,770,772,774,776,778,780,783,785,787],{"class":216,"line":277},[214,757,386],{"class":242},[214,759,246],{"class":235},[214,761,344],{"class":231},[214,763,267],{"class":235},[214,765,377],{"class":263},[214,767,267],{"class":235},[214,769,270],{"class":235},[214,771,260],{"class":235},[214,773,264],{"class":263},[214,775,267],{"class":235},[214,777,270],{"class":235},[214,779,260],{"class":235},[214,781,782],{"class":263},"ja",[214,784,267],{"class":235},[214,786,353],{"class":231},[214,788,356],{"class":235},[214,790,791,793,795,797,799],{"class":216,"line":283},[214,792,370],{"class":242},[214,794,246],{"class":235},[214,796,260],{"class":235},[214,798,377],{"class":263},[214,800,801],{"class":235},"'\n",[214,803,804],{"class":216,"line":394},[214,805,280],{"class":235},[214,807,808,810],{"class":216,"line":428},[214,809,286],{"class":235},[214,811,289],{"class":231},[126,813,814,815,817],{},"But only register it based on your ",[135,816,529],{}," folder structure:",[205,819,821],{"className":496,"code":820,"language":499,"meta":210,"style":210},"content/\n├─ en/           # registered ✅\n├─ fr/           # registered ✅ (if present)\n└─ ja/           # skipped 🚫 (if missing)\n",[135,822,823,827,837,846],{"__ignoreMap":210},[214,824,825],{"class":216,"line":217},[214,826,540],{"class":506},[214,828,829,832,834],{"class":216,"line":239},[214,830,831],{"class":506},"├─",[214,833,548],{"class":263},[214,835,836],{"class":273},"           # registered ✅\n",[214,838,839,841,843],{"class":216,"line":252},[214,840,831],{"class":506},[214,842,624],{"class":263},[214,844,845],{"class":273},"           # registered ✅ (if present)\n",[214,847,848,851,854],{"class":216,"line":277},[214,849,850],{"class":506},"└─",[214,852,853],{"class":263}," ja/",[214,855,856],{"class":273},"           # skipped 🚫 (if missing)\n",[126,858,859,860,486],{},"If a user requests a missing docs locale, Docus redirects to the ",[130,861,862],{},"default locale",[864,865,866,867,870,871],"prose-warning",{},"You must set a ",[135,868,869],{},"defaultLocale"," in your i18n config and ensure it exists under ",[135,872,873],{},"content/\u003CdefaultLocale>",[875,876,877],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":210,"searchDepth":239,"depth":239,"links":879},[880,881,882,885,886,887],{"id":142,"depth":239,"text":143},{"id":193,"depth":239,"text":194},{"id":292,"depth":239,"text":293,"children":883},[884],{"id":303,"depth":252,"text":304},{"id":489,"depth":239,"text":490},{"id":522,"depth":239,"text":523},{"id":693,"depth":239,"text":694},"Create multi-language documentation with Docus v4 built-in i18n support.","md",null,{},{"icon":69},{"description":894,"title":66},"Learn how to set up and manage multi-language documentation with Docus v4 built-in i18n support.","aSBlvTWW7mGSEhIPwEKaPyD9CF98SmgtMG1SGfl3uD4",[897,899],{"title":61,"path":62,"stem":63,"description":898,"icon":64,"children":-1},"Learn how to override built-in components in Docus to customize your documentation.",{"title":71,"path":72,"stem":73,"description":900,"icon":74,"children":-1},"Build interactive and reusable elements with Nuxt components",1772820160138]