Documentation: Add German Versions.

Add support for building and serving the German versions of the manual
and mobile manual.
Will need testing. Pretty sure the routes in `server.py` aren't done in
the best way, but hopefully they'll work.

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

@@ -181,12 +181,28 @@ def mobile_user_manual_images(path):
 
 @app.route("/subsurface-user-manual/")
 def static_user_manual():
+    language = request.args.get("lang")
+
+    if language:
+        file_name = "user-manual_" + language[:2] + ".html"
+        file_path = os.path.join(os.path.join(app.root_path, "static"), file_name)
+        if os.path.exists(file_path):
+            return send_from_directory(os.path.join(app.root_path, "static"), file_name)
+
     return send_from_directory(os.path.join(app.root_path, "static"), "user-manual.html")
 
 
 @app.route("/subsurface-mobile-v3-user-manual/")
 @app.route("/subsurface-mobile-user-manual/")
 def static_mobile_user_manual():
+    language = request.args.get("lang")
+
+    if language:
+        file_name = "mobile-user-manual_" + language[:2] + ".html"
+        file_path = os.path.join(os.path.join(app.root_path, "static"), file_name)
+        if os.path.exists(file_path):
+            return send_from_directory(os.path.join(app.root_path, "static"), file_name)
+
     return send_from_directory(os.path.join(app.root_path, "static"), "mobile-user-manual.html")
 
 

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",