readthedocs-custom-steps 0.1.0

Package description here.

readthedocs-custom-steps

A hack to run custom steps when building documentation on Read the Docs.

Configuration

# .readthedocs.yml
version: 2
mkdocs: {}  # tell readthedocs to use mkdocs
python:
  version: 3.7
  install:
    - requirements: readthedocs-custom-steps  # ...
x-custom-steps:
  - echo "Custom steps to build documentation at $SITE_DIR here"

Important: This module should not be installed outside of a Read the Docs build environment. It will rename your Python executable and install a substitute. It does not currently provide an automated way to revert this change.

Testing this package

To test this package in a similar environment as Read the Docs itself, you can run make -f test/Makefile. Note that this requires Docker and a Docker volume called pip-caches. Note that the Make command is expected to return status code 27 as defined in the test/readthedocs-config.yml file.

---

Copyright © 2020 Niklas Rosenstein