Doesn't seem to convert in parallel about sphinxcontrib-drawio

[jdillard]

The more I look into this, the more I realize I don't know how to test for success. We are running Sphinx in parallel, but I can't say for sure if the drawio portion is or not, so I'd take this as a grain of salt for now. The cache is great, but it only works on incremental builds (since the cache has to be built the first time around), but I have thought about having the option to host the cached files somewhere and pull those down (not sure the feasibility yet though).

I'll keep digging and look into the editable PNGs or SVGs as well and post any relevant updates, for clarity's sake. Thanks!

Edit: I think the limiting factor is that drawio is spun up for each conversion, vs doing a bulk conversion (using a folder) vs a single file. There are some limitations to that including only being able to pass one set of options to the whole folder and not being able to convert specific pages in a single file.

[modelmat]

You will have to run sphinx with https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-j.

This defaults to 1.

I haven't ever seen this really used, and haven't ever tested it myself, so I don't know how well it will go, or whether issues will come up from multiple instances at once.

I will note that if build times are an issue, committing editable PNGs or SVGs (mentioned in this project's README) might be a better option for you, as it removes the need for this extension entirely & the conversion process.
I believe this extension should also be caching the built images, too...