Install pandoc

.gitlab-ci.yml

@@ -76,7 +76,9 @@ pages:
   image: python:3.9
   stage: doc
   before_script:
-    - pip3 install sphinx==7.2.6 networkx==2.5 sphinxcontrib-apidoc==0.5.0 sphinx-rtd-theme==2.0.0 Jinja2==3.0.3 recommonmark==0.6.0 nbsphinx==0.9.3 nbconvert==6.4.3  sphinxcontrib-napoleon==0.7 sphinx-autoapi==3.0.0 graphviz ipython==7.20.0 json_schema_for_humans==0.40.3 pandoc --break-system-packages
+    - apt-get update
+    - apt-get install -y pandoc
+    - pip3 install sphinx==7.2.6 networkx==2.5 sphinxcontrib-apidoc==0.5.0 sphinx-rtd-theme==2.0.0 Jinja2==3.0.3 recommonmark==0.6.0 nbsphinx==0.9.3 nbconvert==6.4.3  sphinxcontrib-napoleon==0.7 sphinx-autoapi==3.0.0 graphviz ipython==7.20.0 json_schema_for_humans==0.40.3 --break-system-packages
   script:
     - mkdir public
     - make -C doc/ html

doc/index.rst

@@ -12,21 +12,29 @@ Installation
 
 It is recommended to create a virtual environment before installing the package.
 
-`python -m venv /path/to/venv/`
+.. code-block:: bash
+
+    python -m venv /path/to/venv/
 
 Activate the venv
 
-`source /path/to/venv/bin/activate`
+.. code-block:: bash
+
+    source /path/to/venv/bin/activate`
 
 The project is managed by the `pyproject.toml`-file. Hence, an installation with `pip` is the prefered way.
 
 In the next step we clone the pafsim repository:
 
-`git clone https://gitlab.mpcdf.mpg.de/nesser/pafsim && cd pafsim`
+.. code-block:: bash
+
+    git clone https://gitlab.mpcdf.mpg.de/nesser/pafsim && cd pafsim
 
 and install it
 
-`pip install .`
+.. code-block:: bash
+
+    pip install .
 
 All required dependencies are resolved.