script

Author: MatthewSZhang

.readthedocs.yml

@@ -3,14 +3,9 @@ build:
   os: ubuntu-22.04
   tools:
     python: "3.13"
-  apt_packages:
-    - default-jre
   jobs:
-    # Install PlantUML
     pre_install:
-      - curl -o ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml.jar -L https://github.com/plantuml/plantuml/releases/latest/download/plantuml.jar
-      - bash -c "echo -e '#!/bin/bash\nexec java -Djava.awt.headless=true -jar ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml.jar \"\$@\"' > ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml"
-      - chmod +x ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml
+      - bash scripts/rtd_pre_install.sh
 
 sphinx:
    configuration: doc/conf.py

scripts/rtd_pre_install.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# Stop and exit on error
+set -euox pipefail
+
+# Check for required tools
+java -version
+
+# This folder is on PATH and does not require sudo
+# Download latest plantuml.jar from github
+curl -o ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml.jar -L https://github.com/plantuml/plantuml/releases/latest/download/plantuml.jar
+# Create an executable script for plantuml
+printf '#!/bin/bash\nexec java -Djava.awt.headless=true -jar ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml.jar "$@"' > ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml
+chmod +x ${READTHEDOCS_VIRTUALENV_PATH}/bin/plantuml
+
+# Check plantuml version
+plantuml -version