Use mkdocs print-site plugin to build all-in-one version of the documentation

.gitlab-ci.yml

@@ -94,9 +94,11 @@ build:doc:
   script:
     - cd doc
     - mkdocs build -s
+    - htmlark public_html/print_page/index.html -o LdapSaisie.html
   artifacts:
     paths:
       - doc/public_html/
+      - doc/LdapSaisie.html
 
 deploy:doc:
   stage: deploy
@@ -109,3 +111,4 @@ deploy:doc:
     - echo "$SSH_HOST_KEY" | base64 -d > ~/.ssh/known_hosts
   script:
     - rsync -atv --exclude '.git*' --delete --progress ./doc/public_html/ $SSH_USER@$SSH_HOST:./
+    - rsync -atv ./doc/LdapSaisie.html $SSH_USER@$SSH_HOST:LdapSaisie.html

doc/.gitignore

@@ -1 +1,2 @@
 public_html
+LdapSaisie.html

doc/mkdocs.yml

@@ -20,6 +20,7 @@ plugins:
   - search:
       lang: fr                                      # Set language for search
   - include-markdown
+  - print-site
 
 
 nav:

doc/overrides/main.html

@@ -0,0 +1,12 @@
+{% extends "base.html" %}
+
+{% block content %}
+
+{% if page.url_to_print_page %}
+    <a href="{{ page.url_to_print_page }}" title="Print Site" class="md-content__button md-icon">
+        {% include ".icons/material/printer.svg" %}
+    </a>
+{% endif %}
+
+{{ super() }}
+{% endblock content %}

doc/requirements.txt

@@ -2,3 +2,8 @@ mkdocs
 mkdocs-material
 mdx_truly_sane_lists
 mkdocs-include-markdown-plugin
+mkdocs-print-site-plugin
+# For building all-in-one HTML file
+html5lib
+requests
+htmlark