doc: use mike to keep old released doc

.gitlab-ci.yml

@@ -99,7 +99,6 @@ build:debian-sid:
     - master
   script:
     - ./build-deb.sh --install-build-deps --sid
-    - rm -fr dist/ldapsaisie-*
   artifacts:
     paths:
       - dist/*
@@ -139,8 +138,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 --branch $DOC_BRANCH --remote $DOC_REMOTE --push --update-aliases $VERSION $DOC_TAG
-    - mike set-default --branch $DOC_BRANCH --remote $DOC_REMOTE --push $DOC_TAG
+    - 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
   artifacts:
     paths:
       - doc/LdapSaisie.html

doc/Makefile

@@ -4,9 +4,7 @@ public_html: venv
 	venv/bin/mkdocs build -s
 
 LdapSaisie.html: venv public_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
+	venv/bin/htmlark public_html/print_page/index.html -o LdapSaisie.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

@@ -1,40 +0,0 @@
-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,9 +27,7 @@ plugins:
   - search:
       lang: fr                                      # Set language for search
   - mike:
-      alias_type: symlink
-      deploy_prefix: doc/dist
-      canonical_version: dev
+      canonical_version: null
       version_selector: true
       css_dir: css
       javascript_dir: js

doc/requirements.txt

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