Localization / language-switching support (mdbook-spacewizards build)

.github/workflows/deploy.yml

@@ -28,10 +28,16 @@ jobs:
         run: |
           curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf -y | sh
           rustup update
-      - name: Install mdbook & plugins
+      - name: Install mdbook-spacewizards
+        uses: jaxxstorm/[email protected]
+        with: # Grab a specific tag with caching
+          repo: space-wizards/mdBook-spacewizards
+          tag: v0.4.35
+          cache: enable
+      - name: Install plugins
         uses: taiki-e/[email protected]
         with:
-          tool: mdbook@0.4.34,mdbook[email protected],[email protected],[email protected],[email protected],[email protected]
+          tool: [email protected],[email protected],[email protected],[email protected],[email protected]
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v3

.github/workflows/test.yml

@@ -14,10 +14,16 @@ jobs:
         run: |
           curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf -y | sh
           rustup update
-      - name: Install mdbook & plugins
+      - name: Install mdbook-spacewizards
+        uses: jaxxstorm/[email protected]
+        with: # Grab a specific tag with caching
+          repo: space-wizards/mdBook-spacewizards
+          tag: v0.4.35
+          cache: enable
+      - name: Install plugins
         uses: taiki-e/[email protected]
         with:
-          tool: mdbook@0.4.34,mdbook[email protected],[email protected],[email protected],[email protected],[email protected]
+          tool: [email protected],[email protected],[email protected],[email protected],[email protected]
       - name: Build with mdBook
         run: mdbook build
       - name: Upload artifact

README.md

@@ -18,6 +18,8 @@ The following `mdbook` features & plugins are available and in use:
 - `mdbook-admonish`
 - `mdbook-emojicodes`
 
+This repo uses a custom version of `mdbook` available [here](https://github.com/space-wizards/mdBook-spacewizards).
+
 The site is currently hosted at [https://docs.spacestation14.com](https://docs.spacestation14.com).
 
 **For information such as how to edit, build & test these docs, see [Guide to Editing Docs](https://spacestation14.io/docs/en/meta/guide-to-editing-docs.html). on the site itself** (or [in this repo](./src/en/meta/guide-to-editing-docs.md))

book.toml

@@ -1,20 +1,24 @@
 [book]
 authors = ["Space Wizards Contributors"]
-language = "en"
-multilingual = false
 src = "src"
 title = "Space Wizards Development Wiki"
 description = "Tutorial & reference for all Space Wizards Federation projects, including the Robust Toolbox engine and its flagship open source game, Space Station 14."
 
+[language.en]
+name = "English"
+
+[language.ru]
+name = "Русский"
+
 [preprocessor.mermaid]
 
 [preprocessor.admonish]
 assets_version = "2.0.2" # do not edit: managed by `mdbook-admonish install`
 
 [preprocessor.emojicodes]
 
-[preprocessor.template]
-before = ["mermaid","admonish","emojicodes"] # templates can include these so we run this first
+#[preprocessor.template]
+#before = ["mermaid","admonish","emojicodes"] # templates can include these so we run this first
 
 [output.html]
 additional-js = ['scripts/mermaid.min.js', 'scripts/mermaid-init.js', 'scripts/nav-additions.js']
@@ -39,9 +43,9 @@ level = 1
 [output.html.playground]
 runnable = false # sorry we arent rustpilled :(
 
-[output.linkcheck]
-traverse-parent-directories = false
-warning-policy = "ignore" # false-positives like hell with absolute links & latex, so.. cant do
+#[output.linkcheck]
+#traverse-parent-directories = false
+#warning-policy = "ignore" # false-positives like hell with absolute links & latex, so.. cant do
 
 # Redirects
 # These are used to map between old Wiki.js links and current docs site links,