docs: add German and Portuguese (Brazil) localescodex/add-portuguese-and-german-language-support

1 files changed, 203 insertions, 132 deletions

diff --git a/doc/docs/.vitepress/config.mts b/doc/docs/.vitepress/config.mts
index 188c2fa..39ded54 100644
--- a/doc/docs/.vitepress/config.mts
+++ b/doc/docs/.vitepress/config.mts
@@ -19,137 +19,182 @@ const yuescriptLanguage = {
   aliases: ['yue'],
 }
 
-// Generate sidebar configuration function
-function createSidebar(basePath: string, zh: boolean) {
+const sidebarText = {
+  en: {
+    introduction: 'Introduction',
+    installation: 'Installation',
+    usage: 'Usage',
+    macro: 'Macro',
+    operator: 'Operator',
+    module: 'Module',
+    assignment: 'Assignment',
+    destructuringAssignment: 'Destructuring Assignment',
+    ifAssignment: 'If Assignment',
+    varargsAssignment: 'Varargs Assignment',
+    whitespace: 'Whitespace',
+    comment: 'Comment',
+    try: 'Try',
+    attributes: 'Attributes',
+    literals: 'Literals',
+    functionLiterals: 'Function Literals',
+    backcalls: 'Backcalls',
+    tableLiterals: 'Table Literals',
+    comprehensions: 'Comprehensions',
+    forLoop: 'For Loop',
+    whileLoop: 'While Loop',
+    continueStatement: 'Continue Statement',
+    conditionals: 'Conditionals',
+    lineDecorators: 'Line Decorators',
+    switch: 'Switch',
+    objectOrientedProgramming: 'Object Oriented Programming',
+    withStatement: 'With Statement',
+    do: 'Do',
+    functionStubs: 'Function Stubs',
+    usingClause: 'The Using Clause; Controlling Destructive Assignment',
+    yuescriptLibrary: 'The YueScript Library',
+    licenseMit: 'License: MIT',
+  },
+  zh: {
+    introduction: '介绍',
+    installation: '安装',
+    usage: '使用方法',
+    macro: '宏',
+    operator: '操作符',
+    module: '模块',
+    assignment: '赋值',
+    destructuringAssignment: '解构赋值',
+    ifAssignment: 'if 赋值',
+    varargsAssignment: '可变参数赋值',
+    whitespace: '空白',
+    comment: '注释',
+    try: '错误处理',
+    attributes: '属性',
+    literals: '字面量',
+    functionLiterals: '函数字面量',
+    backcalls: '反向回调',
+    tableLiterals: '表格字面量',
+    comprehensions: '推导式',
+    forLoop: 'for 循环',
+    whileLoop: 'while 循环',
+    continueStatement: 'continue 语句',
+    conditionals: '条件语句',
+    lineDecorators: '代码行修饰符',
+    switch: 'switch 语句',
+    objectOrientedProgramming: '面向对象编程',
+    withStatement: 'with 语句',
+    do: 'do 语句',
+    functionStubs: '函数存根',
+    usingClause: '使用 using 语句：防止破坏性赋值',
+    yuescriptLibrary: '月之脚本语言库',
+    licenseMit: 'MIT 许可证',
+  },
+  de: {
+    introduction: 'Einführung',
+    installation: 'Installation',
+    usage: 'Verwendung',
+    macro: 'Makro',
+    operator: 'Operatoren',
+    module: 'Modul',
+    assignment: 'Zuweisung',
+    destructuringAssignment: 'Destrukturierende Zuweisung',
+    ifAssignment: 'If-Zuweisung',
+    varargsAssignment: 'Varargs-Zuweisung',
+    whitespace: 'Leerraum',
+    comment: 'Kommentare',
+    try: 'Try/Catch',
+    attributes: 'Attribute',
+    literals: 'Literale',
+    functionLiterals: 'Funktionsliterale',
+    backcalls: 'Backcalls',
+    tableLiterals: 'Tabellenliterale',
+    comprehensions: 'Comprehensions',
+    forLoop: 'For-Schleife',
+    whileLoop: 'While-Schleife',
+    continueStatement: 'Continue-Anweisung',
+    conditionals: 'Bedingungen',
+    lineDecorators: 'Zeilen-Dekoratoren',
+    switch: 'Switch',
+    objectOrientedProgramming: 'Objektorientierte Programmierung',
+    withStatement: 'With-Anweisung',
+    do: 'Do',
+    functionStubs: 'Funktions-Stubs',
+    usingClause: 'Die Using-Klausel; Kontrolle destruktiver Zuweisung',
+    yuescriptLibrary: 'Die YueScript-Bibliothek',
+    licenseMit: 'Lizenz: MIT',
+  },
+  ptBr: {
+    introduction: 'Introdução',
+    installation: 'Instalação',
+    usage: 'Uso',
+    macro: 'Macro',
+    operator: 'Operadores',
+    module: 'Módulo',
+    assignment: 'Atribuição',
+    destructuringAssignment: 'Atribuição com desestruturação',
+    ifAssignment: 'Atribuição com if',
+    varargsAssignment: 'Atribuição de varargs',
+    whitespace: 'Espaços em branco',
+    comment: 'Comentários',
+    try: 'Try/Catch',
+    attributes: 'Atributos',
+    literals: 'Literais',
+    functionLiterals: 'Literais de função',
+    backcalls: 'Backcalls',
+    tableLiterals: 'Literais de tabela',
+    comprehensions: 'Compreensões',
+    forLoop: 'Laço for',
+    whileLoop: 'Laço while',
+    continueStatement: 'Instrução continue',
+    conditionals: 'Condicionais',
+    lineDecorators: 'Decoradores de linha',
+    switch: 'Switch',
+    objectOrientedProgramming: 'Programação orientada a objetos',
+    withStatement: 'Instrução with',
+    do: 'Do',
+    functionStubs: 'Stubs de função',
+    usingClause: 'Cláusula using; controlando atribuição destrutiva',
+    yuescriptLibrary: 'A biblioteca do YueScript',
+    licenseMit: 'Licença: MIT',
+  },
+} as const
+
+type SidebarLocale = keyof typeof sidebarText
+
+function createSidebar(basePath: string, locale: SidebarLocale) {
+  const text = sidebarText[locale]
   return [
-    {
-      text: zh ? '介绍' : 'Introduction',
-      link: `${basePath}/introduction`,
-    },
-    {
-      text: zh ? '安装' : 'Installation',
-      link: `${basePath}/installation`,
-    },
-    {
-      text: zh ? '使用方法' : 'Usage',
-      link: `${basePath}/usage`,
-    },
-    {
-      text: zh ? '宏' : 'Macro',
-      link: `${basePath}/macro`,
-    },
-    {
-      text: zh ? '操作符' : 'Operator',
-      link: `${basePath}/operator`,
-    },
-    {
-      text: zh ? '模块' : 'Module',
-      link: `${basePath}/module`,
-    },
-    {
-      text: zh ? '赋值' : 'Assignment',
-      link: `${basePath}/assignment`,
-    },
-    {
-      text: zh ? '解构赋值' : 'Destructuring Assignment',
-      link: `${basePath}/destructuring-assignment`,
-    },
-    {
-      text: zh ? 'if 赋值' : 'If Assignment',
-      link: `${basePath}/if-assignment`,
-    },
-    {
-      text: zh ? '可变参数赋值' : 'Varargs Assignment',
-      link: `${basePath}/varargs-assignment`,
-    },
-    {
-      text: zh ? '空白' : 'Whitespace',
-      link: `${basePath}/whitespace`,
-    },
-    {
-      text: zh ? '注释' : 'Comment',
-      link: `${basePath}/comment`,
-    },
-    {
-      text: zh ? '错误处理' : 'Try',
-      link: `${basePath}/try`,
-    },
-    {
-      text: zh ? '属性' : 'Attributes',
-      link: `${basePath}/attributes`,
-    },
-    {
-      text: zh ? '字面量' : 'Literals',
-      link: `${basePath}/literals`,
-    },
-    {
-      text: zh ? '函数字面量' : 'Function Literals',
-      link: `${basePath}/function-literals`,
-    },
-    {
-      text: zh ? '反向回调' : 'Backcalls',
-      link: `${basePath}/backcalls`,
-    },
-    {
-      text: zh ? '表格字面量' : 'Table Literals',
-      link: `${basePath}/table-literals`,
-    },
-    {
-      text: zh ? '推导式' : 'Comprehensions',
-      link: `${basePath}/comprehensions`,
-    },
-    {
-      text: zh ? 'for 循环' : 'For Loop',
-      link: `${basePath}/for-loop`,
-    },
-    {
-      text: zh ? 'while 循环' : 'While Loop',
-      link: `${basePath}/while-loop`,
-    },
-    {
-      text: zh ? 'continue 语句' : 'Continue Statement',
-      link: `${basePath}/continue`,
-    },
-    {
-      text: zh ? '条件语句' : 'Conditionals',
-      link: `${basePath}/conditionals`,
-    },
-    {
-      text: zh ? '代码行修饰符' : 'Line Decorators',
-      link: `${basePath}/line-decorators`,
-    },
-    {
-      text: zh ? 'switch 语句' : 'Switch',
-      link: `${basePath}/switch`,
-    },
-    {
-      text: zh ? '面向对象编程' : 'Object Oriented Programming',
-      link: `${basePath}/object-oriented-programming`,
-    },
-    {
-      text: zh ? 'with 语句' : 'With Statement',
-      link: `${basePath}/with-statement`,
-    },
-    {
-      text: zh ? 'do 语句' : 'Do',
-      link: `${basePath}/do`,
-    },
-    {
-      text: zh ? '函数存根' : 'Function Stubs',
-      link: `${basePath}/function-stubs`,
-    },
-    {
-      text: zh ? '使用 using 语句：防止破坏性赋值' : 'The Using Clause; Controlling Destructive Assignment',
-      link: `${basePath}/the-using-clause-controlling-destructive-assignment`,
-    },
-    {
-      text: zh ? '月之脚本语言库' : 'The YueScript Library',
-      link: `${basePath}/the-yuescript-library`,
-    },
-    {
-      text: zh ? 'MIT 许可证' : 'License: MIT',
-      link: `${basePath}/license-mit`,
-    },
+    { text: text.introduction, link: `${basePath}/introduction` },
+    { text: text.installation, link: `${basePath}/installation` },
+    { text: text.usage, link: `${basePath}/usage` },
+    { text: text.macro, link: `${basePath}/macro` },
+    { text: text.operator, link: `${basePath}/operator` },
+    { text: text.module, link: `${basePath}/module` },
+    { text: text.assignment, link: `${basePath}/assignment` },
+    { text: text.destructuringAssignment, link: `${basePath}/destructuring-assignment` },
+    { text: text.ifAssignment, link: `${basePath}/if-assignment` },
+    { text: text.varargsAssignment, link: `${basePath}/varargs-assignment` },
+    { text: text.whitespace, link: `${basePath}/whitespace` },
+    { text: text.comment, link: `${basePath}/comment` },
+    { text: text.try, link: `${basePath}/try` },
+    { text: text.attributes, link: `${basePath}/attributes` },
+    { text: text.literals, link: `${basePath}/literals` },
+    { text: text.functionLiterals, link: `${basePath}/function-literals` },
+    { text: text.backcalls, link: `${basePath}/backcalls` },
+    { text: text.tableLiterals, link: `${basePath}/table-literals` },
+    { text: text.comprehensions, link: `${basePath}/comprehensions` },
+    { text: text.forLoop, link: `${basePath}/for-loop` },
+    { text: text.whileLoop, link: `${basePath}/while-loop` },
+    { text: text.continueStatement, link: `${basePath}/continue` },
+    { text: text.conditionals, link: `${basePath}/conditionals` },
+    { text: text.lineDecorators, link: `${basePath}/line-decorators` },
+    { text: text.switch, link: `${basePath}/switch` },
+    { text: text.objectOrientedProgramming, link: `${basePath}/object-oriented-programming` },
+    { text: text.withStatement, link: `${basePath}/with-statement` },
+    { text: text.do, link: `${basePath}/do` },
+    { text: text.functionStubs, link: `${basePath}/function-stubs` },
+    { text: text.usingClause, link: `${basePath}/the-using-clause-controlling-destructive-assignment` },
+    { text: text.yuescriptLibrary, link: `${basePath}/the-yuescript-library` },
+    { text: text.licenseMit, link: `${basePath}/licence-mit` },
   ]
 }
 
@@ -223,7 +268,7 @@ export default defineConfig({
           { text: 'Try yue!', link: '/try/' },
           { text: 'GitHub', link: 'https://github.com/IppClub/Yuescript' }
         ],
-        sidebar: createSidebar('/doc', false),
+        sidebar: createSidebar('/doc', 'en'),
       }
     },
     zh: {
@@ -236,7 +281,33 @@ export default defineConfig({
           { text: '试一试!', link: '/zh/try/' },
           { text: 'GitHub', link: 'https://github.com/IppClub/Yuescript' }
         ],
-        sidebar: createSidebar('/zh/doc', true),
+        sidebar: createSidebar('/zh/doc', 'zh'),
+      }
+    },
+    de: {
+      label: 'Deutsch',
+      lang: 'de-DE',
+      description: 'Eine Sprache, die zu Lua kompiliert',
+      themeConfig: {
+        nav: [
+          { text: 'Dokumentation', link: '/de/doc/' },
+          { text: 'Yue ausprobieren!', link: '/de/try/' },
+          { text: 'GitHub', link: 'https://github.com/IppClub/Yuescript' }
+        ],
+        sidebar: createSidebar('/de/doc', 'de'),
+      }
+    },
+    'pt-br': {
+      label: 'Português (Brasil)',
+      lang: 'pt-BR',
+      description: 'Uma linguagem que compila para Lua',
+      themeConfig: {
+        nav: [
+          { text: 'Documentação', link: '/pt-br/doc/' },
+          { text: 'Experimente Yue!', link: '/pt-br/try/' },
+          { text: 'GitHub', link: 'https://github.com/IppClub/Yuescript' }
+        ],
+        sidebar: createSidebar('/pt-br/doc', 'ptBr'),
       }
     }
   },