mirror of
https://github.com/jazzband/django-configurations.git
synced 2026-03-16 22:20:27 +00:00
* Refactor the documentation build process Significant improvements: * Allow easy isolated local builds via a dedicated Tox environment * Configure Sphinx to use consistent packages and theme across local, CI, and ReadTheDocs builds; local builds now look the same as the published RTD pages * Explicitly add a ReadTheDocs configuration as code, per their documented best practices * Remove lots of dead code and simplify the Sphinx configuration file * Build docs in a dedicated CI step and enable stricter warning checking * Fix docutils related build error. * Relax Sphinx version. * Invalidate RTD build cache. * No need to combine coverage reporting I think. * Add combining again. Co-authored-by: Jannis Leidel <jannis@leidel.info>
16 lines
225 B
YAML
16 lines
225 B
YAML
---
|
|
version: 2
|
|
build:
|
|
os: ubuntu-20.04
|
|
tools:
|
|
python: "3.9"
|
|
python:
|
|
install:
|
|
- requirements: docs/requirements.txt
|
|
- method: pip
|
|
path: .
|
|
sphinx:
|
|
configuration: docs/conf.py
|
|
formats:
|
|
- epub
|
|
- pdf
|