Another pandoc attempt

docs/source/conf.py

@@ -15,9 +15,9 @@
 import pathlib
 import sys
 import time
-from inspect import getsourcefile
 
 from aiida.manage.configuration import Profile, load_profile
+from pypandoc.pandoc_download import download_pandoc
 
 import aiida_aimall
 
@@ -267,22 +267,6 @@
 DOCS_DIRECTORY = os.path.dirname(os.path.abspath(getsourcefile(lambda: 0)))
 
 
-def ensure_pandoc_installed(_):
-    import pypandoc
-
-    # Download pandoc if necessary. If pandoc is already installed and on
-    # the PATH, the installed version will be used. Otherwise, we will
-    # download a copy of pandoc into docs/bin/ and add that to our PATH.
-    pandoc_dir = os.path.join(DOCS_DIRECTORY, "bin")
-    # Add dir containing pandoc binary to the PATH environment variable
-    if pandoc_dir not in os.environ["PATH"].split(os.pathsep):
-        os.environ["PATH"] += os.pathsep + pandoc_dir
-    pypandoc.ensure_pandoc_installed(
-        quiet=True,
-        targetfolder=pandoc_dir,
-        delete_installer=True,
-    )
-
-
-def setup(app):
-    app.connect("builder-inited", ensure_pandoc_installed)
+# see the documentation how to customize the installation path
+# but be aware that you then need to include it in the `PATH`
+download_pandoc()