diff --git a/data/blob.ttl b/nodes/blob.ttl similarity index 100% rename from data/blob.ttl rename to nodes/blob.ttl diff --git a/data/fenrispunk.ttl b/nodes/fenrispunk.ttl similarity index 100% rename from data/fenrispunk.ttl rename to nodes/fenrispunk.ttl diff --git a/data/file_system.ttl b/nodes/file_system.ttl similarity index 100% rename from data/file_system.ttl rename to nodes/file_system.ttl diff --git a/data/learning_topics.ttl b/nodes/learning_topics.ttl similarity index 100% rename from data/learning_topics.ttl rename to nodes/learning_topics.ttl diff --git a/data/library.ttl b/nodes/library.ttl similarity index 100% rename from data/library.ttl rename to nodes/library.ttl diff --git a/data/license.ttl b/nodes/license.ttl similarity index 100% rename from data/license.ttl rename to nodes/license.ttl diff --git a/data/mimi_and_eunice.ttl b/nodes/mimi_and_eunice.ttl similarity index 100% rename from data/mimi_and_eunice.ttl rename to nodes/mimi_and_eunice.ttl diff --git a/data/operating_system.ttl b/nodes/operating_system.ttl similarity index 100% rename from data/operating_system.ttl rename to nodes/operating_system.ttl diff --git a/data/software.ttl b/nodes/software.ttl similarity index 100% rename from data/software.ttl rename to nodes/software.ttl diff --git a/scripts/documentation/README b/scripts/documentation/README new file mode 100644 index 0000000..430c0b6 --- /dev/null +++ b/scripts/documentation/README @@ -0,0 +1,3 @@ +Compile: + + OUTPUT_PATH= make diff --git a/scripts/documentation/docs/addok/Makefile b/scripts/documentation/docs/addok/Makefile new file mode 100644 index 0000000..8dea151 --- /dev/null +++ b/scripts/documentation/docs/addok/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/addok/addok.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/addok +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.1.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + mkdocs build + mkdir --parents "${OUTPUT_PATH}" + cp --recursive site "${OUTPUT_PATH}/$@" + +1.0.4: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # There is a dependency conflict. requirements-dev.txt defines pytest==7.1.3 but + # pip18 (installed by pyenv) can only find versions up to 7.0.1. Therefore we + # install mkdocs manually, with the version number taken from requirements-dev.txt. + #pip install -r requirements-dev.txt + pip install "mkdocs == 0.17.2" + mkdocs build + mkdir --parents "${OUTPUT_PATH}" + cp --recursive site "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aeon-toolkit/Makefile b/scripts/documentation/docs/aeon-toolkit/Makefile new file mode 100644 index 0000000..bad850e --- /dev/null +++ b/scripts/documentation/docs/aeon-toolkit/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aeon-toolkit/aeon.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aeon-toolkit +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.9.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[all_extras,dl,dev,binder,docs] + mkdir --parents "${OUTPUT_PATH}" + cd docs + make clean + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aerleon/Makefile b/scripts/documentation/docs/aerleon/Makefile new file mode 100644 index 0000000..52ef8b4 --- /dev/null +++ b/scripts/documentation/docs/aerleon/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aerleon/aerleon.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aerleon +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.0.0 1.1.0 1.2.3 1.3.0 1.4.0 1.5.0 1.6.0 1.7.0 1.8.0 1.9.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + # Upgrade mkdocstrings version beacuse the one in requirements.txt doesn't work + pip install "mkdocstrings == 0.25.1" "mkdocstrings-python == 1.10.3" + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiobotocore/Makefile b/scripts/documentation/docs/aiobotocore/Makefile new file mode 100644 index 0000000..2a45d86 --- /dev/null +++ b/scripts/documentation/docs/aiobotocore/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiobotocore.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiobotocore +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.12.0 1.4.2 2.11.1: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiofrozenlist/Makefile b/scripts/documentation/docs/aiofrozenlist/Makefile new file mode 100644 index 0000000..a1de727 --- /dev/null +++ b/scripts/documentation/docs/aiofrozenlist/Makefile @@ -0,0 +1,59 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/frozenlist.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiofrozenlist +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.4.1: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.2.0 v1.3.3: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.0.0 v1.1.1: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt "jinja2 < 3.1" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aioftp/Makefile b/scripts/documentation/docs/aioftp/Makefile new file mode 100644 index 0000000..bf15c1b --- /dev/null +++ b/scripts/documentation/docs/aioftp/Makefile @@ -0,0 +1,46 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aioftp.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aioftp +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.22.3: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +0.9.0 0.10.0 0.10.1 0.11.1 0.12.0 0.13.0 0.14.0 0.15.0 0.16.1 0.17.2 0.18.1 0.19.0 0.20.0 0.21.4: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc-requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp-admin/Makefile b/scripts/documentation/docs/aiohttp-admin/Makefile new file mode 100644 index 0000000..7b18414 --- /dev/null +++ b/scripts/documentation/docs/aiohttp-admin/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp-admin.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp-admin +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.0.4: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-doc.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp-demos/Makefile b/scripts/documentation/docs/aiohttp-demos/Makefile new file mode 100644 index 0000000..9c8af39 --- /dev/null +++ b/scripts/documentation/docs/aiohttp-demos/Makefile @@ -0,0 +1,40 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp-demos.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp-demos +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +# Requires pg_config executable (from libpq-dev) +2024-01-30-17c335ec: check_env_vars venv-3.10 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r requirements-dev.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp-jinja2/Makefile b/scripts/documentation/docs/aiohttp-jinja2/Makefile new file mode 100644 index 0000000..db88bfc --- /dev/null +++ b/scripts/documentation/docs/aiohttp-jinja2/Makefile @@ -0,0 +1,49 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp-jinja2.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp-jinja2 +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.5.1 v1.6: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt -r requirements-dev.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.17.0 v1.4.2: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install "markupsafe == 2.0.1" "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp-mako/Makefile b/scripts/documentation/docs/aiohttp-mako/Makefile new file mode 100644 index 0000000..0a7e2ef --- /dev/null +++ b/scripts/documentation/docs/aiohttp-mako/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp-mako.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp-mako +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.3.0 v1.0.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt sphinx + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp-remotes/Makefile b/scripts/documentation/docs/aiohttp-remotes/Makefile new file mode 100644 index 0000000..2e3de25 --- /dev/null +++ b/scripts/documentation/docs/aiohttp-remotes/Makefile @@ -0,0 +1,65 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp-remotes.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp-remotes +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.0 v1.2.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/dev.txt + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.0.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/dev.txt + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.1.2: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/dev.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp-security/Makefile b/scripts/documentation/docs/aiohttp-security/Makefile new file mode 100644 index 0000000..ab7ee66 --- /dev/null +++ b/scripts/documentation/docs/aiohttp-security/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp-security.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp-security +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.5.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install "sphinx < 4" "jinja2 < 3.1" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp-session/Makefile b/scripts/documentation/docs/aiohttp-session/Makefile new file mode 100644 index 0000000..49b5096 --- /dev/null +++ b/scripts/documentation/docs/aiohttp-session/Makefile @@ -0,0 +1,49 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp-session.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp-session +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.12.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.2.1: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiohttp/Makefile b/scripts/documentation/docs/aiohttp/Makefile new file mode 100644 index 0000000..0f84d49 --- /dev/null +++ b/scripts/documentation/docs/aiohttp/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiohttp.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiohttp +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v3.9.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/base.txt + pip install -r requirements/doc.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiojobs/Makefile b/scripts/documentation/docs/aiojobs/Makefile new file mode 100644 index 0000000..ce17a39 --- /dev/null +++ b/scripts/documentation/docs/aiojobs/Makefile @@ -0,0 +1,64 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiojobs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiojobs +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.0 v1.2.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.0.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.3.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt "jinja2 < 3.1" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiokafka/Makefile b/scripts/documentation/docs/aiokafka/Makefile new file mode 100644 index 0000000..4d6b1d9 --- /dev/null +++ b/scripts/documentation/docs/aiokafka/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiokafka.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiokafka +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.8.1 v0.9.0 v0.10.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-docs.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiomonitor/Makefile b/scripts/documentation/docs/aiomonitor/Makefile new file mode 100644 index 0000000..4931fd1 --- /dev/null +++ b/scripts/documentation/docs/aiomonitor/Makefile @@ -0,0 +1,47 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiomonitor.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiomonitor +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.5.0 v0.6.0 v0.7.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-doc.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.2.1 v0.3.1 v0.4.5: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-doc.txt + pip install "jinja2 < 3.1" "sphinx == 5" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiomultidict/Makefile b/scripts/documentation/docs/aiomultidict/Makefile new file mode 100644 index 0000000..6ec7787 --- /dev/null +++ b/scripts/documentation/docs/aiomultidict/Makefile @@ -0,0 +1,62 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/multidict.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiomultidict +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v6.0.4: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v5.2.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v4.7.6: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt "jinja2 < 3.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiomysql/Makefile b/scripts/documentation/docs/aiomysql/Makefile new file mode 100644 index 0000000..80dfcc2 --- /dev/null +++ b/scripts/documentation/docs/aiomysql/Makefile @@ -0,0 +1,46 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiomysql.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiomysql +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.2.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.1.1: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt "sphinxcontrib-applehelp < 1.0.8" "sphinxcontrib-devhelp < 1.0.6" "sphinxcontrib-htmlhelp < 2.0.5" "sphinxcontrib-serializinghtml < 1.1.10" "sphinxcontrib-qthelp < 1.0.7" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiopg/Makefile b/scripts/documentation/docs/aiopg/Makefile new file mode 100644 index 0000000..9ba2fda --- /dev/null +++ b/scripts/documentation/docs/aiopg/Makefile @@ -0,0 +1,46 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiopg.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiopg +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.4.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.16.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt "jinja2 < 3" "markupsafe == 2.0.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiosignal/Makefile b/scripts/documentation/docs/aiosignal/Makefile new file mode 100644 index 0000000..a1f4e0b --- /dev/null +++ b/scripts/documentation/docs/aiosignal/Makefile @@ -0,0 +1,44 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiosignal.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiosignal +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.2.0 v1.3.1: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt -r requirements/doc-spelling.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.0.0 v1.1.2: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt -r requirements/doc-spelling.txt "jinja2 == 3" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aioyarl/Makefile b/scripts/documentation/docs/aioyarl/Makefile new file mode 100644 index 0000000..8ac50dd --- /dev/null +++ b/scripts/documentation/docs/aioyarl/Makefile @@ -0,0 +1,45 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/yarl.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aioyarl +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.9.4: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + pip install . --config-settings=pure-python=true + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.8.2: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiozipkin/Makefile b/scripts/documentation/docs/aiozipkin/Makefile new file mode 100644 index 0000000..f86d20f --- /dev/null +++ b/scripts/documentation/docs/aiozipkin/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiozipkin.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiozipkin +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.7.1 v1.0.0 v1.1.1: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-doc.txt + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/aiozmq/Makefile b/scripts/documentation/docs/aiozmq/Makefile new file mode 100644 index 0000000..7fa683f --- /dev/null +++ b/scripts/documentation/docs/aiozmq/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/aio-libs/aiozmq.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/aiozmq +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.0.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.9.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt "jinja2 < 3" "markupsafe == 2.0.1" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/alabaster/Makefile b/scripts/documentation/docs/alabaster/Makefile new file mode 100644 index 0000000..a6866da --- /dev/null +++ b/scripts/documentation/docs/alabaster/Makefile @@ -0,0 +1,28 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/sphinx-doc/alabaster.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/alabaster +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.7.10 0.7.11 0.7.12 0.7.13: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r dev-requirements.txt + sphinx-build -b dirhtml docs "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/alakazam/Makefile b/scripts/documentation/docs/alakazam/Makefile new file mode 100644 index 0000000..5ca123c --- /dev/null +++ b/scripts/documentation/docs/alakazam/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://bitbucket.org/kleinstein/alakazam.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/alakazam +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.2.1 1.3.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + mkdocs build + mkdir --parents "${OUTPUT_PATH}" + cp --recursive site "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/alembic/Makefile b/scripts/documentation/docs/alembic/Makefile new file mode 100644 index 0000000..ac7cd19 --- /dev/null +++ b/scripts/documentation/docs/alembic/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/sqlalchemy/alembic.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/alembic +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +rel_1_5_0 rel_1_6_0 rel_1_7_0 rel_1_8_0 rel_1_9_0 rel_1_10_0 rel_1_11_0 rel_1_12_0 rel_1_13_0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r docs/build/requirements.txt + cd docs/build/ + make dirhtml + cp --recursive output/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/amdis/Makefile b/scripts/documentation/docs/amdis/Makefile new file mode 100644 index 0000000..0fabe31 --- /dev/null +++ b/scripts/documentation/docs/amdis/Makefile @@ -0,0 +1,37 @@ +SHELL = /bin/bash + +REPOSITORY = https://gitlab.com/amdis/amdis.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/amdis +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2024-01-23-0e3fed6d: check_env_vars venv-3.9 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r requirements.txt + mkdocs build + mkdir --parents "${OUTPUT_PATH}" + cp --recursive site "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/amplmp/Makefile b/scripts/documentation/docs/amplmp/Makefile new file mode 100644 index 0000000..2e54683 --- /dev/null +++ b/scripts/documentation/docs/amplmp/Makefile @@ -0,0 +1,46 @@ + +################### +# THIS DOESN'T WORK +# GIVES C++ ERRORS +################### + + +SHELL = /bin/bash + +REPOSITORY = https://github.com/ampl/mp.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/amplmp +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# See /intro.html#building-the-documentation for instructions +2024-02-03-9774069e: check_env_vars venv-3.11 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r doc/requirements.txt + mkdir build + cd build + cmake .. + make mp-doc + mkdir --parents "${OUTPUT_PATH}" + cp --recursive . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/amplpy/Makefile b/scripts/documentation/docs/amplpy/Makefile new file mode 100644 index 0000000..18c8b25 --- /dev/null +++ b/scripts/documentation/docs/amplpy/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ampl/amplpy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/amplpy +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.9.3 v0.13.2: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/anndata/Makefile b/scripts/documentation/docs/anndata/Makefile new file mode 100644 index 0000000..9002320 --- /dev/null +++ b/scripts/documentation/docs/anndata/Makefile @@ -0,0 +1,67 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/scverse/anndata.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/anndata +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.10.7: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # This is required to download the "docs/tutorials/notebooks" git submodule + git submodule update --init --recursive + pip install .[doc] matplotlib + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +0.9.2: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # This is required to download the "docs/tutorials/notebooks" git submodule + git submodule update --init --recursive + pip install .[doc] matplotlib + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +0.7.8 0.8.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] matplotlib + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/anyio/Makefile b/scripts/documentation/docs/anyio/Makefile new file mode 100644 index 0000000..05cba8e --- /dev/null +++ b/scripts/documentation/docs/anyio/Makefile @@ -0,0 +1,41 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/agronholm/anyio.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/anyio +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.7.1 4.0.0 4.1.0 4.2.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +3.3.4 3.4.0 3.5.0 3.6.2: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/apache_mod_wsgi/Makefile b/scripts/documentation/docs/apache_mod_wsgi/Makefile new file mode 100644 index 0000000..f4ef25a --- /dev/null +++ b/scripts/documentation/docs/apache_mod_wsgi/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/GrahamDumpleton/mod_wsgi.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/apache_mod_wsgi +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.1.0 4.1.3 4.2.0 4.2.8 4.3.0 4.3.2 4.4.0 4.4.23 4.5.0 4.5.24 4.6.8 4.7.0 4.7.1 4.8.0 4.9.0 4.9.4 5.0.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install sphinx sphinx_rtd_theme + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/apsw/Makefile b/scripts/documentation/docs/apsw/Makefile new file mode 100644 index 0000000..3c07053 --- /dev/null +++ b/scripts/documentation/docs/apsw/Makefile @@ -0,0 +1,34 @@ + + +# THIS IS NOT WORKING, NEEDS FIXING + + +SHELL = /bin/bash + +REPOSITORY = https://github.com/rogerbinns/apsw.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/apsw +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.44.0.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + make docs + #mkdir --parents "${OUTPUT_PATH}" + #cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/arb/Makefile b/scripts/documentation/docs/arb/Makefile new file mode 100644 index 0000000..2445428 --- /dev/null +++ b/scripts/documentation/docs/arb/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/fredrik-johansson/arb.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/arb +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.23.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd doc + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/astropy-astroquery/Makefile b/scripts/documentation/docs/astropy-astroquery/Makefile new file mode 100644 index 0000000..9649c5d --- /dev/null +++ b/scripts/documentation/docs/astropy-astroquery/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/astropy/astroquery.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/astropy-astroquery +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.4.5 v0.4.6: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[all,docs] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/astropy-reproject/Makefile b/scripts/documentation/docs/astropy-reproject/Makefile new file mode 100644 index 0000000..151fd6b --- /dev/null +++ b/scripts/documentation/docs/astropy-reproject/Makefile @@ -0,0 +1,37 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/astropy/reproject.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/astropy-reproject +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.9.1 v0.13.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/astropy/Makefile b/scripts/documentation/docs/astropy/Makefile new file mode 100644 index 0000000..5b99094 --- /dev/null +++ b/scripts/documentation/docs/astropy/Makefile @@ -0,0 +1,45 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/astropy/astropy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/astropy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v5.3.4 v6.0.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[all,docs] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v4.3.1: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/asyncssh/Makefile b/scripts/documentation/docs/asyncssh/Makefile new file mode 100644 index 0000000..ac081fc --- /dev/null +++ b/scripts/documentation/docs/asyncssh/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ronf/asyncssh.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/asyncssh +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.14.2: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install -r docs/rtd-req.txt + pip install "sphinx == 5" + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/autofac/Makefile b/scripts/documentation/docs/autofac/Makefile new file mode 100644 index 0000000..2af0aa6 --- /dev/null +++ b/scripts/documentation/docs/autofac/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/autofac/Documentation.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/autofac +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v6.0.0 v7.0.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v4.0.0 v4.9.4 v5.2.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd docs + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v3.5.2: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/autohotkey-ahk/Makefile b/scripts/documentation/docs/autohotkey-ahk/Makefile new file mode 100644 index 0000000..ad1328f --- /dev/null +++ b/scripts/documentation/docs/autohotkey-ahk/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/spyoungtech/ahk.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/autohotkey-ahk +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.0.0 v1.7.6: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt -r docs/docrequirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/bedops/Makefile b/scripts/documentation/docs/bedops/Makefile new file mode 100644 index 0000000..ef5dc21 --- /dev/null +++ b/scripts/documentation/docs/bedops/Makefile @@ -0,0 +1,47 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/bedops/bedops.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/bedops +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.4.41: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install sphinx + cd docs + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +# This build gives this error: sphinx.ext.mathjax: other math package is already loaded +# I don't know how to fix it, but it compiles if I remove (manually) sphinx.ext.pngmath from docs/conf.py +v2.3.0: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 1.8" + cd docs + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/bigsdb/Makefile b/scripts/documentation/docs/bigsdb/Makefile new file mode 100644 index 0000000..3c2ae7e --- /dev/null +++ b/scripts/documentation/docs/bigsdb/Makefile @@ -0,0 +1,39 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/kjolley/BIGSdb_documentation.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/bigsdb +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.39.0 v1.42.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.9.0 v1.19.0 v1.29.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 5" + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-biothings.api/Makefile b/scripts/documentation/docs/biothings-biothings.api/Makefile new file mode 100644 index 0000000..5bdd60e --- /dev/null +++ b/scripts/documentation/docs/biothings-biothings.api/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/biothings.api.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-biothings.api +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.12.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev] redis + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-clientpy/Makefile b/scripts/documentation/docs/biothings-clientpy/Makefile new file mode 100644 index 0000000..ebcd896 --- /dev/null +++ b/scripts/documentation/docs/biothings-clientpy/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/biothings_client.py.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-clientpy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.2.6 v0.3.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx_rtd_theme + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-mychem.info/Makefile b/scripts/documentation/docs/biothings-mychem.info/Makefile new file mode 100644 index 0000000..114f5ae --- /dev/null +++ b/scripts/documentation/docs/biothings-mychem.info/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/mychem.info.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-mychem.info +else + $(error OUTPUT_PATH is undefined) +endif + +venv-2.7: + export PYENV_VERSION=2.7 + pyenv virtualenv $$PYENV_VERSION venv + +repository: + git clone ${REPOSITORY} repository + +2023-11-14-8520433e: check_env_vars venv-2.7 repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source ~/.pyenv/versions/venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install sphinx sphinx_rtd_theme + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-mydisease.info/Makefile b/scripts/documentation/docs/biothings-mydisease.info/Makefile new file mode 100644 index 0000000..d055fad --- /dev/null +++ b/scripts/documentation/docs/biothings-mydisease.info/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/mydisease.info.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-mydisease.info +else + $(error OUTPUT_PATH is undefined) +endif + +venv-2.7: + export PYENV_VERSION=2.7 + pyenv virtualenv $$PYENV_VERSION venv + +repository: + git clone ${REPOSITORY} repository + +2023-11-28-38d67e0d: check_env_vars venv-2.7 repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source ~/.pyenv/versions/venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install sphinx + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-mygene.info/Makefile b/scripts/documentation/docs/biothings-mygene.info/Makefile new file mode 100644 index 0000000..af562d1 --- /dev/null +++ b/scripts/documentation/docs/biothings-mygene.info/Makefile @@ -0,0 +1,37 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/mygene.info.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-mygene.info +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2023-12-26-cf69777c: check_env_vars venv-3.8 repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + # Lock dependencies because it won't compile with newer versions + pip install "sphinx < 4" sphinx_rtd_theme "jinja2 < 3.1" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-mygeneset.info/Makefile b/scripts/documentation/docs/biothings-mygeneset.info/Makefile new file mode 100644 index 0000000..0c75092 --- /dev/null +++ b/scripts/documentation/docs/biothings-mygeneset.info/Makefile @@ -0,0 +1,37 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/mygeneset.info.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-mygeneset.info +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2023-11-30-a6e751dd: check_env_vars venv-3.8 repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + # Lock dependencies because it won't compile with newer versions + pip install "sphinx < 4" sphinx_rtd_theme "jinja2 < 3.1" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-myvariant.info/Makefile b/scripts/documentation/docs/biothings-myvariant.info/Makefile new file mode 100644 index 0000000..e2c523e --- /dev/null +++ b/scripts/documentation/docs/biothings-myvariant.info/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/myvariant.info.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-myvariant.info +else + $(error OUTPUT_PATH is undefined) +endif + +venv-2.7: + export PYENV_VERSION=2.7 + pyenv virtualenv $$PYENV_VERSION venv + +repository: + git clone ${REPOSITORY} repository + +2023-12-26-643995dd: check_env_vars venv-2.7 repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source ~/.pyenv/versions/venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install sphinx + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/biothings-schemapy/Makefile b/scripts/documentation/docs/biothings-schemapy/Makefile new file mode 100644 index 0000000..9a322fb --- /dev/null +++ b/scripts/documentation/docs/biothings-schemapy/Makefile @@ -0,0 +1,35 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/biothings/biothings_schema.py.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/biothings-schemapy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2023-03-18-fad784fc: check_env_vars venv repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install sphinx + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/bootstrap-datepicker/Makefile b/scripts/documentation/docs/bootstrap-datepicker/Makefile new file mode 100644 index 0000000..cd84e9b --- /dev/null +++ b/scripts/documentation/docs/bootstrap-datepicker/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/uxsolutions/bootstrap-datepicker.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/bootstrap-datepicker +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.4.1 v1.5.1 v1.6.0 v1.6.4 v1.7.0 v1.7.1 v1.8.0 v1.9.0 v1.10.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/borg-backup/Makefile b/scripts/documentation/docs/borg-backup/Makefile new file mode 100644 index 0000000..af31f71 --- /dev/null +++ b/scripts/documentation/docs/borg-backup/Makefile @@ -0,0 +1,45 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/borgbackup/borg.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/borg-backup +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.2.7: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.d/development.lock.txt + pip install -r requirements.d/docs.txt + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.1.18: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.d/development.lock.txt + pip install -r requirements.d/docs.txt "sphinx < 6" + pip install -e . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/boris/Makefile b/scripts/documentation/docs/boris/Makefile new file mode 100644 index 0000000..68e2531 --- /dev/null +++ b/scripts/documentation/docs/boris/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/olivierfriard/boris_docs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/boris +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2024-01-27-123c9fbe: check_env_vars venv-3.10 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r docs/requirements.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml -c docs . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/bottlepy/Makefile b/scripts/documentation/docs/bottlepy/Makefile new file mode 100644 index 0000000..560c44d --- /dev/null +++ b/scripts/documentation/docs/bottlepy/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/bottlepy/bottle.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/bottlepy +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.12.25: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install setuptools wheel twine coverage sphinx sphinx-intl transifex-client + make docs + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/docs/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/breathe/Makefile b/scripts/documentation/docs/breathe/Makefile new file mode 100644 index 0000000..bf1ab6d --- /dev/null +++ b/scripts/documentation/docs/breathe/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/breathe-doc/breathe.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/breathe +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v4.32.0 v4.33.1 v4.34.0 v4.35.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/development.txt + make data + cd documentation + make dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/buildbot/Makefile b/scripts/documentation/docs/buildbot/Makefile new file mode 100644 index 0000000..eb1ea7e --- /dev/null +++ b/scripts/documentation/docs/buildbot/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/buildbot/buildbot.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/buildbot +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v3.9.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -e master[docs] + cd master/docs/ + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ceph/Makefile b/scripts/documentation/docs/ceph/Makefile new file mode 100644 index 0000000..2c761a5 --- /dev/null +++ b/scripts/documentation/docs/ceph/Makefile @@ -0,0 +1,27 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ceph/ceph.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ceph +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +v0.94.10 v9.2.1 v10.2.11 v11.2.1 v12.2.14 v13.2.10 v14.2.22 v15.2.17 v16.2.14 v17.2.7: check_env_vars repository + cd repository + git checkout tags/$@ + sudo apt-get install `cat doc_deps.deb.txt` + admin/build-doc + mkdir --parents "${OUTPUT_PATH}" + # They build sphinx "dirhtml" by default + cp --recursive build-doc/output/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/certbot/Makefile b/scripts/documentation/docs/certbot/Makefile new file mode 100644 index 0000000..716d4c9 --- /dev/null +++ b/scripts/documentation/docs/certbot/Makefile @@ -0,0 +1,29 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/certbot/certbot.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/certbot +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.0.0 v2.7.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install certbot[docs] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml certbot/docs "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ckan/Makefile b/scripts/documentation/docs/ckan/Makefile new file mode 100644 index 0000000..559bf1b --- /dev/null +++ b/scripts/documentation/docs/ckan/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ckan/ckan.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ckan +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + # Requires Python 3.7 + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# Requires pg_config (libpq-dev in Debian) +ckan-2.9.10 ckan-2.10.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-docs.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml doc/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/cltk/Makefile b/scripts/documentation/docs/cltk/Makefile new file mode 100644 index 0000000..a1485a2 --- /dev/null +++ b/scripts/documentation/docs/cltk/Makefile @@ -0,0 +1,50 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cltk/cltk.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/cltk +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.7: + # Requires "_sqlite3" module to compile. + # Install libsqlite3-dev (Debian) and then rebuild Python with "pyenv install 3.7" + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.7 v1.2.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.0.15: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # Lock jinja2 because the docs uses deprecated calls + pip install -r docs/requirements.txt "jinja2 < 3.1" + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/cookiecutter/Makefile b/scripts/documentation/docs/cookiecutter/Makefile new file mode 100644 index 0000000..1f5b878 --- /dev/null +++ b/scripts/documentation/docs/cookiecutter/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cookiecutter/cookiecutter.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/cookiecutter +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.7.3 2.5.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/coreboot/Makefile b/scripts/documentation/docs/coreboot/Makefile new file mode 100644 index 0000000..fa22723 --- /dev/null +++ b/scripts/documentation/docs/coreboot/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://review.coreboot.org/coreboot.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/coreboot +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.22.01: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # They don't have a "requirements" file for pip. Dependencies taken from /Documentation/getting_started/writing_documentation.md + pip install sphinx recommonmark sphinx_rtd_theme sphinxcontrib-ditaa + cd Documentation + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/couchdb/Makefile b/scripts/documentation/docs/couchdb/Makefile new file mode 100644 index 0000000..0f4e7ad --- /dev/null +++ b/scripts/documentation/docs/couchdb/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/apache/couchdb.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/couchdb +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.3.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + cd src/docs/ + pip3 install -r requirements.txt +# couchdb only has Makefile rules for "html", but not "dirhtml". Therefore, instead of +# calling "make dirhtml" we call sphinx-build directly + sphinx-build -b dirhtml src "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/cratedb/Makefile b/scripts/documentation/docs/cratedb/Makefile new file mode 100644 index 0000000..fbfe593 --- /dev/null +++ b/scripts/documentation/docs/cratedb/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/crate/crate.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/cratedb +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.8.4 5.5.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/cython/Makefile b/scripts/documentation/docs/cython/Makefile new file mode 100644 index 0000000..1e1f020 --- /dev/null +++ b/scripts/documentation/docs/cython/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cython/cython.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/cython +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.29.36 3.0.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc-requirements.txt + pip install . + cd docs + make dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/dallinger/Makefile b/scripts/documentation/docs/dallinger/Makefile new file mode 100644 index 0000000..e3605ad --- /dev/null +++ b/scripts/documentation/docs/dallinger/Makefile @@ -0,0 +1,38 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Dallinger/Dallinger.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/dallinger +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v9.12.0 v10.0.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r dev-requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/dask/Makefile b/scripts/documentation/docs/dask/Makefile new file mode 100644 index 0000000..e2f2d50 --- /dev/null +++ b/scripts/documentation/docs/dask/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/dask/dask.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/dask +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2023.12.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements-docs.txt + cd docs + make dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ddev/Makefile b/scripts/documentation/docs/ddev/Makefile new file mode 100644 index 0000000..1fae84d --- /dev/null +++ b/scripts/documentation/docs/ddev/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ddev/ddev.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ddev +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.22.7 v1.23.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/setuptools.txt + pip install -r docs/mkdocs-pip-requirements + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +v1.19.5: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/mkdocs-pip-requirements + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/designpatternsphp/Makefile b/scripts/documentation/docs/designpatternsphp/Makefile new file mode 100644 index 0000000..ea9755e --- /dev/null +++ b/scripts/documentation/docs/designpatternsphp/Makefile @@ -0,0 +1,38 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/DesignPatternsPHP/DesignPatternsPHP.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/designpatternsphp +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2023-09-28-13af79cc: check_env_vars venv-3.11 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r requirements.txt + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/discord.py/Makefile b/scripts/documentation/docs/discord.py/Makefile new file mode 100644 index 0000000..18b155c --- /dev/null +++ b/scripts/documentation/docs/discord.py/Makefile @@ -0,0 +1,46 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Rapptz/discord.py.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/discord.py +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.3.2: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.7.3: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] "jinja2 < 3.1" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/django-asgiref/Makefile b/scripts/documentation/docs/django-asgiref/Makefile new file mode 100644 index 0000000..f4a0103 --- /dev/null +++ b/scripts/documentation/docs/django-asgiref/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/django/asgiref.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/django-asgiref +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.1.4 3.2.10 3.3.4 3.4.1 3.5.2 3.6.0 3.7.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/django-channels/Makefile b/scripts/documentation/docs/django-channels/Makefile new file mode 100644 index 0000000..6b6117b --- /dev/null +++ b/scripts/documentation/docs/django-channels/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/django/channels.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/django-channels +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.17.3 1.1.8.1 2.4.0 3.0.0 3.0.1 3.0.2 3.0.3 3.0.4 3.0.5 4.0.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/django-cms/Makefile b/scripts/documentation/docs/django-cms/Makefile new file mode 100644 index 0000000..43a3618 --- /dev/null +++ b/scripts/documentation/docs/django-cms/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/django-cms/django-cms.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/django-cms +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.1.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +3.11.4: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/django-hijack/Makefile b/scripts/documentation/docs/django-hijack/Makefile new file mode 100644 index 0000000..ecce6d0 --- /dev/null +++ b/scripts/documentation/docs/django-hijack/Makefile @@ -0,0 +1,42 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/django-hijack/django-hijack.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/django-hijack +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.4.5: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +# The mkdocs.yml file is in docs/ but for some reasons it's only building the documentation +# correctly when compiling from the root folder, that's why we copy docs/mkdocs.yml before +# building the docs +2.3.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt "mkdocs < 1.3" + mkdir --parents "${OUTPUT_PATH}" + cp docs/mkdocs.yml . + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/django/Makefile b/scripts/documentation/docs/django/Makefile new file mode 100644 index 0000000..3a36be5 --- /dev/null +++ b/scripts/documentation/docs/django/Makefile @@ -0,0 +1,42 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/django/django.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/django +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.2.23 4.2.8 5.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}/en" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/en/$@" + +2.2.28: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "sphinx < 6" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}/en" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/en/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/easybuild-tutorial/Makefile b/scripts/documentation/docs/easybuild-tutorial/Makefile new file mode 100644 index 0000000..b0c0168 --- /dev/null +++ b/scripts/documentation/docs/easybuild-tutorial/Makefile @@ -0,0 +1,37 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/easybuilders/easybuild-tutorial.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/easybuild-tutorial +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't have any tags, therefore we checkout specific commits. +# The date is the commit's date. +2023-04-28-8e6e147c: check_env_vars venv repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout $${commit_hash} + # Installation instructions from README + pip install mkdocs mkdocs-material mkdocs-git-revision-date-localized-plugin mkdocs-redirects + mkdocs build + cp --recursive site "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/easybuild/Makefile b/scripts/documentation/docs/easybuild/Makefile new file mode 100644 index 0000000..603f610 --- /dev/null +++ b/scripts/documentation/docs/easybuild/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/easybuilders/easybuild-docs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/easybuild +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't have any tags, therefore we checkout specific commits. +# The date is the commit's date. +2023-10-29-4b663dfc: check_env_vars venv repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r requirements.txt + mkdocs build + cp --recursive site "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/emcee/Makefile b/scripts/documentation/docs/emcee/Makefile new file mode 100644 index 0000000..9cd686a --- /dev/null +++ b/scripts/documentation/docs/emcee/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/dfm/emcee.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/emcee +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v3.1.0 v3.1.1 v3.1.2 v3.1.3 v3.1.4: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/enzoamr-e/Makefile b/scripts/documentation/docs/enzoamr-e/Makefile new file mode 100644 index 0000000..a81b4eb --- /dev/null +++ b/scripts/documentation/docs/enzoamr-e/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/enzo-project/enzo-e.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/enzoamr-e +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +enzoe-1.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc/source/requirements.txt "sphinx < 8" "sphinx_rtd_theme" + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/enzoamr/Makefile b/scripts/documentation/docs/enzoamr/Makefile new file mode 100644 index 0000000..5ada1c8 --- /dev/null +++ b/scripts/documentation/docs/enzoamr/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/enzo-project/enzo-dev.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/enzoamr +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# Requires package "dvipng" +enzo-2.6.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 6" + cd doc/manual/ + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ezdxf/Makefile b/scripts/documentation/docs/ezdxf/Makefile new file mode 100644 index 0000000..382ccb3 --- /dev/null +++ b/scripts/documentation/docs/ezdxf/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozman/ezdxf.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ezdxf +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.4: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install -r requirements.txt + pip install -r requirements-dev.txt + pip install . + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml source/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/faucet/Makefile b/scripts/documentation/docs/faucet/Makefile new file mode 100644 index 0000000..78e9b0c --- /dev/null +++ b/scripts/documentation/docs/faucet/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/faucetsdn/faucet.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/faucet +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.10.10: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.8.37 1.9.55: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "docutils < 0.17" + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/firesim/Makefile b/scripts/documentation/docs/firesim/Makefile new file mode 100644 index 0000000..7a2e604 --- /dev/null +++ b/scripts/documentation/docs/firesim/Makefile @@ -0,0 +1,38 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/firesim/firesim.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/firesim +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repository uses the Conda environment manager. +# No matter what I try, I cannot get it to work!!!!!!!! I think it worked once, but then +# it gave me more errors when building from a Makefile. +# For this reason all the dependencies are installed manually with pip (list of dependencies +# extracted from conda-reqs/docs.yaml). +1.17.1 : check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install pygments "sphinx < 7" sphinx_autobuild "sphinx_rtd_theme < 1.2.0" requests sphinx_tabs sphinx_copybutton sphinx_substitution_extensions + cd docs + # Cannot run "make clean" because it only removes _build/html/* + rm -rf _build/ + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/flake8/Makefile b/scripts/documentation/docs/flake8/Makefile new file mode 100644 index 0000000..b31cc51 --- /dev/null +++ b/scripts/documentation/docs/flake8/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/PyCQA/flake8.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/flake8 +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +5.0.4 6.0.0 6.1.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/source/requirements.txt + pip install . + sphinx-build -b dirhtml docs/source/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/flask-limiter/Makefile b/scripts/documentation/docs/flask-limiter/Makefile new file mode 100644 index 0000000..04a078b --- /dev/null +++ b/scripts/documentation/docs/flask-limiter/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/alisaifee/flask-limiter.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/flask-limiter +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.9.2 3.0.0 3.5.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/flask/Makefile b/scripts/documentation/docs/flask/Makefile new file mode 100644 index 0000000..22dfbf9 --- /dev/null +++ b/scripts/documentation/docs/flask/Makefile @@ -0,0 +1,66 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pallets/flask.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/flask +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.3.3 3.0.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.1.4: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "markupsafe == 2.0.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +0.12.5: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/flexmock/Makefile b/scripts/documentation/docs/flexmock/Makefile new file mode 100644 index 0000000..a1b5d40 --- /dev/null +++ b/scripts/documentation/docs/flexmock/Makefile @@ -0,0 +1,52 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/flexmock/flexmock.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/flexmock +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.12.1: check_env_vars venv-3.8 repository + export PYENV_VERSION=3.8 + source venv/bin/activate + cd repository + git checkout tags/$@ + poetry install + mkdir --parents "${OUTPUT_PATH}" + poetry run mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +0.11.3: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +0.10.10: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install sphinx + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/flycheck/Makefile b/scripts/documentation/docs/flycheck/Makefile new file mode 100644 index 0000000..09a41c2 --- /dev/null +++ b/scripts/documentation/docs/flycheck/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/flycheck/flycheck.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/flycheck +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +32: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc/requirements.txt + cd doc + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/gabbi/Makefile b/scripts/documentation/docs/gabbi/Makefile new file mode 100644 index 0000000..478ffc7 --- /dev/null +++ b/scripts/documentation/docs/gabbi/Makefile @@ -0,0 +1,42 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cdent/gabbi.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/gabbi +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.49.0 2.0.4 2.1.0 2.2.0 2.3.4 2.4.0 2.5.0 2.6.0 2.7.2 2.8.0 2.9.0 2.10.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r requirements-dev.txt + pip install -r test-requirements.txt + cd docs/source/ + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +0.101.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r test-requirements.txt + cd docs/source/ + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/geotrek-admin/Makefile b/scripts/documentation/docs/geotrek-admin/Makefile new file mode 100644 index 0000000..fac82f3 --- /dev/null +++ b/scripts/documentation/docs/geotrek-admin/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/GeotrekCE/Geotrek-admin.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/geotrek-admin +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.49.0 2.59.0 2.69.0 2.79.0 2.89.1 2.99.0 2.101.5: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/gevent/Makefile b/scripts/documentation/docs/gevent/Makefile new file mode 100644 index 0000000..92548d5 --- /dev/null +++ b/scripts/documentation/docs/gevent/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/gevent/gevent.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/gevent +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +23.9.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +22.10.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + # Lock version because it won't compile with sphin==6 + pip install "sphinx < 6" furo + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ghc/Makefile b/scripts/documentation/docs/ghc/Makefile new file mode 100644 index 0000000..7564744 --- /dev/null +++ b/scripts/documentation/docs/ghc/Makefile @@ -0,0 +1,29 @@ +SHELL = /bin/bash + +REPOSITORY = https://gitlab.haskell.org/ghc/ghc.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ghc +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-docs.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml doc/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/gokapi/Makefile b/scripts/documentation/docs/gokapi/Makefile new file mode 100644 index 0000000..b0925d5 --- /dev/null +++ b/scripts/documentation/docs/gokapi/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Forceu/Gokapi.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/gokapi +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.8.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.3.1 v1.5.2 v1.6.2 v1.7.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx_rtd_theme + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/guzzle/Makefile b/scripts/documentation/docs/guzzle/Makefile new file mode 100644 index 0000000..bb0e887 --- /dev/null +++ b/scripts/documentation/docs/guzzle/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/guzzle/guzzle.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/guzzle +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.2.4 5.3.4 6.0.2 6.1.1 6.2.3 6.3.3 6.4.1 6.5.5 7.0.1 7.1.1 7.2.0 7.3.0 7.4.5 7.5.3 7.6.1 7.7.1 7.8.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install -r requirements.txt + # Must upgrade because it doesn't compile with the version in the requirements.txt + pip install --upgrade sphinx sphinx_rtd_theme + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/h5py/Makefile b/scripts/documentation/docs/h5py/Makefile new file mode 100644 index 0000000..458998e --- /dev/null +++ b/scripts/documentation/docs/h5py/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/h5py/h5py.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/h5py +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.7.0 3.8.0 3.9.0 3.10.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements-rtd.txt + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/idris-lang/Makefile b/scripts/documentation/docs/idris-lang/Makefile new file mode 100644 index 0000000..4cce1b7 --- /dev/null +++ b/scripts/documentation/docs/idris-lang/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/idris-lang/Idris-dev.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/idris-lang +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.3.2 v1.3.3 v1.3.4: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx-rtd-theme + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ipython/Makefile b/scripts/documentation/docs/ipython/Makefile new file mode 100644 index 0000000..f356fb9 --- /dev/null +++ b/scripts/documentation/docs/ipython/Makefile @@ -0,0 +1,35 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ipython/ipython.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ipython +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# Requies graphviz +7.34.0 8.25.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/itsdangerous/Makefile b/scripts/documentation/docs/itsdangerous/Makefile new file mode 100644 index 0000000..44cdf06 --- /dev/null +++ b/scripts/documentation/docs/itsdangerous/Makefile @@ -0,0 +1,62 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pallets/itsdangerous.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/itsdangerous +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.1.2: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.1.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "jinja2 < 3" "markupsafe == 2.0.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +0.24: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx "jinja2 < 3" "markupsafe == 2.0.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/jinja2/Makefile b/scripts/documentation/docs/jinja2/Makefile new file mode 100644 index 0000000..1703b2b --- /dev/null +++ b/scripts/documentation/docs/jinja2/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pallets/jinja.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/jinja2 +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.1.0: check_env_vars venv repository + source venv/bin/activate + mkdir --parents "${OUTPUT_PATH}" + cd repository + git checkout tags/$@ + pip install -r requirements/dev.txt + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/jsonpickle/Makefile b/scripts/documentation/docs/jsonpickle/Makefile new file mode 100644 index 0000000..5a60353 --- /dev/null +++ b/scripts/documentation/docs/jsonpickle/Makefile @@ -0,0 +1,42 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jsonpickle/jsonpickle.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/jsonpickle +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v3.0.3 v3.0.4: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +v1.5.2 v2.0.0 v2.1.0 v2.2.0 v3.0.0 v3.0.1 v3.0.2: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/jupyter-notebook/Makefile b/scripts/documentation/docs/jupyter-notebook/Makefile new file mode 100644 index 0000000..78259d7 --- /dev/null +++ b/scripts/documentation/docs/jupyter-notebook/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jupyter/notebook.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/jupyter-notebook +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# For this to compile, it requires node.js and pandoc to be installed (packages +# "node-base" and "pandoc" in Debian). +v7.0.0 v7.0.6: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/jupyter-sphinx/Makefile b/scripts/documentation/docs/jupyter-sphinx/Makefile new file mode 100644 index 0000000..b9599db --- /dev/null +++ b/scripts/documentation/docs/jupyter-sphinx/Makefile @@ -0,0 +1,55 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jupyter/jupyter-sphinx.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/jupyter-sphinx +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.5.3: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +v0.4.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +v0.3.2: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt "jinja2 < 3.1" + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/jupyter-tutorial/Makefile b/scripts/documentation/docs/jupyter-tutorial/Makefile new file mode 100644 index 0000000..854df65 --- /dev/null +++ b/scripts/documentation/docs/jupyter-tutorial/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/veit/jupyter-tutorial.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/jupyter-tutorial +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}/en" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/en/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/jupyterhub-repo2docker/Makefile b/scripts/documentation/docs/jupyterhub-repo2docker/Makefile new file mode 100644 index 0000000..970b6ba --- /dev/null +++ b/scripts/documentation/docs/jupyterhub-repo2docker/Makefile @@ -0,0 +1,50 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jupyterhub/repo2docker.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/jupyterhub-repo2docker +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2023.06.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install matplotlib + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +2021.08.0 2022.10.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/doc-requirements.txt + pip install matplotlib + pip install . + cd docs/source/ + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/jupyterhub/Makefile b/scripts/documentation/docs/jupyterhub/Makefile new file mode 100644 index 0000000..9cdc492 --- /dev/null +++ b/scripts/documentation/docs/jupyterhub/Makefile @@ -0,0 +1,64 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jupyterhub/jupyterhub.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/jupyterhub +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.0.2: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r docs/requirements.txt + pip install matplotlib + pip install -e . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +2.3.1 3.1.1: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r docs/requirements.txt + pip install matplotlib + pip install -e . + cd docs/source/ + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +1.5.1: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r docs/requirements.txt + pip install matplotlib + pip install -e . + cd docs/source/ + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/latexindent.pl/Makefile b/scripts/documentation/docs/latexindent.pl/Makefile new file mode 100644 index 0000000..b4c8327 --- /dev/null +++ b/scripts/documentation/docs/latexindent.pl/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cmhughes/latexindent.pl.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/latexindent.pl +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +V3.20.6 V3.21.1 V3.22.2 V3.23: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r documentation/requirements.txt + # Manually install theme because it's giving a "configuration error" + pip install sphinx-rtd-theme + cd documentation + make dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ldap3/Makefile b/scripts/documentation/docs/ldap3/Makefile new file mode 100644 index 0000000..b229ce7 --- /dev/null +++ b/scripts/documentation/docs/ldap3/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cannatag/ldap3.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ldap3 +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.9.1: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r requirements-dev.txt + pip install -r docs/manual/requirements.txt + pip install . + cd docs/manual/ + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/libtmux/Makefile b/scripts/documentation/docs/libtmux/Makefile new file mode 100644 index 0000000..8812d8c --- /dev/null +++ b/scripts/documentation/docs/libtmux/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/tmux-python/libtmux.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/libtmux +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.19.1 v0.25.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + poetry install + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/linguistica-lxa5/Makefile b/scripts/documentation/docs/linguistica-lxa5/Makefile new file mode 100644 index 0000000..e8855fe --- /dev/null +++ b/scripts/documentation/docs/linguistica-lxa5/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/linguistica-uchicago/lxa5.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/linguistica-lxa5 +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v5.2.1: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r dev-requirements.txt + pip install . + cd docs/sources/ + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/lmod/Makefile b/scripts/documentation/docs/lmod/Makefile new file mode 100644 index 0000000..7b2fe6f --- /dev/null +++ b/scripts/documentation/docs/lmod/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/TACC/Lmod.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/lmod +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +8.6 8.7: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + # Upgrade sphinx because it's pinned to v1 in the requirements, but it isn't compiling. + pip install --upgrade sphinx + cd docs + make dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +6.6 7.8: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd docs + make dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mahotas/Makefile b/scripts/documentation/docs/mahotas/Makefile new file mode 100644 index 0000000..a971a22 --- /dev/null +++ b/scripts/documentation/docs/mahotas/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/luispedro/mahotas.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mahotas +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.4.15: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r readthedocs-requirements.txt + pip install . + mkdir --parents "${OUTPUT_PATH}" + cd docs + sphinx-build -b dirhtml source _output + cp --recursive _output "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/markupsafe/Makefile b/scripts/documentation/docs/markupsafe/Makefile new file mode 100644 index 0000000..074bb47 --- /dev/null +++ b/scripts/documentation/docs/markupsafe/Makefile @@ -0,0 +1,62 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pallets/markupsafe.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/markupsafe +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.1.4: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +2.0.1: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.1.1: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "jinja2 < 3" "markupsafe == 2.0.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mathjax/Makefile b/scripts/documentation/docs/mathjax/Makefile new file mode 100644 index 0000000..ec7cdba --- /dev/null +++ b/scripts/documentation/docs/mathjax/Makefile @@ -0,0 +1,38 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mathjax/MathJax-docs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mathjax +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repository uses branches instead of tags +v3.2-latest: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git switch $@ + pip install sphinx sphinx-rtd-theme + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v1.0 v1.1-latest v2.0-latest v2.1-latest v2.2-latest v2.3-latest v2.4-latest v2.5-latest v2.6-latest v2.7-latest v3.0-latest v3.1-latest: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git switch $@ + pip install "sphinx < 6" sphinx-rtd-theme + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/matplotlib-adjusttext/Makefile b/scripts/documentation/docs/matplotlib-adjusttext/Makefile new file mode 100644 index 0000000..12294d3 --- /dev/null +++ b/scripts/documentation/docs/matplotlib-adjusttext/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Phlya/adjustText.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/matplotlib-adjusttext +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.8.1 v1.0 v1.0.4 v1.1.1: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mediagoblin/Makefile b/scripts/documentation/docs/mediagoblin/Makefile new file mode 100644 index 0000000..0939302 --- /dev/null +++ b/scripts/documentation/docs/mediagoblin/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://git.savannah.gnu.org/git/mediagoblin.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mediagoblin +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.3.0 v0.4.0 v0.5.0 v0.6.0 v0.7.0 v0.8.0 v0.9.0 v0.10.0 v0.11.0 v0.12.0 v0.13.0: check_env_vars venv repository + source venv/bin/activate + pip install sphinx + cd repository + git checkout tags/$@ + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mesa3d/Makefile b/scripts/documentation/docs/mesa3d/Makefile new file mode 100644 index 0000000..e50a53a --- /dev/null +++ b/scripts/documentation/docs/mesa3d/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://gitlab.freedesktop.org/mesa/mesa.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mesa3d +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# build dependencies taken from docs/submittingpatches.rst +# requires system packages: coreutils graphviz clang-dev python3-clang musl-dev linux-headers +mesa-23.3.6: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx == 5.1" "mako == 1.2" "hawkmoth == 0.16" clang breathe + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mila-docs/Makefile b/scripts/documentation/docs/mila-docs/Makefile new file mode 100644 index 0000000..0b04a5c --- /dev/null +++ b/scripts/documentation/docs/mila-docs/Makefile @@ -0,0 +1,41 @@ + +#### THIS IS NOT PUBLISHED +#### CHECK LICENSE: IS THIS FREE??? + +SHELL = /bin/bash + +REPOSITORY = https://github.com/mila-iqia/mila-docs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mila-docs +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't have any tags, therefore we checkout specific commits. +# The date is the commit's date. +2023-11-15-e0d16646: check_env_vars venv repository + # Extract hash id + commit_hash=$@ + commit_hash=$${commit_hash:11} + + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r docs/requirements.txt + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mkdocs/Makefile b/scripts/documentation/docs/mkdocs/Makefile new file mode 100644 index 0000000..04eeef6 --- /dev/null +++ b/scripts/documentation/docs/mkdocs/Makefile @@ -0,0 +1,40 @@ + + + + +THIS DOESN'T WORK NEEDS CHECKING + + + + +SHELL = /bin/bash + +REPOSITORY = https://github.com/mkdocs/mkdocs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mkdocs +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.5.3: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install mkdocs pymdown-extensions + mkdocs build + mkdir --parents "${OUTPUT_PATH}" + cp --recursive site "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mmaction2/Makefile b/scripts/documentation/docs/mmaction2/Makefile new file mode 100644 index 0000000..0f815c6 --- /dev/null +++ b/scripts/documentation/docs/mmaction2/Makefile @@ -0,0 +1,40 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/open-mmlab/mmaction2.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mmaction2 +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.2.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + pip install -r requirements/readthedocs.txt + cd docs + mkdir --parents "${OUTPUT_PATH}/en" + mkdir --parents "${OUTPUT_PATH}/zh_cn" + cd en + make clean + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/en/$@" + cd ../zh_cn + make clean + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/zh_cn/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mockery/Makefile b/scripts/documentation/docs/mockery/Makefile new file mode 100644 index 0000000..8fadc86 --- /dev/null +++ b/scripts/documentation/docs/mockery/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mockery/mockery.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mockery +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.6.7: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install -r requirements.txt + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mopidy/Makefile b/scripts/documentation/docs/mopidy/Makefile new file mode 100644 index 0000000..544ceec --- /dev/null +++ b/scripts/documentation/docs/mopidy/Makefile @@ -0,0 +1,35 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mopidy/mopidy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mopidy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This requires some dependencies before it can compile. +# - libcairo2-dev +# - libgirepository1.0-dev +# - libgraphviz-dev +v3.4.2: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-addons-frontend/Makefile b/scripts/documentation/docs/mozilla-addons-frontend/Makefile new file mode 100644 index 0000000..7e3e7c0 --- /dev/null +++ b/scripts/documentation/docs/mozilla-addons-frontend/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/addons-frontend.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-addons-frontend +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2018.12.18-2 2019.12.12 2020.12.10 2021.12.09 2022.12.08 2023.12.14 2024.05.30: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install mkdocs + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-addons-server/Makefile b/scripts/documentation/docs/mozilla-addons-server/Makefile new file mode 100644 index 0000000..4f84ab1 --- /dev/null +++ b/scripts/documentation/docs/mozilla-addons-server/Makefile @@ -0,0 +1,58 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/addons-server.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-addons-server +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# There is a requirements file in /requirements/dev.txt but it's not working. When doing +# "pip install -r requirements/dev.txt" it always gives a --required-hashes error. For +# this reasons the dependencies are installed manually +2024.05.30: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx-rtd-theme sphinxcontrib-httpdomain myst-parser + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +2023.12.14: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +# There is a requirements file in /requirements/docs.txt but it's not working. When doing +# "pip install -r requirements/docs.txt" it always gives a --required-hashes error. For +# this reasons the dependencies are installed manually +2021.12.09-1 2022.12.08-2: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx-rtd-theme sphinxcontrib-httpdomain + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-addons/Makefile b/scripts/documentation/docs/mozilla-addons/Makefile new file mode 100644 index 0000000..c21bc64 --- /dev/null +++ b/scripts/documentation/docs/mozilla-addons/Makefile @@ -0,0 +1,39 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/addons.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-addons +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2024-05-29-a0565091: check_env_vars venv-3.11 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r requirements/docs.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-bedrock/Makefile b/scripts/documentation/docs/mozilla-bedrock/Makefile new file mode 100644 index 0000000..584301e --- /dev/null +++ b/scripts/documentation/docs/mozilla-bedrock/Makefile @@ -0,0 +1,46 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/bedrock.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-bedrock +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2024-05-22: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +2021-12-22 2022-12-20 2023-12-14.1: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-bleach/Makefile b/scripts/documentation/docs/mozilla-bleach/Makefile new file mode 100644 index 0000000..8f8006b --- /dev/null +++ b/scripts/documentation/docs/mozilla-bleach/Makefile @@ -0,0 +1,90 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/bleach.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-bleach +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v6.1.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install tinycss2 + pip install . + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v5.0.1: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install "sphinxcontrib-applehelp == 1.0.7" + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v4.1.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install . + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v3.3.1: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install . + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v2.1.4: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt + pip install . + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-dennis/Makefile b/scripts/documentation/docs/mozilla-dennis/Makefile new file mode 100644 index 0000000..0bcaf64 --- /dev/null +++ b/scripts/documentation/docs/mozilla-dennis/Makefile @@ -0,0 +1,46 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/dennis.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-dennis +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.9: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-django-csp/Makefile b/scripts/documentation/docs/mozilla-django-csp/Makefile new file mode 100644 index 0000000..a1bcdc5 --- /dev/null +++ b/scripts/documentation/docs/mozilla-django-csp/Makefile @@ -0,0 +1,82 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/django-csp.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-django-csp +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.8: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +3.7: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +3.3 3.4 3.5: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v2.0.3 v3.0 3.1 3.2: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-django-oidc/Makefile b/scripts/documentation/docs/mozilla-django-oidc/Makefile new file mode 100644 index 0000000..7aad602 --- /dev/null +++ b/scripts/documentation/docs/mozilla-django-oidc/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/mozilla-django-oidc.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-django-oidc +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.2.4 2.0.0 3.0.0 4.0.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/requirements_dev.txt + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-frost/Makefile b/scripts/documentation/docs/mozilla-frost/Makefile new file mode 100644 index 0000000..b517aa8 --- /dev/null +++ b/scripts/documentation/docs/mozilla-frost/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/frost.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-frost +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.4.7: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "jinja2 < 3.1" + make doc-build + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-kitsune/Makefile b/scripts/documentation/docs/mozilla-kitsune/Makefile new file mode 100644 index 0000000..1415141 --- /dev/null +++ b/scripts/documentation/docs/mozilla-kitsune/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/kitsune.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-kitsune +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.0.0 1.0.1 1.0.2 1.0.3: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx mkdocs-material + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-normandy/Makefile b/scripts/documentation/docs/mozilla-normandy/Makefile new file mode 100644 index 0000000..b75995c --- /dev/null +++ b/scripts/documentation/docs/mozilla-normandy/Makefile @@ -0,0 +1,35 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/normandy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-normandy +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.147.0: check_env_vars venv-3.9 repository + source venv/bin/activate + export PYENV_VERSION=3.9 + cd repository + git checkout tags/$@ + poetry install + poetry run pip install .[docs] + cd docs + poetry run make clean + poetry run make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-pontoon/Makefile b/scripts/documentation/docs/mozilla-pontoon/Makefile new file mode 100644 index 0000000..9a5b7ee --- /dev/null +++ b/scripts/documentation/docs/mozilla-pontoon/Makefile @@ -0,0 +1,39 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/pontoon.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-pontoon +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2024-05-22-fadf6976: check_env_vars venv-3.11 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mozilla-treeherder/Makefile b/scripts/documentation/docs/mozilla-treeherder/Makefile new file mode 100644 index 0000000..3407179 --- /dev/null +++ b/scripts/documentation/docs/mozilla-treeherder/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mozilla/treeherder.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mozilla-treeherder +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2024-05-29-96e7651f: check_env_vars venv-3.11 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install .[docs] + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mriqc/Makefile b/scripts/documentation/docs/mriqc/Makefile new file mode 100644 index 0000000..2bb105d --- /dev/null +++ b/scripts/documentation/docs/mriqc/Makefile @@ -0,0 +1,50 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/nipreps/mriqc.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mriqc +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +23.1.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +22.0.6: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + pip install "sphinx == 5" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/music21/Makefile b/scripts/documentation/docs/music21/Makefile new file mode 100644 index 0000000..ff732c3 --- /dev/null +++ b/scripts/documentation/docs/music21/Makefile @@ -0,0 +1,38 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cuthbertLab/music21.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/music21 +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# For this to build the python notebooks into the documentation, it requires pandoc. +v8.3.0 v9.1.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # --editable is required because it will add the current path to Python's modules + # path instead of installing the files in the pip virtual environment. + # The music21 build system is weird, and needs this path as root for looking + # up some files. Installing in the virtual env. will not be able to find the files + pip install --editable . + pip install -r requirements_dev.txt + cd documentation + python3 make.py clean + python3 make.py + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/mypy/Makefile b/scripts/documentation/docs/mypy/Makefile new file mode 100644 index 0000000..9a4fb11 --- /dev/null +++ b/scripts/documentation/docs/mypy/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/python/mypy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/mypy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.991 v1.7.1 v1.8.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install -r requirements-docs.txt + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/nbsphinx/Makefile b/scripts/documentation/docs/nbsphinx/Makefile new file mode 100644 index 0000000..5ba9c1d --- /dev/null +++ b/scripts/documentation/docs/nbsphinx/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/spatialaudio/nbsphinx.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/nbsphinx +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# Requires subversion librsvg2-bin +0.8.12 0.9.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -e . + pip install -r doc/requirements.txt + pip install -r doc/fallback_theme.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml doc "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/nextflow/Makefile b/scripts/documentation/docs/nextflow/Makefile new file mode 100644 index 0000000..6c66d27 --- /dev/null +++ b/scripts/documentation/docs/nextflow/Makefile @@ -0,0 +1,39 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/nextflow-io/nextflow.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/nextflow +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v23.10.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install -r requirements.txt + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v22.10.8 v23.04.4: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -U sphinx sphinx_rtd_theme + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/numpydoc/Makefile b/scripts/documentation/docs/numpydoc/Makefile new file mode 100644 index 0000000..9b1c5b1 --- /dev/null +++ b/scripts/documentation/docs/numpydoc/Makefile @@ -0,0 +1,119 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/numpy/numpydoc.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/numpydoc +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.6.0 v1.7.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/default.txt -r requirements/developer.txt -r requirements/doc.txt -r requirements/test.txt .[doc] + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.5.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/developer.txt -r requirements/doc.txt -r requirements/test.txt .[doc] + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.3.1 v1.4.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/developer.txt -r requirements/test.txt -r doc/requirements.txt + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.2.1: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc/requirements.txt -r test_requirements.txt + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.1.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + git submodule update --init --recursive + pip install -r doc/requirements.txt -r test_requirements.txt + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.0.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + git submodule update --init --recursive + pip install -r doc/requirements.txt + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.9.2: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + git submodule update --init --recursive + pip install -r doc/requirements.txt + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/openpyxl/Makefile b/scripts/documentation/docs/openpyxl/Makefile new file mode 100644 index 0000000..13a12b8 --- /dev/null +++ b/scripts/documentation/docs/openpyxl/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://foss.heptapod.net/openpyxl/openpyxl + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/openpyxl +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + hg clone ${REPOSITORY} repository + +3.1.2: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + hg update $@ + pip install -r requirements.txt sphinx sphinx_rtd_theme + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml doc "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pagure/Makefile b/scripts/documentation/docs/pagure/Makefile new file mode 100644 index 0000000..3c398a3 --- /dev/null +++ b/scripts/documentation/docs/pagure/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://pagure.io/pagure.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pagure +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.1.36 1.2 2.15.1 3.13.2 4.0.4 5.0.1 5.1.4 5.2 5.3.1 5.4 5.5 5.6 5.7.9 5.8.1 5.9.1 5.10.0 5.11.3 5.12.1 5.13.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd doc + pip install -r requirements.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pallets-click/Makefile b/scripts/documentation/docs/pallets-click/Makefile new file mode 100644 index 0000000..c940741 --- /dev/null +++ b/scripts/documentation/docs/pallets-click/Makefile @@ -0,0 +1,50 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pallets/click.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pallets-click +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +8.0.4 8.1.7: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +7.0 7.1.2: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "jinja2 < 3" "markupsafe == 2.0.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pelican/Makefile b/scripts/documentation/docs/pelican/Makefile new file mode 100644 index 0000000..6fe64d0 --- /dev/null +++ b/scripts/documentation/docs/pelican/Makefile @@ -0,0 +1,45 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/getpelican/pelican.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pelican +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.7.2 4.8.0 4.9.0 4.9.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.pip + pip install . + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +4.5.4 4.6.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.pip + # Lock version because it won't compile otherwise + pip install "jinja2 == 3" "sphinx < 6" + pip install . + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/phpmyadmin/Makefile b/scripts/documentation/docs/phpmyadmin/Makefile new file mode 100644 index 0000000..c9a9936 --- /dev/null +++ b/scripts/documentation/docs/phpmyadmin/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/phpmyadmin/phpmyadmin.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/phpmyadmin +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +RELEASE_4_7_9 RELEASE_4_8_5 RELEASE_4_9_11 RELEASE_5_0_4 RELEASE_5_1_4 RELEASE_5_2_1: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd doc + make clean dirhtml + cp --recursive dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/prospector/Makefile b/scripts/documentation/docs/prospector/Makefile new file mode 100644 index 0000000..a7664d2 --- /dev/null +++ b/scripts/documentation/docs/prospector/Makefile @@ -0,0 +1,47 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/landscapeio/prospector.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/prospector +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.10.3: check_env_vars repository + export PYENV_VERSION=3.11 + cd repository + git checkout tags/$@ + poetry install + poetry run pip install -r docs/requirements.txt + poetry run pip install .[with_everything] + cd docs + poetry run make clean + poetry run make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +0.12.11: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install .[with_everything] "pyroma == 2.3" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/psrqpy/Makefile b/scripts/documentation/docs/psrqpy/Makefile new file mode 100644 index 0000000..cc2ec46 --- /dev/null +++ b/scripts/documentation/docs/psrqpy/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mattpitkin/psrqpy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/psrqpy +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.8 v1.2.7: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/psycopg/Makefile b/scripts/documentation/docs/psycopg/Makefile new file mode 100644 index 0000000..a2b17a6 --- /dev/null +++ b/scripts/documentation/docs/psycopg/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/psycopg/psycopg.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/psycopg +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.0.18 3.1.16: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install ./psycopg[dev,docs] + pip install ./psycopg_pool + pip install ./psycopg_c + cd docs + make clean dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pycuda/Makefile b/scripts/documentation/docs/pycuda/Makefile new file mode 100644 index 0000000..06e8211 --- /dev/null +++ b/scripts/documentation/docs/pycuda/Makefile @@ -0,0 +1,42 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/inducer/pycuda.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pycuda +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2022.2.2 v2023.1: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + # Manually install dependencies because this repo doesn't have a requirements.txt file + pip install "sphinx < 8" sphinx-copybutton furo + cd doc + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v2015.1.3 v2016.1.2 v2017.1.1 v2018.1.1 v2019.1.2 v2020.1 v2021.1: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + # Manually install dependencies because this repo doesn't have a requirements.txt file + pip install "sphinx < 8" sphinx-copybutton furo + cd doc + sphinx-build -b dirhtml source/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pydash/Makefile b/scripts/documentation/docs/pydash/Makefile new file mode 100644 index 0000000..88fdabe --- /dev/null +++ b/scripts/documentation/docs/pydash/Makefile @@ -0,0 +1,79 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/dgilland/pydash.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pydash +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v7.0.6: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v5.1.2 v6.0.2: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v4.9.3: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v3.4.8: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-dev.txt "docutils < 0.18" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pyinstaller/Makefile b/scripts/documentation/docs/pyinstaller/Makefile new file mode 100644 index 0000000..57940bc --- /dev/null +++ b/scripts/documentation/docs/pyinstaller/Makefile @@ -0,0 +1,59 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pyinstaller/pyinstaller.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pyinstaller +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v5.13.2 v6.3.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r doc/requirements.txt + cd doc + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v4.10: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r doc/requirements.txt + cd doc + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v3.6: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install . + pip install sphinx sphinx_rtd_theme + cd doc + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pyinvoke/Makefile b/scripts/documentation/docs/pyinvoke/Makefile new file mode 100644 index 0000000..be5327d --- /dev/null +++ b/scripts/documentation/docs/pyinvoke/Makefile @@ -0,0 +1,28 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pyinvoke/invoke.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pyinvoke +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.1.0 2.2.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r dev-requirements.txt + sphinx-build -b dirhtml sites/docs "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylinac/Makefile b/scripts/documentation/docs/pylinac/Makefile new file mode 100644 index 0000000..18e63db --- /dev/null +++ b/scripts/documentation/docs/pylinac/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jrkerns/pylinac.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylinac +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v3.17: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-rtd.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylmdb/Makefile b/scripts/documentation/docs/pylmdb/Makefile new file mode 100644 index 0000000..4ad4fa3 --- /dev/null +++ b/scripts/documentation/docs/pylmdb/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jnwatson/py-lmdb.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylmdb +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +py-lmdb_0.99 py-lmdb_1.0.0 py-lmdb_1.1.1 py-lmdb_1.2.1 py-lmdb_1.3.0 py-lmdb_1.4.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 7" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-colander/Makefile b/scripts/documentation/docs/pylons-colander/Makefile new file mode 100644 index 0000000..24e6734 --- /dev/null +++ b/scripts/documentation/docs/pylons-colander/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/colander.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-colander +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.8.3 2.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-deform/Makefile b/scripts/documentation/docs/pylons-deform/Makefile new file mode 100644 index 0000000..e98a63b --- /dev/null +++ b/scripts/documentation/docs/pylons-deform/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/deform.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-deform +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.0.15: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-hupper/Makefile b/scripts/documentation/docs/pylons-hupper/Makefile new file mode 100644 index 0000000..1d1dd00 --- /dev/null +++ b/scripts/documentation/docs/pylons-hupper/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/hupper.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-hupper +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.5 1.11 1.12: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-hypatia/Makefile b/scripts/documentation/docs/pylons-hypatia/Makefile new file mode 100644 index 0000000..59255ec --- /dev/null +++ b/scripts/documentation/docs/pylons-hypatia/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/hypatia.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-hypatia +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.4: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-pastedeploy/Makefile b/scripts/documentation/docs/pylons-pastedeploy/Makefile new file mode 100644 index 0000000..f7a66c3 --- /dev/null +++ b/scripts/documentation/docs/pylons-pastedeploy/Makefile @@ -0,0 +1,56 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/pastedeploy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-pastedeploy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +3.0.1: check_env_vars venv-10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +2.1.1: check_env_vars venv-7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-peppercorn/Makefile b/scripts/documentation/docs/pylons-peppercorn/Makefile new file mode 100644 index 0000000..e4b3dbc --- /dev/null +++ b/scripts/documentation/docs/pylons-peppercorn/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/peppercorn.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-peppercorn +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.6: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-plaster/Makefile b/scripts/documentation/docs/pylons-plaster/Makefile new file mode 100644 index 0000000..7977731 --- /dev/null +++ b/scripts/documentation/docs/pylons-plaster/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/plaster.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-plaster +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.5 1.0 1.1.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-pyramid/Makefile b/scripts/documentation/docs/pylons-pyramid/Makefile new file mode 100644 index 0000000..e3f5061 --- /dev/null +++ b/scripts/documentation/docs/pylons-pyramid/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/pyramid.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-pyramid +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.10.8 2.0 2.0.1 2.0.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-pyramid_debugtoolbar/Makefile b/scripts/documentation/docs/pylons-pyramid_debugtoolbar/Makefile new file mode 100644 index 0000000..4907d70 --- /dev/null +++ b/scripts/documentation/docs/pylons-pyramid_debugtoolbar/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/pyramid_debugtoolbar.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-pyramid_debugtoolbar +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.10: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +2.5 3.0.5: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-pyramid_jinja2/Makefile b/scripts/documentation/docs/pylons-pyramid_jinja2/Makefile new file mode 100644 index 0000000..2c7e47a --- /dev/null +++ b/scripts/documentation/docs/pylons-pyramid_jinja2/Makefile @@ -0,0 +1,39 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/pyramid_jinja2.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-pyramid_jinja2 +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.9.2 2.10: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +1.10 2.0.2 2.1 2.2 2.3.3 2.4 2.5 2.6.2 2.7 2.8: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] "jinja2 < 3.1" + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-pyramid_mako/Makefile b/scripts/documentation/docs/pylons-pyramid_mako/Makefile new file mode 100644 index 0000000..9990e96 --- /dev/null +++ b/scripts/documentation/docs/pylons-pyramid_mako/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/pyramid_mako.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-pyramid_mako +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.0.2 1.1.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r rtd.txt + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-pyramid_retry/Makefile b/scripts/documentation/docs/pylons-pyramid_retry/Makefile new file mode 100644 index 0000000..280d116 --- /dev/null +++ b/scripts/documentation/docs/pylons-pyramid_retry/Makefile @@ -0,0 +1,40 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/pyramid_retry.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-pyramid_retry +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.1.1: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +0.5 1.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r rtd.txt + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-pyramid_tm/Makefile b/scripts/documentation/docs/pylons-pyramid_tm/Makefile new file mode 100644 index 0000000..23d4974 --- /dev/null +++ b/scripts/documentation/docs/pylons-pyramid_tm/Makefile @@ -0,0 +1,44 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/pyramid_tm.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-pyramid_tm +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.5: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +0.12 1.1.1: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-translationstring/Makefile b/scripts/documentation/docs/pylons-translationstring/Makefile new file mode 100644 index 0000000..3a172a0 --- /dev/null +++ b/scripts/documentation/docs/pylons-translationstring/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/translationstring.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-translationstring +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.4: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-venusian/Makefile b/scripts/documentation/docs/pylons-venusian/Makefile new file mode 100644 index 0000000..0f2f443 --- /dev/null +++ b/scripts/documentation/docs/pylons-venusian/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/venusian.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-venusian +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.1.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-waitress/Makefile b/scripts/documentation/docs/pylons-waitress/Makefile new file mode 100644 index 0000000..e441527 --- /dev/null +++ b/scripts/documentation/docs/pylons-waitress/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/waitress.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-waitress +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.4.4 v2.0.0 v2.1.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r rtd.txt + pip install . + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-webob/Makefile b/scripts/documentation/docs/pylons-webob/Makefile new file mode 100644 index 0000000..c71a910 --- /dev/null +++ b/scripts/documentation/docs/pylons-webob/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/webob.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-webob +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.8.7: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-webtest/Makefile b/scripts/documentation/docs/pylons-webtest/Makefile new file mode 100644 index 0000000..969aec8 --- /dev/null +++ b/scripts/documentation/docs/pylons-webtest/Makefile @@ -0,0 +1,44 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/webtest.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-webtest +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.0.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +2.0.35: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pylons-zodburi/Makefile b/scripts/documentation/docs/pylons-zodburi/Makefile new file mode 100644 index 0000000..f4da7a1 --- /dev/null +++ b/scripts/documentation/docs/pylons-zodburi/Makefile @@ -0,0 +1,56 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/zodburi.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pylons-zodburi +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.6.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +2.5.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +2.4.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pymunk/Makefile b/scripts/documentation/docs/pymunk/Makefile new file mode 100644 index 0000000..92b10fe --- /dev/null +++ b/scripts/documentation/docs/pymunk/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/viblo/pymunk.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pymunk +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +6.6.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs/src/ + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pypubsub/Makefile b/scripts/documentation/docs/pypubsub/Makefile new file mode 100644 index 0000000..4efa341 --- /dev/null +++ b/scripts/documentation/docs/pypubsub/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/schollii/pypubsub.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pypubsub +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v3.3.0 v4.0.0 v4.0.3: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install sphinx + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-aspectlib/Makefile b/scripts/documentation/docs/python-aspectlib/Makefile new file mode 100644 index 0000000..433cb0e --- /dev/null +++ b/scripts/documentation/docs/python-aspectlib/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ionelmc/python-aspectlib.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-aspectlib +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.4.2 v1.5.2 v2.0.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-cerberus/Makefile b/scripts/documentation/docs/python-cerberus/Makefile new file mode 100644 index 0000000..4ab14b8 --- /dev/null +++ b/scripts/documentation/docs/python-cerberus/Makefile @@ -0,0 +1,50 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pyeve/cerberus.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-cerberus +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.3.5: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.3.4: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt "jinja2 < 3.1" + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-construct/Makefile b/scripts/documentation/docs/python-construct/Makefile new file mode 100644 index 0000000..4d735e8 --- /dev/null +++ b/scripts/documentation/docs/python-construct/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/construct/construct.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-construct +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.10.70: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . sphinx + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-curio/Makefile b/scripts/documentation/docs/python-curio/Makefile new file mode 100644 index 0000000..f517936 --- /dev/null +++ b/scripts/documentation/docs/python-curio/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/dabeaz/curio.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-curio +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.1 0.2 0.3 0.4 0.6 0.7 0.8 0.9 1.0 1.1 1.2 1.3 1.4 1.5 1.6: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + # Lock versions or it won't compile + pip install "sphinx < 4" "jinja2 < 3.1" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-enrico/Makefile b/scripts/documentation/docs/python-enrico/Makefile new file mode 100644 index 0000000..0bdb69f --- /dev/null +++ b/scripts/documentation/docs/python-enrico/Makefile @@ -0,0 +1,47 @@ + + + +# THIS IS NOT COMPILING CORRECTLY +# SHOULD PROBABLY NEED PYTHON 2 INSTEAD OF 3. + + + +SHELL = /bin/bash + +REPOSITORY = https://github.com/gammapy/enrico.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-enrico +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2024-01-22-3ad2438f: check_env_vars venv-3.11 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install "sphinx < 8" + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-faker/Makefile b/scripts/documentation/docs/python-faker/Makefile new file mode 100644 index 0000000..6af4052 --- /dev/null +++ b/scripts/documentation/docs/python-faker/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/joke2k/faker.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-faker +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v9.9.1 v10.0.0 v11.4.0 v12.3.3 v13.16.0 v14.2.2 v15.3.4 v16.9.0 v17.6.0 v18.13.0 v19.13.0 v20.1.0 v21.0.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install sphinx + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-ftfy/Makefile b/scripts/documentation/docs/python-ftfy/Makefile new file mode 100644 index 0000000..d1f6224 --- /dev/null +++ b/scripts/documentation/docs/python-ftfy/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/rspeer/python-ftfy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-ftfy +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +v6.1.1: check_env_vars repository + export PYENV_VERSION=3.8 + cd repository + git checkout tags/$@ + poetry install + poetry run pip install .[docs] + cd docs + poetry run make clean + poetry run make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-greenlet/Makefile b/scripts/documentation/docs/python-greenlet/Makefile new file mode 100644 index 0000000..8d1bdcb --- /dev/null +++ b/scripts/documentation/docs/python-greenlet/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/python-greenlet/greenlet.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-greenlet +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.0.2 3.0.3: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-luigi/Makefile b/scripts/documentation/docs/python-luigi/Makefile new file mode 100644 index 0000000..fa7f8f4 --- /dev/null +++ b/scripts/documentation/docs/python-luigi/Makefile @@ -0,0 +1,50 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/spotify/luigi.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-luigi +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.5.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx_rtd_theme + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +2.8.13: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx_rtd_theme + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-nox/Makefile b/scripts/documentation/docs/python-nox/Makefile new file mode 100644 index 0000000..f79f24d --- /dev/null +++ b/scripts/documentation/docs/python-nox/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/wntrblm/nox.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-nox +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2018.10.17 2019.11.9 2020.12.31 2021.10.1 2022.11.21 2023.04.22: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-test.txt + pip install . + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-pip/Makefile b/scripts/documentation/docs/python-pip/Makefile new file mode 100644 index 0000000..7513f38 --- /dev/null +++ b/scripts/documentation/docs/python-pip/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pypa/pip.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-pip +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +21.3.1 22.3.1 23.0 23.3.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r docs/requirements.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/html/ "${OUTPUT_PATH}/$@" + +20.3.4: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 6" furo sphinx-inline-tabs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/html/ "${OUTPUT_PATH}/$@" + +19.3.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 6" furo sphinx-inline-tabs + # They use this custom theme + pip install python-docs-theme git+https://github.com/pypa/pypa-docs-theme.git#egg=pypa-docs-theme + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/html/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-poetry-cleo/Makefile b/scripts/documentation/docs/python-poetry-cleo/Makefile new file mode 100644 index 0000000..542517f --- /dev/null +++ b/scripts/documentation/docs/python-poetry-cleo/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/python-poetry/cleo.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-poetry-cleo +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.0.0 2.0.1 2.1.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx_rtd_theme + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-requests-cache/Makefile b/scripts/documentation/docs/python-requests-cache/Makefile new file mode 100644 index 0000000..069ef42 --- /dev/null +++ b/scripts/documentation/docs/python-requests-cache/Makefile @@ -0,0 +1,55 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/requests-cache/requests-cache.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-requests-cache +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[all,docs] typing_extensions + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v0.7.5 v0.8.1 v0.9.8 v1.0.1: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[all,docs] typing_extensions + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v0.6.4: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs,backends] "jinja2 < 3.1" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-requests/Makefile b/scripts/documentation/docs/python-requests/Makefile new file mode 100644 index 0000000..e24834a --- /dev/null +++ b/scripts/documentation/docs/python-requests/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/psf/requests.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-requests +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.26.0 v2.27.0 v2.28.0 v2.29.0 v2.30.0 v2.31.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install -r requirements.txt + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-setuptools/Makefile b/scripts/documentation/docs/python-setuptools/Makefile new file mode 100644 index 0000000..4cc30d5 --- /dev/null +++ b/scripts/documentation/docs/python-setuptools/Makefile @@ -0,0 +1,80 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pypa/setuptools.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-setuptools +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v68.2.2 v69.0.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + # MUST change directory because it looks for some files in "../" + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v67.8.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # Lock Sphinx version because there is an ImportError with sphinx 7.2 + pip install .[docs] "sphinx < 7.2" + # MUST change directory because it looks for some files in "../" + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v63.4.3 v64.0.3 v65.7.0 v66.1.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # Lock Sphinx version because there is an ImportError with sphinx 7.2 + # Lock sphinx-favicon because "Between v0.2 and v1.0, the module name of the extension + # changed (from sphinx-favicon to sphinx_favicon) to conform with Python standards. The + # documentation uses sphinx-favicon and it won't find sphinx_favicon. + pip install .[docs] "sphinx < 7.2" "sphinx-favicon < 1" + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v59.8.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + # Lock sphinx because there's a regexp error with Sphinx 6 + pip install .[docs] "sphinx < 6" + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v49.6.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + python bootstrap.py + pip install -r docs/requirements.txt + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-six/Makefile b/scripts/documentation/docs/python-six/Makefile new file mode 100644 index 0000000..992f9e0 --- /dev/null +++ b/scripts/documentation/docs/python-six/Makefile @@ -0,0 +1,29 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/benjaminp/six.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-six +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.0.0 1.1.0 1.2.0 1.3.0 1.4.1 1.5.2 1.6.1 1.7.3 1.8.0 1.9.0 1.10.0 1.11.0 1.12.0 1.13.0 1.14.0 1.15.0 1.16.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml documentation "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-soundfile/Makefile b/scripts/documentation/docs/python-soundfile/Makefile new file mode 100644 index 0000000..b861184 --- /dev/null +++ b/scripts/documentation/docs/python-soundfile/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/bastibe/python-soundfile.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-soundfile +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.11.0 0.12.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc/requirements.txt + cd doc + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-sqlparse/Makefile b/scripts/documentation/docs/python-sqlparse/Makefile new file mode 100644 index 0000000..804b23a --- /dev/null +++ b/scripts/documentation/docs/python-sqlparse/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/andialbrecht/sqlparse.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-sqlparse +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.2.0 0.2.1 0.2.2 0.2.3 0.2.4 0.3.0 0.3.1 0.4.0 0.4.1 0.4.2 0.4.3 0.4.4: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + mkdir --parents "${OUTPUT_PATH}" + cd docs + make clean dirhtml + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-tenacity/Makefile b/scripts/documentation/docs/python-tenacity/Makefile new file mode 100644 index 0000000..1022a25 --- /dev/null +++ b/scripts/documentation/docs/python-tenacity/Makefile @@ -0,0 +1,54 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jd/tenacity.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-tenacity +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +8.2.3: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml doc/source/ "${OUTPUT_PATH}/$@" + +7.0.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml doc/source/ "${OUTPUT_PATH}/$@" + +5.1.5 6.3.1: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml doc/source/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-tox-filelock/Makefile b/scripts/documentation/docs/python-tox-filelock/Makefile new file mode 100644 index 0000000..8b24262 --- /dev/null +++ b/scripts/documentation/docs/python-tox-filelock/Makefile @@ -0,0 +1,46 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/tox-dev/filelock.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-tox-filelock +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.13.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +v2.0.13: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 8" sphinx_rtd_theme + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-tox-pipenv/Makefile b/scripts/documentation/docs/python-tox-pipenv/Makefile new file mode 100644 index 0000000..3764191 --- /dev/null +++ b/scripts/documentation/docs/python-tox-pipenv/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/tox-dev/tox-pipenv.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-tox-pipenv +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +1.2.1 1.8.0 1.9.10: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 8" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-tox-travis/Makefile b/scripts/documentation/docs/python-tox-travis/Makefile new file mode 100644 index 0000000..9ff51ff --- /dev/null +++ b/scripts/documentation/docs/python-tox-travis/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/tox-dev/tox-travis.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-tox-travis +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.9 0.10 0.11 0.12 0.13: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 8" sphinx_rtd_theme + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-tox/Makefile b/scripts/documentation/docs/python-tox/Makefile new file mode 100644 index 0000000..1937c8d --- /dev/null +++ b/scripts/documentation/docs/python-tox/Makefile @@ -0,0 +1,44 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/tox-dev/tox.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-tox +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +4.12.1: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +3.27.1: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-trio/Makefile b/scripts/documentation/docs/python-trio/Makefile new file mode 100644 index 0000000..e934a60 --- /dev/null +++ b/scripts/documentation/docs/python-trio/Makefile @@ -0,0 +1,45 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/python-trio/trio.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-trio +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.22.2 v0.23.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs-requirements.txt + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +v0.12.1 v0.13.0 v0.14.0 v0.15.1 v0.16.0 v0.17.0 v0.18.0 v0.19.0 v0.20.0 v0.21.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs-requirements.txt + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-virtualenv/Makefile b/scripts/documentation/docs/python-virtualenv/Makefile new file mode 100644 index 0000000..00a87da --- /dev/null +++ b/scripts/documentation/docs/python-virtualenv/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pypa/virtualenv.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-virtualenv +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +20.25.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +16.7.12: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-waitress/Makefile b/scripts/documentation/docs/python-waitress/Makefile new file mode 100644 index 0000000..6f35814 --- /dev/null +++ b/scripts/documentation/docs/python-waitress/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Pylons/waitress.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-waitress +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.9.0 v1.0.2 v1.1.0 v1.2.1 v1.3.1 v1.4.4 v2.0.0 v2.1.0 v2.1.1 v2.1.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/python-websockets/Makefile b/scripts/documentation/docs/python-websockets/Makefile new file mode 100644 index 0000000..a6b9016 --- /dev/null +++ b/scripts/documentation/docs/python-websockets/Makefile @@ -0,0 +1,59 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/python-websockets/websockets.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/python-websockets +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +10.4 11.0.3 12.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +8.1 9.1: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +5.0.1 6.0 7.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 6" + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pywavelets/Makefile b/scripts/documentation/docs/pywavelets/Makefile new file mode 100644 index 0000000..a8a6ed0 --- /dev/null +++ b/scripts/documentation/docs/pywavelets/Makefile @@ -0,0 +1,34 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/PyWavelets/pywt.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pywavelets +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.1.1 v1.2.0 v1.3.0 v1.4.1 v1.5.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r util/readthedocs/requirements.txt + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/pyyawt/Makefile b/scripts/documentation/docs/pyyawt/Makefile new file mode 100644 index 0000000..30e64a3 --- /dev/null +++ b/scripts/documentation/docs/pyyawt/Makefile @@ -0,0 +1,41 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/holgern/pyyawt.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/pyyawt +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2016-03-04-f4f64169: check_env_vars venv-3.5 repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r readthedocs-requirements.txt + pip install sphinx + pip install . + cd doc + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/qtile/Makefile b/scripts/documentation/docs/qtile/Makefile new file mode 100644 index 0000000..840a8df --- /dev/null +++ b/scripts/documentation/docs/qtile/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/qtile/qtile.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/qtile +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.23.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install -r requirements.txt + pip install -r requirements-rtd.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/quart/Makefile b/scripts/documentation/docs/quart/Makefile new file mode 100644 index 0000000..0796da3 --- /dev/null +++ b/scripts/documentation/docs/quart/Makefile @@ -0,0 +1,37 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pallets/quart.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/quart +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.19.4: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/rdflib/Makefile b/scripts/documentation/docs/rdflib/Makefile new file mode 100644 index 0000000..8e3eccd --- /dev/null +++ b/scripts/documentation/docs/rdflib/Makefile @@ -0,0 +1,27 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/rdflib/rdflib.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/rdflib +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +7.0.0: check_env_vars repository + cd repository + git checkout tags/$@ + poetry install + cd docs + poetry run make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/readthedocs/Makefile b/scripts/documentation/docs/readthedocs/Makefile new file mode 100644 index 0000000..6ccd035 --- /dev/null +++ b/scripts/documentation/docs/readthedocs/Makefile @@ -0,0 +1,36 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/readthedocs/readthedocs.org.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/readthedocs +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +9.16.4 10.11.0 10.12.2 10.26.0: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + cd docs + mkdir --parents "${OUTPUT_PATH}" + mkdir --parents "${OUTPUT_PATH}-dev" + make clean + make dirhtml + PROJECT=dev make dirhtml + cp --recursive _build/user/dirhtml "${OUTPUT_PATH}/$@" + cp --recursive _build/dev/dirhtml "${OUTPUT_PATH}-dev/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/robotpy/Makefile b/scripts/documentation/docs/robotpy/Makefile new file mode 100644 index 0000000..5da4f53 --- /dev/null +++ b/scripts/documentation/docs/robotpy/Makefile @@ -0,0 +1,42 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/robotpy/robotpy-docs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/robotpy +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2024.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +2017.1.4 2018.0.11 2019.1.2 2020.1.7 2021.6 2022.2 2023.5: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/ruamel.yaml/Makefile b/scripts/documentation/docs/ruamel.yaml/Makefile new file mode 100644 index 0000000..8205123 --- /dev/null +++ b/scripts/documentation/docs/ruamel.yaml/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = http://hg.code.sf.net/p/ruamel-yaml/code + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/ruamel.yaml +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + hg clone ${REPOSITORY} repository + +0.17.40 0.18.6: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + hg update $@ + pip install .[docs] ryd mkdocs + ryd convert --generate-mkdocs-config mkdocs.yaml _doc + mkdir --parents "${OUTPUT_PATH}" + mkdocs build --site-dir "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/rust-cargo/Makefile b/scripts/documentation/docs/rust-cargo/Makefile new file mode 100644 index 0000000..51254c3 --- /dev/null +++ b/scripts/documentation/docs/rust-cargo/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +# Requires mdbook for building the docs +# $ apt install rustc cargo +# $ cargo install mdbook + +REPOSITORY = https://github.com/rust-lang/cargo.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/rust-cargo +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +0.29.0 0.39.0 0.49.0 0.59.0 0.69.1 0.76.0: check_env_vars repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd src/doc/ + mdbook build + mkdir --parents "${OUTPUT_PATH}" + cp --recursive book "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/s3fs/Makefile b/scripts/documentation/docs/s3fs/Makefile new file mode 100644 index 0000000..ff40385 --- /dev/null +++ b/scripts/documentation/docs/s3fs/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/fsspec/s3fs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/s3fs +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.9: + export PYENV_VERSION=3.9 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2023.12.2: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install . + pip install botocore "docutils < 0.17" sphinx sphinx_rtd_theme + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +2022.11.0: check_env_vars venv-3.9 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install . + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/scrapy/Makefile b/scripts/documentation/docs/scrapy/Makefile new file mode 100644 index 0000000..1596bdf --- /dev/null +++ b/scripts/documentation/docs/scrapy/Makefile @@ -0,0 +1,30 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/scrapy/scrapy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/scrapy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.4.1 2.5.1 2.6.3 2.7.1 2.8.0 2.9.0 2.10.1 2.11.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/seaborn/Makefile b/scripts/documentation/docs/seaborn/Makefile new file mode 100644 index 0000000..4a9b91e --- /dev/null +++ b/scripts/documentation/docs/seaborn/Makefile @@ -0,0 +1,35 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/mwaskom/seaborn.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/seaborn +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.13.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + + # Instructions from doc/README.md + # To get a list of available Python kernels, run jupyter kernelspec list + pip install .[stats,docs] + export NB_KERNEL="python3" + cd doc + make clean notebooks html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/searxng/Makefile b/scripts/documentation/docs/searxng/Makefile new file mode 100644 index 0000000..42fda91 --- /dev/null +++ b/scripts/documentation/docs/searxng/Makefile @@ -0,0 +1,41 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/searxng/searxng.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/searxng +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +# Also, they're using a very complex build system. For this reason we run their Makefile +# which creates its own Python virtual environment +# +# Requires a few packages in order to compile: +# - texlive-full +# - curl +2023-12-11-8a4104b9: check_env_vars repository + # By default, the Makefile will use "sphinx-build -b html" + # For generating "dirhtml" output, change the flag inside utils/lib.sh. + # Unfortunately the build script is too complex and this is the simplest solution. + + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + mkdir --parents "${OUTPUT_PATH}" + cd repository + git checkout $${commit_hash} + make docs.clean docs.html + cp --recursive dist/docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/securedrop/Makefile b/scripts/documentation/docs/securedrop/Makefile new file mode 100644 index 0000000..13b434d --- /dev/null +++ b/scripts/documentation/docs/securedrop/Makefile @@ -0,0 +1,27 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/freedomofpress/securedrop-docs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/securedrop +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +2.5.2-7 2.7.0-1: check_env_vars repository + cd repository + git checkout tags/$@ + poetry install + cd docs + poetry run make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/simplejson/Makefile b/scripts/documentation/docs/simplejson/Makefile new file mode 100644 index 0000000..5055369 --- /dev/null +++ b/scripts/documentation/docs/simplejson/Makefile @@ -0,0 +1,29 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/simplejson/simplejson.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/simplejson +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.6.2 v3.10.0 v3.11.1 v3.12.1 v3.13.2 v3.14.0 v3.15.0 v3.16.1 v3.17.6 v3.18.4 v3.19.0 v3.19.1 v3.19.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/sonos-controller/Makefile b/scripts/documentation/docs/sonos-controller/Makefile new file mode 100644 index 0000000..24c4a43 --- /dev/null +++ b/scripts/documentation/docs/sonos-controller/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/SoCo/SoCo.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/sonos-controller +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.12 v0.13 v0.14 v0.15 v0.16 v0.17 v0.18.1 v0.19 v0.20 v0.21.3 v0.22.6 v0.23.3 v0.24.1 v0.25.3 v0.26.4 v0.27.1 v0.28.1 v0.29.1 v0.30.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r requirements-dev.txt + mkdir --parents "${OUTPUT_PATH}" + cd doc + make clean dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/sphinx-releases/Makefile b/scripts/documentation/docs/sphinx-releases/Makefile new file mode 100644 index 0000000..37dea29 --- /dev/null +++ b/scripts/documentation/docs/sphinx-releases/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/bitprophet/releases.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/sphinx-releases +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.0.0 2.0.1 2.1.0 2.1.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx sphinx_rtd_theme + pip install . + cd docs + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/splinter-framework/Makefile b/scripts/documentation/docs/splinter-framework/Makefile new file mode 100644 index 0000000..4c85b01 --- /dev/null +++ b/scripts/documentation/docs/splinter-framework/Makefile @@ -0,0 +1,35 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/cobrateam/splinter.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/splinter-framework +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.18.1 0.19.0 0.21.0: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/doc.txt + pip install selenium + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/sqlalchemy-mako/Makefile b/scripts/documentation/docs/sqlalchemy-mako/Makefile new file mode 100644 index 0000000..1a62d32 --- /dev/null +++ b/scripts/documentation/docs/sqlalchemy-mako/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/sqlalchemy/mako.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/sqlalchemy-mako +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +rel_1_0_14 rel_1_1_6 rel_1_2_4 rel_1_3_0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd doc/build/ + pip install -r requirements.txt + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive output/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/sqlalchemy/Makefile b/scripts/documentation/docs/sqlalchemy/Makefile new file mode 100644 index 0000000..37b4033 --- /dev/null +++ b/scripts/documentation/docs/sqlalchemy/Makefile @@ -0,0 +1,44 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/sqlalchemy/sqlalchemy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/sqlalchemy +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +rel_1_3_24 rel_1_4_50 rel_2_0_23: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc/build/requirements.txt + # Asyncio "extras" are required for compiling without warnings + pip install .[asyncio] + cd doc/build/ + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive output/dirhtml/ "${OUTPUT_PATH}/$@" + +rel_1_2_19: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r doc/build/requirements.txt + pip install . + cd doc/build/ + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive output/dirhtml/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/statsmodels/Makefile b/scripts/documentation/docs/statsmodels/Makefile new file mode 100644 index 0000000..15fab58 --- /dev/null +++ b/scripts/documentation/docs/statsmodels/Makefile @@ -0,0 +1,39 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/statsmodels/statsmodels.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/statsmodels +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# NOTE: building this documentation is a pain in the ass. Dependencies are not pinned, but +# even when pinned there are still more errors and exceptions. Plus, during the build +# they seem to be downloading some datasets over HTTP that are no longer availabe (error 404). +# Building older versions is basically impossible (┛ಠ_ಠ)┛彡┻━┻ + +# requires to have fortran, meson, libopenblas, graphviz, pandoc installed +v0.14.2: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt -r requirements-dev.txt -r requirements-doc.txt "sphinx == 7.3.7" "notebook == 7.2.1" "nbsphinx == 0.9.4" "nbconvert == 7.16.4" "pyyaml == 6.0.1" "simplegeneric == 0.8.1" "seaborn == 0.13.2" "numpydoc == 1.7.0" "numpy == 1.23.1" "pandas == 2.2.2" pickleshare + pip install -e .[docs] + cd docs + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/sympy/Makefile b/scripts/documentation/docs/sympy/Makefile new file mode 100644 index 0000000..b9b9387 --- /dev/null +++ b/scripts/documentation/docs/sympy/Makefile @@ -0,0 +1,126 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/sympy/sympy.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/sympy +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +venv-3.6: + export PYENV_VERSION=3.6 + python3 -m venv venv + +venv-3.5: + export PYENV_VERSION=3.5 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +sympy-1.11.1 sympy-1.12: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r doc/requirements.txt + cd doc + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +sympy-1.10.1: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r doc/requirements.txt + cd doc + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +sympy-1.7.1 sympy-1.8 sympy-1.9: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r release/requirements.txt + cd doc + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +sympy-1.6.2: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx mpmath sphinx_math_dollar matplotlib + pip install . + cd doc + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +sympy-1.1.1 sympy-1.2 sympy-1.3 sympy-1.4 sympy-1.5.1: check_env_vars venv-3.6 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 4" sphinx_math_dollar matplotlib + pip install . + cd doc + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +sympy-1.0: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 1.6" + pip install . + cd doc + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +sympy-0.7.6.1: check_env_vars venv-3.5 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install "sphinx < 1.6" + pip install . + cd doc + make clean + make html + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/html "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/tablib/Makefile b/scripts/documentation/docs/tablib/Makefile new file mode 100644 index 0000000..bcc9de4 --- /dev/null +++ b/scripts/documentation/docs/tablib/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/jazzband/tablib.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/tablib +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v3.5.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r docs/requirements.txt + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/tmuxp/Makefile b/scripts/documentation/docs/tmuxp/Makefile new file mode 100644 index 0000000..0bd370a --- /dev/null +++ b/scripts/documentation/docs/tmuxp/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/tmux-python/tmuxp.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/tmuxp +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.19.1 v1.29.1 v1.34.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + poetry install + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/tomobank/Makefile b/scripts/documentation/docs/tomobank/Makefile new file mode 100644 index 0000000..2e8a1fe --- /dev/null +++ b/scripts/documentation/docs/tomobank/Makefile @@ -0,0 +1,39 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/tomography/tomobank.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/tomobank +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +# This repo doesn't use tags for releases, therefore we checkout specific commits. +# The date is the commit's date. +2023-12-23-31de115e: check_env_vars venv repository + # Extract commit hash + commit_hash=$@ + commit_hash=$${commit_hash:11} + + source venv/bin/activate + cd repository + git checkout $${commit_hash} + pip install -r envs/requirements.txt + pip install -r envs/requirements-doc.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/torchio/Makefile b/scripts/documentation/docs/torchio/Makefile new file mode 100644 index 0000000..48213c6 --- /dev/null +++ b/scripts/documentation/docs/torchio/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/fepegar/torchio.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/torchio +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v0.18.92 v0.19.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[doc] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/trafilatura/Makefile b/scripts/documentation/docs/trafilatura/Makefile new file mode 100644 index 0000000..f75b6d6 --- /dev/null +++ b/scripts/documentation/docs/trafilatura/Makefile @@ -0,0 +1,49 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/adbar/trafilatura.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/trafilatura +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.6.4: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v0.9.3 v1.0.0 v1.1.0 v1.2.2 v1.3.0 v1.4.1 v1.5.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + pip install . + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/turbustat/Makefile b/scripts/documentation/docs/turbustat/Makefile new file mode 100644 index 0000000..6692992 --- /dev/null +++ b/scripts/documentation/docs/turbustat/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/Astroua/TurbuStat.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/turbustat +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v1.3: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +v1.2.1: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/twarc/Makefile b/scripts/documentation/docs/twarc/Makefile new file mode 100644 index 0000000..fa92a53 --- /dev/null +++ b/scripts/documentation/docs/twarc/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/DocNow/twarc.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/twarc +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v2.14.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r requirements-mkdocs.txt + pip install . + mkdocs build + mkdir --parents "${OUTPUT_PATH}" + cp --recursive site "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/twisted/Makefile b/scripts/documentation/docs/twisted/Makefile new file mode 100644 index 0000000..374f112 --- /dev/null +++ b/scripts/documentation/docs/twisted/Makefile @@ -0,0 +1,80 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/twisted/twisted.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/twisted +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +venv-3.8: + export PYENV_VERSION=3.8 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +twisted-23.8.0 twisted-23.10.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev-release] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +twisted-22.1.0 twisted-22.2.0 twisted-22.4.0 twisted-22.8.0 twisted-22.10.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev_release] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +twisted-21.2.0 twisted-21.7.0: check_env_vars venv-3.8 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev_release] "jinja2 < 3.1" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +twisted-16.4.0 twisted-16.4.1 twisted-16.5.0 twisted-16.6.0 twisted-17.1.0 twisted-17.5.0 twisted-17.9.0 twisted-18.4.0 twisted-18.7.0 twisted-18.9.0 twisted-19.2.1 twisted-19.7.0 twisted-19.10.0 twisted-20.3.0: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[dev] "jinja2 < 3.1" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +twisted-14.0.2 twisted-15.0.0 twisted-15.1.0 twisted-15.2.1 twisted-15.3.0 twisted-15.4.0 twisted-15.5.0 twisted-16.0.0 twisted-16.1.1 twisted-16.2.0 twisted-16.3.2: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/txtorcon/Makefile b/scripts/documentation/docs/txtorcon/Makefile new file mode 100644 index 0000000..618c726 --- /dev/null +++ b/scripts/documentation/docs/txtorcon/Makefile @@ -0,0 +1,35 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/meejah/txtorcon.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/txtorcon +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v23.11.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements.txt + pip install -r dev-requirements.txt + pip install -r doc-requirements.txt + pip install -r docs-requirements.txt + pip install . + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/urllib3/Makefile b/scripts/documentation/docs/urllib3/Makefile new file mode 100644 index 0000000..cda9d9a --- /dev/null +++ b/scripts/documentation/docs/urllib3/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/urllib3/urllib3.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/urllib3 +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2.0.0 2.1.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + # extra requirements, extracted from noxfile.py + pip install .[socks,secure,brotli,zstd] + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/vcs-python-libvcs/Makefile b/scripts/documentation/docs/vcs-python-libvcs/Makefile new file mode 100644 index 0000000..03bd105 --- /dev/null +++ b/scripts/documentation/docs/vcs-python-libvcs/Makefile @@ -0,0 +1,28 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/vcs-python/libvcs.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/vcs-python-libvcs +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +v0.26.0: check_env_vars repository + source venv/bin/activate + cd repository + git checkout tags/$@ + poetry install + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/vcs-python-vcspull/Makefile b/scripts/documentation/docs/vcs-python-vcspull/Makefile new file mode 100644 index 0000000..5918524 --- /dev/null +++ b/scripts/documentation/docs/vcs-python-vcspull/Makefile @@ -0,0 +1,27 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/vcs-python/vcspull.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/vcs-python-vcspull +else + $(error OUTPUT_PATH is undefined) +endif + +repository: + git clone ${REPOSITORY} repository + +v1.26.0: check_env_vars repository + source venv/bin/activate + cd repository + git checkout tags/$@ + poetry install + cd docs + mkdir --parents "${OUTPUT_PATH}" + poetry run sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/wagtail/Makefile b/scripts/documentation/docs/wagtail/Makefile new file mode 100644 index 0000000..9100b2b --- /dev/null +++ b/scripts/documentation/docs/wagtail/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/wagtail/wagtail.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/wagtail +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +v4.1.8 v5.0.5 v5.1.3 v5.2 v5.2.2: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install .[docs] + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/wandpy/Makefile b/scripts/documentation/docs/wandpy/Makefile new file mode 100644 index 0000000..40662ac --- /dev/null +++ b/scripts/documentation/docs/wandpy/Makefile @@ -0,0 +1,48 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/emcconville/wand.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/wandpy +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.11: + export PYENV_VERSION=3.11 + python3 -m venv venv + +venv-3.7: + export PYENV_VERSION=3.7 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +0.6.13: check_env_vars venv-3.11 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r docs/requirements.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +0.5.9: check_env_vars venv-3.7 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/weblate/Makefile b/scripts/documentation/docs/weblate/Makefile new file mode 100644 index 0000000..9df0d9c --- /dev/null +++ b/scripts/documentation/docs/weblate/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/WeblateOrg/weblate.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/weblate +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +weblate-4.18.2 weblate-5.0 weblate-5.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + cd docs + pip install -r requirements.txt + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/werkzeug/Makefile b/scripts/documentation/docs/werkzeug/Makefile new file mode 100644 index 0000000..a62db9a --- /dev/null +++ b/scripts/documentation/docs/werkzeug/Makefile @@ -0,0 +1,32 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/pallets/werkzeug.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/werkzeug +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.0.0: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r requirements/docs.txt + cd docs + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/wtforms/Makefile b/scripts/documentation/docs/wtforms/Makefile new file mode 100644 index 0000000..0a87bcd --- /dev/null +++ b/scripts/documentation/docs/wtforms/Makefile @@ -0,0 +1,53 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/wtforms/wtforms.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/wtforms +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +3.0.0 3.0.1 3.1.0 3.1.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r docs/requirements.txt + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +2.3.3: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install -r docs/requirements.txt + pip install "jinja2 < 3.1" + cd docs + make clean dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +1.0.5 2.0.2 2.1 2.2.1: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install . + pip install sphinx python-dateutil "jinja2 < 3.1" + mkdir --parents "${OUTPUT_PATH}" + sphinx-build -b dirhtml docs/ "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/youtube-dl/Makefile b/scripts/documentation/docs/youtube-dl/Makefile new file mode 100644 index 0000000..2a4c468 --- /dev/null +++ b/scripts/documentation/docs/youtube-dl/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/ytdl-org/youtube-dl.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/youtube-dl +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +2021.12.17: check_env_vars venv repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install sphinx + mkdir --parents "${OUTPUT_PATH}" + cd docs + make clean dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/zodb/Makefile b/scripts/documentation/docs/zodb/Makefile new file mode 100644 index 0000000..e80816e --- /dev/null +++ b/scripts/documentation/docs/zodb/Makefile @@ -0,0 +1,45 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/zopefoundation/ZODB.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/zodb +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +5.7.0 5.8.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + # We lock sphinx to version <7.2 because it's not compiling with >=7.2 + pip install "sphinx < 7.2" + pip install . + pip install -r docs/requirements.txt + cd docs + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +5.6.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + # We lock sphinx to version <7.2 because it's not compiling with >=7.2 + #pip install "sphinx < 7.2" + pip install . + pip install -r doc/requirements.txt + cd doc + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/zope.interface/Makefile b/scripts/documentation/docs/zope.interface/Makefile new file mode 100644 index 0000000..aef0a3d --- /dev/null +++ b/scripts/documentation/docs/zope.interface/Makefile @@ -0,0 +1,47 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/zopefoundation/zope.interface.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/zope.interface +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +6.1: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + # Lock sphinx version because of some deprecation warnings + pip install "sphinx < 8" + pip install . + pip install -r docs/requirements.txt + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +5.0.0 5.1.0 5.2.0 5.3.0 5.4.0 5.5.0 6.0: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + # Lock sphinx version because of some deprecation warnings + pip install "sphinx < 8" + pip install . + pip install -r rtd.txt + cd docs + make dirhtml + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/zope/Makefile b/scripts/documentation/docs/zope/Makefile new file mode 100644 index 0000000..a80a82f --- /dev/null +++ b/scripts/documentation/docs/zope/Makefile @@ -0,0 +1,31 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/zopefoundation/Zope.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/zope +else + $(error OUTPUT_PATH is undefined) +endif + +venv: + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +5.8 5.9: check_env_vars venv repository + mkdir --parents "${OUTPUT_PATH}" + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements-full.txt + pip install -r docs/requirements.txt + cd docs + sphinx-build -b dirhtml . "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/documentation/docs/zulip/Makefile b/scripts/documentation/docs/zulip/Makefile new file mode 100644 index 0000000..87880e5 --- /dev/null +++ b/scripts/documentation/docs/zulip/Makefile @@ -0,0 +1,33 @@ +SHELL = /bin/bash + +REPOSITORY = https://github.com/zulip/zulip.git + +check_env_vars: +ifdef OUTPUT_PATH +OUTPUT_PATH := ${OUTPUT_PATH}/zulip +else + $(error OUTPUT_PATH is undefined) +endif + +venv-3.10: + export PYENV_VERSION=3.10 + python3 -m venv venv + +repository: + git clone ${REPOSITORY} repository + +6.2 7.5 8.1: check_env_vars venv-3.10 repository + source venv/bin/activate + cd repository + git checkout tags/$@ + pip install -r requirements/docs.txt + cd docs + make clean + make dirhtml + mkdir --parents "${OUTPUT_PATH}" + cp --recursive _build/dirhtml "${OUTPUT_PATH}/$@" + +.ONESHELL: +.SUFFIXES: +.PHONY: +.DELETE_ON_ERROR: diff --git a/scripts/manpages/Makefile b/scripts/manpages/Makefile new file mode 100755 index 0000000..cc4485f --- /dev/null +++ b/scripts/manpages/Makefile @@ -0,0 +1,43 @@ +SHELL = /bin/bash + +# The mirror to download from +MIRROR ?= + +# The path where debiman will save files. +DEBIMAN_SERVING_DIR ?= + +# Name of the distribution to be processed +CODENAME ?= + +# This just prints out variables for displaying +vars: + @echo "MIRROR=${MIRROR}" + @echo "CODENAME=${CODENAME}" + @echo "DEBIMAN_SERVING_DIR=${DEBIMAN_SERVING_DIR}" + +# Note: the behaviour of debiman is to download all the manpages, then render them all. +# This cannot be changed. Since we're only interested in the raw manpages and not +# the HTML output, -only_render_pkgs is a hack that will make debiman render only one +# page (0ad) and quit. +download: vars + debiman -remote_mirror="${MIRROR}" -sync_codenames="${CODENAME}" -sync_suites= -serving_dir="${DEBIMAN_SERVING_DIR}" -only_render_pkgs="0ad" + +# Extract downloaded pages since they're compressed by default +extract: vars + find "${DEBIMAN_SERVING_DIR}" -type f,l -name "*.gz" -exec gunzip --decompress --force --keep "{}" \; + +# Convert manpages from roff to other formats +# Manpage files are named "page.section.lang". +# TODO ! -name "stress-ng.1.en" ! -name "md.4.en" +# this is a hack for skipping the parsing of those pages. The version of mandoc +# in Debian is outdated and gets stuck in a infinite loop. Remove this hack if +# using a more recent mandoc. +convert: vars + while IFS= read -r file; do \ + echo "$${file}"; \ + cp "$${file}" "$${file}.roff"; \ + mandoc -T utf8 "$${file}" > "$${file}.roff.txt"; \ + mandoc -T html -O fragment "$${file}" > "$${file}.roff.html"; \ + done < <( find "${DEBIMAN_SERVING_DIR}" -type f -name "*.*.*" ! -name "*.gz" ! -name "*.roff" ! -name "*.txt" ! -name "*.html" ! -name "stress-ng.1.en" ! -name "md.4.en" ) + +.PHONY: vars download extract convert diff --git a/scripts/manpages/README b/scripts/manpages/README new file mode 100644 index 0000000..9bc1022 --- /dev/null +++ b/scripts/manpages/README @@ -0,0 +1,33 @@ +Software prerequisites: + - apt-cacher-ng + - debiman (install from repository, follow instructions in README) + - mandoc + - python3 + - python3-venv + +After installing apt-cacher-ng, the proxy is started automatically and should be +listening on port 3142. +debiman by default will download from http://localhost:3142/deb.debian.org/ +This option can be changed with -local_mirror or -remote_mirror. Non-LTS Debians are +removed from the mirrors; use the archive instead: https://archive.debian.org + +How to use the scripts: + +1. Download manpages from Debian: + + $ MIRROR="https://archive.debian.org" CODENAME="buster" DEBIMAN_SERVING_DIR=/path make download + +2. Extract all the pages from .gz: + + $ DEBIMAN_SERVING_DIR=/path make extract + +3. Convert manpages to plaintext and html: + + $ DEBIMAN_SERVING_DIR=/path make convert + +4. Create RDF graph: + + $ python3 -m venv venv + $ source venv/bin/activate + $ pip install rdflib + $ CODENAME="buster" DEBIMAN_SERVING_DIR=/path ./rdf.py diff --git a/scripts/manpages/rdf.py b/scripts/manpages/rdf.py new file mode 100755 index 0000000..3db52db --- /dev/null +++ b/scripts/manpages/rdf.py @@ -0,0 +1,121 @@ +#!/usr/bin/env python3 + +import os +import pathlib +import rdflib +import sys + +from rdflib import BNode, Graph, Literal, Namespace, URIRef +from rdflib.namespace import RDF + +CODENAME = os.getenv('CODENAME') +DEBIMAN_SERVING_DIR = os.getenv('DEBIMAN_SERVING_DIR') + +if not CODENAME: + print('envvar CODENAME is not defined') + exit() + +if not DEBIMAN_SERVING_DIR: + print('envvar DEBIMAN_SERVING_DIR is not defined') + exit() + +MANPAGE = Namespace('dokk:manpages:') + +# A graph to store all the triples +g = Graph() + +def percent_encode(string): + """ + A few manpages contain special characters in their name that are not valid in a URL's + path. Since we use node URIs like we need to + %-encode these, otherwise the URLs are invalid. + The reason for using a custom method instead of urllib.parse.quote() is that urllib + only works with URLs but not IRIs, therefore quote() will %-encode *any* non-ASCII + character. + """ + + return string.replace(' ', '%20') \ + .replace('#', '%23') \ + .replace('[', '%5B') \ + .replace(']', '%5D') + +for absolute_file_path in pathlib.Path(DEBIMAN_SERVING_DIR, CODENAME.lower()).glob('**/*.roff'): + if not absolute_file_path.is_file(): + exit('Not a file: {}'.format(absolute_file_path)) + + # Remove the DEBIMAN_SERVING_DIR prefix from the path + # Also remove .roff suffix from the filename + file_path = absolute_file_path.relative_to(DEBIMAN_SERVING_DIR).with_suffix('') + file_parts = list(file_path.parts) + + distro_codename, distro_package, filename = file_parts[0], file_parts[1], file_parts[2] + + # Replace debian codenames with version numbers + if distro_codename == 'buster': distro_number = 10 + elif distro_codename == 'bullseye': distro_number = 11 + elif distro_codename == 'bookworm': distro_number = 12 + else: exit('Distro codename not recognized.') + + name, section, language = filename.rsplit('.', 2) + section_number, subsection = int(section[:1]), section[1:] + + # Read files + try: + with open(absolute_file_path, 'r') as f: + roff = f.read() + except: + roff = '' + + try: + with open(f'{absolute_file_path}.txt', 'r') as f: + plaintext = f.read() + except: + plaintext = '' + + try: + with open(f'{absolute_file_path}.html', 'r') as f: + html = f.read() + except: + html = '' + + # Create a new graph for this manpage that is printed out immediately + # because I haven't got enough RAM for storing the whole graph. + g_page = Graph() + + page_ref = URIRef(percent_encode(f'dokk:manpages:debian/{distro_number}/{distro_package}/{filename}')) + g_page.add((page_ref, RDF.type, URIRef(MANPAGE.Page))) + g_page.add((page_ref, URIRef(MANPAGE.filename), Literal(filename))) + g_page.add((page_ref, URIRef(MANPAGE.name), Literal(name))) + g_page.add((page_ref, URIRef(MANPAGE.name_lowercase), Literal(name.lower()))) + g_page.add((page_ref, URIRef(MANPAGE.section), Literal(section))) + g_page.add((page_ref, URIRef(MANPAGE.section_lowercase), Literal(section.lower()))) + g_page.add((page_ref, URIRef(MANPAGE.section_number), Literal(section_number))) + g_page.add((page_ref, URIRef(MANPAGE.subsection), Literal(subsection))) + g_page.add((page_ref, URIRef(MANPAGE.language), Literal(language))) + g_page.add((page_ref, URIRef(MANPAGE.roff), Literal(roff))) + g_page.add((page_ref, URIRef(MANPAGE.plaintext), Literal(plaintext))) + g_page.add((page_ref, URIRef(MANPAGE.html), Literal(html))) + + print(g_page.serialize(format='nt')) + + # Now we're going to create nodes for the debian distro as well as the package + # this page belongs to. + + # Create a graph node for this package + # Link to the page node + package_ref = URIRef(percent_encode(f'dokk:manpages:debian/{distro_number}/{distro_package}')) + g.add((package_ref, RDF.type, URIRef(MANPAGE.Package))) + g.add((package_ref, MANPAGE.name, Literal(distro_package))) + g.add((package_ref, MANPAGE.page, page_ref)) + + # Create a graph node for this distro + # Link to the package node + distro_ref = URIRef(percent_encode(f'dokk:manpages:debian/{distro_number}')) + g.add((distro_ref, RDF.type, URIRef(MANPAGE.Distribution))) + g.add((distro_ref, MANPAGE.name, Literal('debian'))) + g.add((distro_ref, MANPAGE.codename, Literal(distro_codename))) + g.add((distro_ref, MANPAGE.number, Literal(distro_number))) + g.add((distro_ref, MANPAGE.package, package_ref)) + +# Print out the graph +print(g.serialize(format='nt'))