The Octavia project has a few graphviz diagrams in it's documentation. You can reference that project to see how it is done. That said, we have seen a decline in the stability of the graphviz code over the last few years (cylinder object disappeared, graphviz dot crashes on Ubuntu, etc.) that we have had to work around to get the diagrams to continue to render. Because of that I would recommend you use it sparingly.
Michael On Mon, Nov 13, 2017 at 2:08 AM, Sean McGinnis <[email protected]> wrote: > On Mon, Nov 13, 2017 at 09:16:59AM +0000, Yujun Zhang (ZTE) wrote: >> Hi, all >> >> Sometimes a picture worths thousands word. I wonder if it is possible to >> support graphviz in https://docs.openstack.org/ >> >> What I expect is to include a dot file and render it as a picture in HTML >> output. The syntax is simple >> >> .. graphviz:: aggregate-equivalent-alarms.files/example.dot >> >> And should be supported by sphinx graphviz plugin[2] >> > > Hey Yujun, > > The graphviz directive is currently supported [0]. Though the control over the > output leaves a little to be desired [1]. > > I'm not sure about referencing dotfiles, but most needs are fairly small and > can be done inline like the example above. > > [0] > https://git.openstack.org/cgit/openstack/cinder/tree/doc/source/contributor/api_microversion_dev.rst#n81 > [1] > https://docs.openstack.org/cinder/latest/contributor/api_microversion_dev.html > > __________________________________________________________________________ > OpenStack Development Mailing List (not for usage questions) > Unsubscribe: [email protected]?subject:unsubscribe > http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev __________________________________________________________________________ OpenStack Development Mailing List (not for usage questions) Unsubscribe: [email protected]?subject:unsubscribe http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
