]> git-server-git.apps.pok.os.sepia.ceph.com Git - ceph.git/commit
doc: use plantweb as fallback of sphinx-ditaa
authorKefu Chai <kchai@redhat.com>
Thu, 9 Apr 2020 13:25:39 +0000 (21:25 +0800)
committerKefu Chai <kchai@redhat.com>
Thu, 17 Sep 2020 01:44:51 +0000 (09:44 +0800)
commitfff06a537ce153a4b88080e7722e0d583bacc68b
tree90d7bf828e585cba0af1cf0c67eb62a769b0652f
parent9621224d8276b2d048cd6558986088ab3168adef
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>
(cherry picked from commit 0cb56e0f13dc57167271ec7f20f11421416196a2)

Conflicts:
doc/cephfs/cephfs-io-path.rst
doc/dev/deduplication.rst
doc/install/ceph-deploy/quick-cephfs.rst
doc/radosgw/vault.rst
doc/rbd/rbd-kubernetes.rst
doc/rbd/rbd-persistent-cache.rst: these file does not exist in
          nautilus, so drop related changes
30 files changed:
.readthedocs.yml
admin/doc-read-the-docs.txt [new file with mode: 0644]
doc/architecture.rst
doc/conf.py
doc/dev/msgr2.rst
doc/install/install-vm-cloud.rst
doc/install/manual-deployment.rst
doc/install/manual-freebsd-deployment.rst
doc/rados/api/librados-intro.rst
doc/rados/configuration/mon-config-ref.rst
doc/rados/configuration/mon-osd-interaction.rst
doc/rados/configuration/network-config-ref.rst
doc/rados/operations/cache-tiering.rst
doc/rados/operations/monitoring-osd-pg.rst
doc/rados/operations/placement-groups.rst
doc/rados/operations/user-management.rst
doc/radosgw/admin.rst
doc/radosgw/index.rst
doc/radosgw/swift/tutorial.rst
doc/rbd/index.rst
doc/rbd/libvirt.rst
doc/rbd/qemu-rbd.rst
doc/rbd/rbd-cloudstack.rst
doc/rbd/rbd-live-migration.rst
doc/rbd/rbd-openstack.rst
doc/rbd/rbd-snapshot.rst
doc/start/intro.rst
doc/start/quick-ceph-deploy.rst
doc/start/quick-common.rst
doc/start/quick-rbd.rst