Sign inSign up

networktocode/sphinx-docs

By networktocode

Updated over 5 years ago

Sphinx development container

Image
0

490

networktocode/sphinx-docs repository overview

sphinx-docs

Sphinx documentation Docker container for easy development

Requirements

Docker is required to run this container.

The scripts and Sphinx installation is built against Sphinx 3.2.1 and Python 3.8. Support could be added later if there's enough interest in other versions.

Installation

This container is provided as networktocode/sphinx-docs on Docker Hub for your enjoyment.

docker pull networktocode/sphinx-docs

Usage

Environment variables
  • SPHINX_DEFAULT_INDEX
  • SPHINX_DIRECT_INSTALL
  • SPHINX_PROJECT
  • SPHINX_PROJECT_PATH
  • SPHINX_SKIP_API_DOCS
  • SPHINX_SKIP_CLEAN
./entrypoint.sh [--watch|--serve|--help] [SPHINX_PROJECT]

Entrypoint script for Sphinx container.

Environment variables:
  SPHINX_PROJECT           Name of the Sphinx project to import for Documentation metadata
  SPHINX_SKIP_API_DOCS     Set to to skip generating autodocs
  SPHINX_SKIP_CLEAN        Set to skip cleaning build and API directories
  SPHINX_SKIP_PROJECT      Set to skip project dependency install stage - useful for non-Python or non-standard projects
  SPHINX_DIRECT_INSTALL    Set to do a 'poetry install' direct package install instead of a local install
  SPHINX_PROJECT_PATH      Set to override the default path of /usr/local/src/

Arguments:
  --watch           Watch for Python file changes in the current directory and render and serve documentation as it changes
  --serve           Serve the rendered documentation
  --skip-api        Skip generating API docs
  --skip-clean      Skip cleaning build and API directories
  --skip-project    Skip installing the project and related checks
  --help            Display this help and exit

TODO

Contributing

TODO

Tag summary

Content type

Image

Digest

Size

414.6 MB

Last updated

over 5 years ago

docker pull networktocode/sphinx-docs