Manual: Add support for youtube videos

docs/conf.py

@@ -13,7 +13,13 @@ author = "CP2K Developers"
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = ["myst_parser", "sphinx_rtd_theme", "sphinx.ext.mathjax"]
+extensions = [
+    "myst_parser",
+    "sphinx_rtd_theme",
+    "sphinx.ext.mathjax",
+    "sphinx.ext.intersphinx",
+    "sphinxcontrib.youtube",
+]
 
 myst_enable_extensions = [
     "attrs_inline",

docs/methods/dft/gapw.md

@@ -6,3 +6,11 @@ In the meantime, the following links might be helpful:
 
 - [](#Lippert1999)
 - [](#VandeVondele2006)
+
+```{youtube} L0hKLjvjIFU
+---
+url_parameters: ?start=4
+align: center
+privacy_mode:
+---
+```

tools/docker/scripts/test_manual.sh

@@ -29,7 +29,12 @@ apt-get install -qq --no-install-recommends \
   python3-pip
 rm -rf /var/lib/apt/lists/*
 
-pip3 install --quiet sphinx myst-parser sphinx_rtd_theme lxml
+pip3 install --quiet \
+  sphinx \
+  myst-parser \
+  sphinx_rtd_theme \
+  sphinxcontrib-youtube \
+  lxml
 
 echo -e "\n========== Generating Manual =========="