ceph/.readthedocs.yml

---
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

version: 2
formats: []
build:
  image: latest
python:
  version: 3
  install:
    - requirements: admin/doc-requirements.txt
    - requirements: admin/doc-read-the-docs.txt
    - requirements: admin/doc-pybind.txt
sphinx:
  builder: dirhtml
  configuration: doc/conf.py
readthedocs: add .readthedocs.yml Signed-off-by: Kefu Chai <kchai@redhat.com> 2020-04-09 07:35:15 +00:00			`---`
			`# Read the Docs configuration file`
			`# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details`

			`version: 2`
			`formats: []`
			`build:`
			`image: latest`
			`python:`
			`version: 3`
			`install:`
			`- requirements: admin/doc-requirements.txt`
doc: use plantweb as fallback of sphinx-ditaa RTD does not support installing system packages, the only ways to install dependencies are setuptools and pip. while ditaa is a tool written in Java. so we need to find a native python tool allowing us to render ditaa images. plantweb is able to the web service for rendering the ditaa diagram. so let's use it as a fallback if "ditaa" is not around. also start a new line after the directive, otherwise planweb server will return 500 at seeing the diagram. Signed-off-by: Kefu Chai <kchai@redhat.com> 2020-04-09 13:25:39 +00:00			`- requirements: admin/doc-read-the-docs.txt`
admin/build-doc: consolidate the build deps into admin/doc-pybind.txt since all the python bindings are required for building the doc, extract them into admin/doc-pybind.txt. because the pybind python extensions require Cython python module to build, we have to move them into another requirement file, and install them after Cython is installed. Signed-off-by: Kefu Chai <kchai@redhat.com> 2020-12-12 07:09:49 +00:00			`- requirements: admin/doc-pybind.txt`
readthedocs: add .readthedocs.yml Signed-off-by: Kefu Chai <kchai@redhat.com> 2020-04-09 07:35:15 +00:00			`sphinx:`
			`builder: dirhtml`
			`configuration: doc/conf.py`