Add permalinks and update deployment

Author: johnsamuelwrites

_config.yml

@@ -33,48 +33,48 @@ plugins:
 # Navigation
 nav:
   - title: "Getting Started"
-    url: "/getting-started/"
+    url: "/en/docs/getting-started/"
     children:
       - title: "Installation"
-        url: "/getting-started/installation/"
+        url: "/en/docs/getting-started/installation/"
       - title: "Quick Start"
-        url: "/getting-started/quick-start/"
+        url: "/en/docs/getting-started/quick-start/"
       - title: "REPL Guide"
-        url: "/getting-started/repl/"
+        url: "/en/docs/getting-started/repl/"
   - title: "Language Guide"
-    url: "/language-guide/"
+    url: "/en/docs/language-guide/"
     children:
       - title: "Overview"
-        url: "/language-guide/"
+        url: "/en/docs/language-guide/"
       - title: "Syntax Reference"
-        url: "/language-guide/syntax/"
+        url: "/en/docs/language-guide/syntax/"
       - title: "Keywords"
-        url: "/language-guide/keywords/"
+        url: "/en/docs/language-guide/keywords/"
       - title: "Control Flow"
-        url: "/language-guide/control-flow/"
+        url: "/en/docs/language-guide/control-flow/"
       - title: "Functions & Classes"
-        url: "/language-guide/functions-classes/"
+        url: "/en/docs/language-guide/functions-classes/"
       - title: "Async & Generators"
-        url: "/language-guide/async-generators/"
+        url: "/en/docs/language-guide/async-generators/"
       - title: "All 17 Languages"
-        url: "/language-guide/all-languages/"
+        url: "/en/docs/language-guide/all-languages/"
       - title: "Guide Français"
-        url: "/language-guide/french/"
+        url: "/en/docs/language-guide/french/"
   - title: "Reference"
-    url: "/reference/"
+    url: "/en/docs/reference/"
     children:
       - title: "Language Concepts"
-        url: "/reference/"
+        url: "/en/docs/reference/"
       - title: "Built-in Aliases"
-        url: "/reference/builtins/"
+        url: "/en/docs/reference/builtins/"
       - title: "Operators"
-        url: "/reference/operators/"
+        url: "/en/docs/reference/operators/"
       - title: "Numerals"
-        url: "/reference/numerals/"
+        url: "/en/docs/reference/numerals/"
       - title: "Date & Time"
-        url: "/reference/datetime/"
+        url: "/en/docs/reference/datetime/"
       - title: "Compatibility Matrix"
-        url: "/reference/compatibility/"
+        url: "/en/docs/reference/compatibility/"
   - title: "WASM Backend"
     url: "/wasm/"
     children:
@@ -162,5 +162,9 @@ exclude:
   - vendor/ruby/
   - ".sass-cache"
   - ".jekyll-cache"
-  - "docs/"
+  - "docs/snippets/"
+  - "docs/routing/"
+  - "docs/i18n/"
+  - "docs/schemas/"
+  - "docs/README.md"
   - "scripts/"

docs/content/en/getting-started/index.md

@@ -6,6 +6,7 @@ path_segments:
 - getting-started
 source_hash: 9b9c8ca97172
 status: source
+permalink: /en/docs/getting-started/
 ---
 
 ## What is multilingual?
@@ -200,23 +201,23 @@ multilingual --version
 <div class="card-grid">
 
 <div class="card">
-<a href="/getting-started/installation/">
+<a href="/en/docs/getting-started/installation/">
 <span class="card-icon">📦</span>
 <h3>Installation Details</h3>
 <p>Platform-specific setup, WASM requirements, virtual environments.</p>
 </a>
 </div>
 
 <div class="card">
-<a href="/getting-started/quick-start/">
+<a href="/en/docs/getting-started/quick-start/">
 <span class="card-icon">🚀</span>
 <h3>Quick Start Examples</h3>
 <p>10-minute tour of the main language features.</p>
 </a>
 </div>
 
 <div class="card">
-<a href="/language-guide/">
+<a href="/en/docs/language-guide/">
 <span class="card-icon">📖</span>
 <h3>Language Guide</h3>
 <p>Complete syntax reference for all 17 languages.</p>

docs/content/en/getting-started/installation.md

@@ -7,6 +7,7 @@ path_segments:
 - installation
 source_hash: 7febf671956e
 status: source
+permalink: /en/docs/getting-started/installation/
 ---
 
 ## System Requirements

docs/content/en/getting-started/quick-start.md

@@ -7,9 +7,10 @@ path_segments:
 - quick-start
 source_hash: c17c2ed2a7d8
 status: source
+permalink: /en/docs/getting-started/quick-start/
 ---
 
