diff --git a/docs/pages/guides/docs.md b/docs/pages/guides/docs.md index b92bba78..bceb5281 100644 --- a/docs/pages/guides/docs.md +++ b/docs/pages/guides/docs.md @@ -502,14 +502,17 @@ version: 2 build: os: ubuntu-24.04 tools: - python: "3.13" - commands: - - asdf plugin add uv - - asdf install uv latest - - asdf global uv latest - - uv sync --group docs - - uv run python -m sphinx -T -b html -d docs/_build/doctrees -D language=en - docs $READTHEDOCS_OUTPUT/html + python: "3.14" + +sphinx: + configuration: docs/conf.py + +python: + install: + - method: uv + command: sync + groups: + - docs ``` @@ -530,7 +533,8 @@ version: 2 build: os: ubuntu-24.04 tools: - python: "3.13" + python: "3.14" + commands: - asdf plugin add uv - asdf install uv latest diff --git a/{{cookiecutter.project_name}}/.readthedocs.yaml b/{{cookiecutter.project_name}}/.readthedocs.yaml index 94df0435..f3bf0e9e 100644 --- a/{{cookiecutter.project_name}}/.readthedocs.yaml +++ b/{{cookiecutter.project_name}}/.readthedocs.yaml @@ -6,19 +6,33 @@ version: 2 build: os: ubuntu-24.04 tools: - python: "3.13" + python: "3.14" + +{%- if cookiecutter.docs == 'sphinx' %} + +sphinx: + configuration: docs/conf.py + +python: + install: + - method: uv + command: sync + groups: + - docs + +{%- else %} + commands: - asdf plugin add uv - asdf install uv latest - asdf global uv latest - uv sync --group docs - {%- if cookiecutter.docs == 'sphinx' %} - - uv run python -m sphinx -T -b html -d docs/_build/doctrees -D language=en - docs $READTHEDOCS_OUTPUT/html - {%- elif cookiecutter.docs == 'mkdocs' %} + {%- if cookiecutter.docs == 'mkdocs' %} - uv run mkdocs build --site-dir $READTHEDOCS_OUTPUT/html {%- elif cookiecutter.docs == 'zensical' %} - uv run zensical build - mkdir -p $READTHEDOCS_OUTPUT/html/ - cp --recursive site/* $READTHEDOCS_OUTPUT/html/ {%- endif %} + +{%- endif %}