CI: clean debian sid build step artifacts

.gitlab-ci.yml

@@ -99,6 +99,7 @@ build:debian-sid:
     - master
   script:
     - ./build-deb.sh --install-build-deps --sid
+    - rm -fr dist/ldapsaisie-*
   artifacts:
     paths:
       - dist/*
@@ -138,8 +139,8 @@ build:doc:html:
     - make LdapSaisie.html
     - test -n "$CI_COMMIT_TAG" && DOC_TAG=stable || DOC_TAG=dev
     - source venv/bin/activate  # We must have to activate the venv to use mike (direct call not supported)
-    - mike deploy --rebase --prefix doc/dist --remote $DOC_REMOTE --push --branch $DOC_BRANCH --update-aliases $VERSION $DOC_TAG
-    - mike set-default --rebase --prefix doc/dist --remote $DOC_REMOTE --push --branch $DOC_BRANCH $DOC_TAG
+    - mike deploy --branch $DOC_BRANCH --remote $DOC_REMOTE --push --update-aliases $VERSION $DOC_TAG
+    - mike set-default --branch $DOC_BRANCH --remote $DOC_REMOTE --push $DOC_TAG
   artifacts:
     paths:
       - doc/LdapSaisie.html

doc/Makefile

@@ -4,7 +4,9 @@ public_html: venv
 	venv/bin/mkdocs build -s
 
 LdapSaisie.html: venv public_html
-	venv/bin/htmlark public_html/print_page/index.html -o LdapSaisie.html
+	venv/bin/htmlark public_html/print_page/index.html -o LdapSaisie.tmp.html
+	venv/bin/python clean-all-in-one-html-file.py LdapSaisie.tmp.html LdapSaisie.html
+	rm -f LdapSaisie.tmp.html
 
 LdapSaisie.pdf: LdapSaisie.html
 	docker run -v $(CURDIR):/workspace pink33n/html-to-pdf --url file:///workspace/LdapSaisie.html --pdf LdapSaisie.pdf

doc/clean-all-in-one-html-file.py

@@ -0,0 +1,40 @@
+import sys
+import os.path
+
+from bs4 import BeautifulSoup
+
+# Check & handle arguments
+if len(sys.argv) < 2:
+    print(f'Usage: {sys.argv[0]} [/path/to/input.html] [/path/to/output.html]')
+    sys.exit(1)
+
+input_path = sys.argv[1]
+
+if not os.path.exists(input_path):
+    print(f'{input_path} not found')
+    sys.exit(1)
+
+output_path = sys.argv[2] if len(sys.argv) > 2 else input_path
+
+# Open & parse HTML input file
+with open(input_path, 'r') as fp:
+    soup = BeautifulSoup(fp, 'html.parser')
+
+# Delete some useless elements
+to_delete = [
+    (['div'], {'class': 'md-sidebar'}),
+    (['div'], {'class': 'md-search'}),
+    (['label'], {'for': '__search'}),
+    (['div'], {'id': 'print-site-banner'}),
+    (['div'], {'class': 'md-header__source'}),
+]
+for args, kwargs in to_delete:
+    for el in soup.find_all(*args, **kwargs):
+        el.decompose()
+
+# Change LdapSaisie logo header link to JS scroll top action
+soup.find('a', attrs={'class': 'md-logo'})['href'] = 'javascript:window.scrollTo(0,0)'
+
+# Store resulting HTML document in output file
+with open(output_path, 'w') as fp:
+    fp.write(str(soup))

doc/mkdocs.yml

@@ -27,7 +27,9 @@ plugins:
   - search:
       lang: fr                                      # Set language for search
   - mike:
-      canonical_version: null
+      alias_type: symlink
+      deploy_prefix: doc/dist
+      canonical_version: dev
       version_selector: true
       css_dir: css
       javascript_dir: js

doc/requirements.txt

@@ -7,3 +7,5 @@ html5lib
 requests
 htmlark
 mike
+git+https://github.com/jimporter/mike.git@master
+beautifulsoup4