diff --git a/docs/source/conf.py b/docs/source/conf.py
index 7de6dcbf..9c42bc9b 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -13,12 +13,9 @@ release = latest_tag
 version = release
 
 myst_substitutions = {
-  "repo_host" : "codeberg.org"
+  "repo_host" : "codeberg.org" # or 'github.com'
 }
 
-
-
-
 # -- General configuration
 
 extensions = [
@@ -45,9 +42,11 @@ templates_path = ['_templates']
 
 html_theme = 'sphinx_rtd_theme'
 
-# -- Options for EPUB output
+# Show URLs as footnotes
 #epub_show_urls = 'footnote'
+latex_show_urls = 'footnote'
 
 mermaid_cmd = "./node_modules/.bin/mmdc"
+# 'raw' does not work for epub and pdf, neither does 'svg'
 mermaid_output_format = 'png'
 mermaid_params = ['--theme', 'default', '--width', '800', '--backgroundColor', 'transparent']