-This guide walks through the core language features in 10 minutes using English. Every construct shown here is available in all 17 languages — see the [Language Guide](/language-guide/all-languages/) for equivalents.
+This guide walks through the core language features in 10 minutes using English. Every construct shown here is available in all 17 languages — see the [Language Guide](/en/docs/language-guide/all-languages/) for equivalents.
 
 ---
 
@@ -170,4 +171,4 @@ Augmented assignment:
 ## Next: All 17 Languages
 
 Every feature above is available in all 17 supported languages.
-See [All Languages Reference](/language-guide/all-languages/) for the complete keyword and syntax mapping.
+See [All Languages Reference](/en/docs/language-guide/all-languages/) for the complete keyword and syntax mapping.

docs/content/en/getting-started/repl.md

@@ -7,6 +7,7 @@ path_segments:
 - repl
 source_hash: 4444b80aad58
 status: source
+permalink: /en/docs/getting-started/repl/
 ---
 
 The multilingual REPL (Read-Eval-Print Loop) is a language-switching interactive environment for writing and testing programs in any of the 17 supported languages.

docs/content/en/language-guide/all-languages.md

@@ -7,6 +7,7 @@ path_segments:
 - all-languages
 source_hash: 897bd24154cc
 status: source
+permalink: /en/docs/language-guide/all-languages/
 ---
 
 This page provides complete program examples for all 17 supported languages, demonstrating variables, control flow, functions, and classes. Each example is a complete, runnable program.

docs/content/en/language-guide/async-generators.md

@@ -7,6 +7,7 @@ path_segments:
 - async-generators
 source_hash: ef520f55de2d
 status: source
+permalink: /en/docs/language-guide/async-generators/
 ---
 
 Generators and async constructs in multilingual support the full Python model with localized keywords for `yield`, `async`, `await`, `async for`, and `async with`.
@@ -193,4 +194,4 @@ A function that combines `async def` and `yield` is an async generator:
 | async for | `async for` | `async_pour` | `para_async` | `async_für` | `非同期毎` | `غير_متزامن_لكل` | `असंकालिक_प्रत्येक` | `异步对于` |
 | async with | `async with` | `async_avec` | `async_con` | `async_mit` | `非同期と共に` | `غير_متزامن_مع` | `असंकालिक_साथ` | `异步以` |
 
-See [Keywords Reference](/language-guide/keywords/) for all 17 languages.
+See [Keywords Reference](/en/docs/language-guide/keywords/) for all 17 languages.

docs/content/en/language-guide/control-flow.md

@@ -7,6 +7,7 @@ path_segments:
 - control-flow
 source_hash: 76561f72de89
 status: source
+permalink: /en/docs/language-guide/control-flow/
 ---
 
 Control flow in multilingual uses the same Python semantics with localized keywords. All constructs work identically across all 17 supported languages — only the surface keywords differ.
@@ -260,4 +261,4 @@ French version:
 
 > `break`, `continue`, and `pass` are universal across all 17 languages.
 
-See [Keywords Reference](/language-guide/keywords/) for all 17 languages including Italian, Portuguese, Polish, Dutch, Swedish, Danish, Finnish, Bengali, and Tamil.
+See [Keywords Reference](/en/docs/language-guide/keywords/) for all 17 languages including Italian, Portuguese, Polish, Dutch, Swedish, Danish, Finnish, Bengali, and Tamil.

docs/content/en/language-guide/french.md

@@ -7,6 +7,7 @@ path_segments:
 - french
 source_hash: 8aaca71d7f2f
 status: source
+permalink: /en/docs/language-guide/french/
 ---
 
 Ce guide présente la programmation avec `multilingual` en français. Il couvre les capacités du langage, le flux d'exécution, les exemples pratiques, et les points d'extension.
@@ -235,7 +236,7 @@ Certains built-ins universels ont des alias localisés. Les noms universels Pyth
 | `ensemble` | `set` |
 | `tuple` | `tuple` |
 
-Voir la [référence des alias built-in](/reference/builtins/) pour la liste complète.
+Voir la [référence des alias built-in](/en/docs/reference/builtins/) pour la liste complète.
 
 ---
 

docs/content/en/language-guide/functions-classes.md

@@ -7,6 +7,7 @@ path_segments:
 - functions-classes
 source_hash: b0f5ca5c422c
 status: source
+permalink: /en/docs/language-guide/functions-classes/
 ---
 
 Functions and classes in multilingual work exactly like Python, with localized keywords for `def`, `class`, `return`, `self`, and related constructs. Identifiers (variable names, function names, class names) are never translated — they remain as-is in the generated Python.
@@ -203,4 +204,4 @@ Decorators are applied bottom-up:
 
 > `super`, `lambda`, `pass` are universal across all 17 languages.
 
-See [Keywords Reference](/language-guide/keywords/) for all 17 languages.
+See [Keywords Reference](/en/docs/language-guide/keywords/) for all 17 languages.