Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@
"languages": ["en", "fr", "es"],
"project_title": _("CDFD: Documentation"),
"show_download_links": True,
"tool_nav_items": {"CDFD": "https://countrydata.iatistandard.org/"},
}

# Add any paths that contain custom static files (such as style sheets, videos,
Expand All @@ -55,6 +56,18 @@

todo_include_todos = True

html_context = {}

if os.environ.get("READTHEDOCS") == "True":
project_slug = os.environ.get("READTHEDOCS_PROJECT")
version_slug = os.environ.get("READTHEDOCS_VERSION")
language_slug = os.environ.get("READTHEDOCS_LANGUAGE", "en")

# RTD's standard download URL pattern
pdf_url = f"https://{project_slug}.readthedocs-hosted.com/_/downloads/{language_slug}/{version_slug}/pdf/"

html_context["pdf_url"] = pdf_url

# -- Options for Texinfo output -------------------------------------------

locale_dirs = [
Expand Down
40 changes: 21 additions & 19 deletions requirements.txt
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,19 @@
#
alabaster==1.0.0
# via sphinx
attrs==25.3.0
attrs==25.4.0
# via referencing
babel==2.17.0
# via
# sphinx
# sphinx-intl
certifi==2025.10.5
certifi==2026.1.4
# via requests
charset-normalizer==3.4.3
charset-normalizer==3.4.4
# via requests
click==8.3.0
click==8.3.1
# via sphinx-intl
docutils==0.21.2
docutils==0.22.4
# via
# myst-parser
# sphinx
Expand All @@ -27,7 +27,7 @@ docutils==0.21.2
# sphinxcontrib-opendataservices-jsonschema
iati-sphinx-theme==3.1.1
# via -r requirements.in
idna==3.10
idna==3.11
# via requests
imagesize==1.4.1
# via sphinx
Expand All @@ -47,7 +47,7 @@ jsonref==1.1.0
# via
# jscc
# sphinxcontrib-opendataservices-jsonschema
markdown-it-py==3.0.0
markdown-it-py==4.0.0
# via
# mdit-py-plugins
# myst-parser
Expand All @@ -57,30 +57,32 @@ mdit-py-plugins==0.5.0
# via myst-parser
mdurl==0.1.2
# via markdown-it-py
myst-parser==4.0.1
myst-parser==5.0.0
# via
# sphinxcontrib-opendataservices
# sphinxcontrib-opendataservices-jsonschema
packaging==25.0
# via sphinx
packaging==26.0
# via
# sphinx
# wheel
pygments==2.19.2
# via sphinx
pyyaml==6.0.3
# via myst-parser
referencing==0.36.2
referencing==0.37.0
# via sphinxcontrib-opendataservices-jsonschema
requests==2.32.5
# via
# jscc
# sphinx
# sphinxcontrib-youtube
roman-numerals-py==3.1.0
roman-numerals==4.1.0
# via sphinx
rpds-py==0.27.1
rpds-py==0.30.0
# via referencing
snowballstemmer==3.0.1
# via sphinx
sphinx==8.2.3
sphinx==9.1.0
# via
# -r requirements.in
# myst-parser
Expand All @@ -91,7 +93,7 @@ sphinx==8.2.3
# sphinxcontrib-youtube
sphinx-intl==2.3.2
# via -r requirements.in
sphinx-togglebutton==0.3.2
sphinx-togglebutton==0.4.4
# via -r requirements.in
sphinxcontrib-applehelp==2.0.0
# via sphinx
Expand All @@ -109,14 +111,14 @@ sphinxcontrib-qthelp==2.0.0
# via sphinx
sphinxcontrib-serializinghtml==2.0.0
# via sphinx
sphinxcontrib-video==0.4.1
sphinxcontrib-video==0.4.2
# via -r requirements.in
sphinxcontrib-youtube==1.4.1
# via -r requirements.in
urllib3==2.5.0
urllib3==2.6.3
# via requests
wheel==0.45.1
wheel==0.46.3
# via sphinx-togglebutton

# The following packages are considered to be unsafe in a requirements file:
# setuptools
# setuptools
53 changes: 26 additions & 27 deletions requirements_dev.txt
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ alabaster==1.0.0
# via
# -r requirements.txt
# sphinx
anyio==4.11.0
anyio==4.12.1
# via
# starlette
# watchfiles
attrs==25.3.0
attrs==25.4.0
# via
# -r requirements.txt
# referencing
Expand All @@ -21,25 +21,25 @@ babel==2.17.0
# -r requirements.txt
# sphinx
# sphinx-intl
black==25.9.0
black==26.1.0
# via -r requirements_dev.in
certifi==2025.10.5
certifi==2026.1.4
# via
# -r requirements.txt
# requests
charset-normalizer==3.4.3
charset-normalizer==3.4.4
# via
# -r requirements.txt
# requests
click==8.3.0
click==8.3.1
# via
# -r requirements.txt
# black
# sphinx-intl
# uvicorn
colorama==0.4.6
# via sphinx-autobuild
docutils==0.21.2
docutils==0.22.4
# via
# -r requirements.txt
# myst-parser
Expand All @@ -51,7 +51,7 @@ h11==0.16.0
# via uvicorn
iati-sphinx-theme==3.1.1
# via -r requirements.txt
idna==3.10
idna==3.11
# via
# -r requirements.txt
# anyio
Expand Down Expand Up @@ -83,7 +83,7 @@ jsonref==1.1.0
# -r requirements.txt
# jscc
# sphinxcontrib-opendataservices-jsonschema
markdown-it-py==3.0.0
markdown-it-py==4.0.0
# via
# -r requirements.txt
# mdit-py-plugins
Expand All @@ -102,31 +102,32 @@ mdurl==0.1.2
# markdown-it-py
mypy-extensions==1.1.0
# via black
myst-parser==4.0.1
myst-parser==5.0.0
# via
# -r requirements.txt
# sphinxcontrib-opendataservices
# sphinxcontrib-opendataservices-jsonschema
packaging==25.0
packaging==26.0
# via
# -r requirements.txt
# black
# sphinx
pathspec==0.12.1
# wheel
pathspec==1.0.4
# via black
platformdirs==4.5.0
platformdirs==4.5.1
# via black
pygments==2.19.2
# via
# -r requirements.txt
# sphinx
pytokens==0.2.0
pytokens==0.4.0
# via black
pyyaml==6.0.3
# via
# -r requirements.txt
# myst-parser
referencing==0.36.2
referencing==0.37.0
# via
# -r requirements.txt
# sphinxcontrib-opendataservices-jsonschema
Expand All @@ -136,21 +137,19 @@ requests==2.32.5
# jscc
# sphinx
# sphinxcontrib-youtube
roman-numerals-py==3.1.0
roman-numerals==4.1.0
# via
# -r requirements.txt
# sphinx
rpds-py==0.27.1
rpds-py==0.30.0
# via
# -r requirements.txt
# referencing
sniffio==1.3.1
# via anyio
snowballstemmer==3.0.1
# via
# -r requirements.txt
# sphinx
sphinx==8.2.3
sphinx==9.1.0
# via
# -r requirements.txt
# myst-parser
Expand All @@ -164,7 +163,7 @@ sphinx-autobuild==2025.8.25
# via -r requirements_dev.in
sphinx-intl==2.3.2
# via -r requirements.txt
sphinx-togglebutton==0.3.2
sphinx-togglebutton==0.4.4
# via -r requirements.txt
sphinxcontrib-applehelp==2.0.0
# via
Expand Down Expand Up @@ -196,23 +195,23 @@ sphinxcontrib-serializinghtml==2.0.0
# via
# -r requirements.txt
# sphinx
sphinxcontrib-video==0.4.1
sphinxcontrib-video==0.4.2
# via -r requirements.txt
sphinxcontrib-youtube==1.4.1
# via -r requirements.txt
starlette==0.48.0
starlette==0.52.1
# via sphinx-autobuild
urllib3==2.5.0
urllib3==2.6.3
# via
# -r requirements.txt
# requests
uvicorn==0.37.0
uvicorn==0.40.0
# via sphinx-autobuild
watchfiles==1.1.1
# via sphinx-autobuild
websockets==15.0.1
websockets==16.0
# via sphinx-autobuild
wheel==0.45.1
wheel==0.46.3
# via
# -r requirements.txt
# sphinx-togglebutton
Expand Down