Comments (4)
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.
from sphinxcontrib-drawio.
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...
from sphinxcontrib-drawio.
Related Issues (20)
- Embed text when exporting in svg file format HOT 4
- Stop clearing PDF scale args HOT 2
- Start a changelog HOT 1
- Sphinx's caching causes trouble with multiple builders
- Drawio uses .drawio folder in source directory for caching conversion. Should be in build dir HOT 1
- Incorporate documentation addition from #52 HOT 1
- figure properties set to Path instead of str HOT 1
- Fix not-working imgconverter HOT 1
- Make sphinxcontrib-drawio depend on sphinx HOT 1
- Clarification on Installation step HOT 1
- Xvfb Inifinite Loop HOT 2
- Getting random failures that have an empty stderr/stdout HOT 2
- Tests only run on Linux HOT 1
- Figure out why pypi releases do the release but then fail HOT 2
- Tests for transparency don't do any tests
- Fails with DrawIO Error: [WinError 5] Access is denied - because of whitespace in path
- More a question rather than a bug... HOT 2
- :format: pdf does not create anything ! HOT 4
- add support for "--layers" HOT 2
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from sphinxcontrib-drawio.