TL: added image support for documentation website

Author: tlunet

README.md

@@ -108,3 +108,9 @@ Education and Research](https://www.bmbf.de/bmbf/en/home/home_node.html)
 (BMBF) grant 16HPC047. The project also received help from the
 [Helmholtz Platform for Research Software Engineering - Preparatory
 Study (HiRSE_PS)](https://www.helmholtz-hirse.de/).
+
+<p align="center">
+  <img src="./docs/img/EuroHPC.jpg" height="105"/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="./docs/img/LogoTime-X.png" height="105" /> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+  <img src="./docs/img/BMBF_gefoerdert_2017_en.jpg" height="105" />
+</p>

docs/convert_markdown.py

@@ -9,6 +9,7 @@
 import glob
 import json
 import m2r2
+import shutil
 import numpy as np
 
 mdFiles = [
@@ -20,6 +21,10 @@
 
 docSources = 'docs/source'
 
+# Move already images in the future build directory
+os.makedirs('docs/build/html/_images/', exist_ok=True)
+shutil.copytree('docs/img', 'docs/build/html/_images/docs/img', dirs_exist_ok=True)
+
 counter = np.array(0)
 
 with open('docs/emojis.json') as f:
@@ -64,6 +69,15 @@ def completeRefLinks(rst, baseName):
 def addOrphanTag(rst):
     return '\n:orphan:\n'+rst
 
+def setImgPath(rst):
+    i = 0
+    while i != -1:
+        i = rst.find('<img src=".', i)
+        if i != -1:
+            rst = rst[:i+11]+'/_images'+rst[i+11:]
+            i += 16
+    return rst
+
 def convert(md, orphan=False, sectionRefs=True):
     baseName = os.path.splitext(md)[0]
     rst = m2r2.parse_from_file(md, parse_relative_links=True)
@@ -73,6 +87,7 @@ def convert(md, orphan=False, sectionRefs=True):
     rst = completeRefLinks(rst, baseName)
     if orphan:
         rst = addOrphanTag(rst)
+    rst = setImgPath(rst)
     with open(f'{docSources}/{baseName}.rst', 'w') as f:
         f.write(rst)
     print(f'Converted {md} to {docSources}/{baseName}.rst')