Documentation: Add German Versions.

Add support for building and serving the German versions of the manual
and mobile manual.

Signed-off-by: Michael Keller <[email protected]>

Author: mikeller

.gitignore

@@ -6,6 +6,8 @@ subsurface/
 src/web/templates/SupportedDivecomputers.html
 src/web/persistent.store
 src/web/static/user-manual.html
+src/web/static/user-manual_de.html
 src/web/static/images
 src/web/static/mobile-user-manual.html
+src/web/static/mobile-user-manual_de.html
 src/web/static/mobile-images/

src/web/server.py

@@ -179,15 +179,28 @@ def mobile_user_manual_images(path):
     return send_from_directory(os.path.join(app.root_path, "static/mobile-images"), path)
 
 
+def _serve_user_manual(base_filename):
+    language = request.args.get("lang")
+    static_dir = os.path.join(app.root_path, "static")
+
+    if language and language[:2].isalpha():
+        file_name = f"{base_filename}_{language[:2]}.html"
+        file_path = os.path.join(static_dir, file_name)
+        if os.path.exists(file_path):
+            return send_from_directory(static_dir, file_name)
+
+    return send_from_directory(static_dir, f"{base_filename}.html")
+
+
 @app.route("/subsurface-user-manual/")
 def static_user_manual():
-    return send_from_directory(os.path.join(app.root_path, "static"), "user-manual.html")
+    return _serve_user_manual("user-manual")
 
 
 @app.route("/subsurface-mobile-v3-user-manual/")
 @app.route("/subsurface-mobile-user-manual/")
 def static_mobile_user_manual():
-    return send_from_directory(os.path.join(app.root_path, "static"), "mobile-user-manual.html")
+    return _serve_user_manual("mobile-user-manual")
 
 
 @app.route("/release-changes/")

src/web/subsurfacesync.py

@@ -85,18 +85,26 @@ def sync(self):
         )
         try:
             subprocess.run(
-                f"cd {self._myroot}/subsurface/Documentation; make output/user-manual.html output/mobile-manual-v3.html", shell=True, check=True
+                f"cd {self._myroot}/subsurface/Documentation; make output/user-manual.html output/user-manual_de.html output/mobile-manual-v3.html output/mobile-manual_de.html", shell=True, check=True
             )
         except subprocess.CalledProcessError:
             print("issue building the latest Subsurface documentation - please check")
         shutil.copy(
             f"{self._myroot}/subsurface/Documentation/output/user-manual.html",
             f"{self._myroot}/src/web/static/user-manual.html",
         )
+        shutil.copy(
+            f"{self._myroot}/subsurface/Documentation/output/user-manual_de.html",
+            f"{self._myroot}/src/web/static/user-manual_de.html",
+        )
         shutil.copy(
             f"{self._myroot}/subsurface/Documentation/output/mobile-manual-v3.html",
             f"{self._myroot}/src/web/static/mobile-user-manual.html",
         )
+        shutil.copy(
+            f"{self._myroot}/subsurface/Documentation/output/mobile-manual_de.html",
+            f"{self._myroot}/src/web/static/mobile-user-manual_de.html",
+        )
         shutil.copytree(
             f"{self._myroot}/subsurface/Documentation/output/images",
             f"{self._myroot}/src/web/static/images",