Html templating

.gitlab-ci.yml

@@ -1,4 +1,4 @@
-stages: 
+stages:
   - check
   - pages
 
@@ -25,8 +25,11 @@ pages:
       - public
   image: ubuntu:20.04
   script:
+    # install required apt software
     - apt update
-    - apt -y install pandoc
+    - apt -y upgrade
+    - DEBIAN_FRONTEND=noninteractive apt-get --yes install asciidoctor
+
     - mkdir -p /opt && pushd $_
     - ln -s /afs/psi.ch/sys/psi.x86_64_el6 psi
     - popd
@@ -36,10 +39,25 @@ pages:
     - export TERM=$TERM
 
     - source /opt/psi/config/profile.bash
+
+    # install required python requirements
     - module load Python
+    - python3 -m venv pm_tools_venv
+    - source pm_tools_venv/bin/activate
+    - pip install -r requirements.txt
+
     - mkdir public
-    - cd pmodules_tools/
-    - python3 pmodules_tools.py --db-check
-    - pandoc pmodules_changes.md -o index.html
-    - cp -v index.html $CI_PROJECT_DIR/public
+    - python3 pmodules_tools/pmodules_tools.py --db-check
+    
+    # render all files in doc and its sub-directories with extension .adoc to HTML
+    - >
+      asciidoctor -a data-uri \
+        -a reproducible \
+        -a icons=font \
+        -a source-highlighter=Pygments \
+        -a experimental \
+        -a stylesheet=$CI_PROJECT_DIR/doc/stylesheets/readthedocs.css \
+        -D public \
+        -R doc '**/*.adoc'
+    - >
   when: always