Draft: Build HTML version of documentation

.gitlab-ci.yml

@@ -128,6 +128,7 @@ create_doc:
   artifacts:
     paths:
       - Documentation/doc.pdf
+      - Documentation/doc.html
   script:
     - apt-get update
     - apt-get install -y diff-pdf-wx
@@ -146,6 +147,7 @@ create_doc:
         git commit -m "Update doc.pdf"
         git push --push-option="ci.skip" gitlab_origin HEAD:$CI_COMMIT_BRANCH
       fi
+    - make doc.html
 
 create_doxygen:
   image: git.physik.uni-wuerzburg.de:25812/z03/pdi/debian:bookworm-buildd

Documentation/Makefile

@@ -0,0 +1,14 @@
+.PHONY: doc.pdf doc.html
+
+doc.pdf:
+	latexmk -pdf doc.tex
+
+doc.html:
+	pandoc doc.tex -o doc.html \
+	  --metadata title="ALF Documentaion" \
+	  --mathjax \
+	  -H header-mathjax.html \
+	  --standalone \
+	  --toc \
+	  --css=pandoc.css \
+	  --number-sections

Documentation/header-mathjax.html

@@ -0,0 +1,2 @@
+<script src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
+

Documentation/html-process-images.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+
+from bs4 import BeautifulSoup
+import subprocess
+from glob import glob
+
+with open("doc.html", "r", encoding="utf-8") as f:
+    html = f.read()
+
+soup = BeautifulSoup(html, "html.parser")
+
+imgs = []
+
+for tag in soup.find_all("embed", src=True):
+    if tag["src"].lower().endswith(".pdf"):
+        imgs.append(tag["src"])
+
+for img in imgs:
+    files = glob(f'**/{img}', recursive=True)
+    if len(files) != 1:
+        print(f'Could not find {img}: {files}')
+        continue
+    subprocess.run(["pdftocairo", "-png", "-singlefile", f'../{files[0]}'], cwd='html')
+    html = html.replace(img, img.split('/')[-1].replace('.pdf', '.png'))
+
+subprocess.run(["pdftocairo", "-png", "-singlefile", '../Figures/U_Profile.pdf'], cwd='html')
+html = html.replace('U_profile.pdf', 'U_Profile.png')
+
+
+with open("html/doc.html", "w", encoding="utf-8") as f:
+    f.write(html)