opendylan
opendylan copied to clipboard
Provide wrapper for sphinx-build
Look at providing a wrapper for sphinx-build that customizes some settings for Dylan documentation builds, like defaulting the theme or the theme search paths.
Thoughts:
- The gendoc library generates combined documentation for all published packages, ameliorating this somewhat, since it means that only the conf.py in gendoc is used. Of course, sometimes one wants to build one's own docs and publish them separately, so...
dylan new libraryshould generate initial documentation, probably by invokingsphinx-quickstartwith most/all of the fields filled in and fail in a friendly way ifsphinx-quickstartis not present.
I think we can close this now that Deft generates Sphinx doc with an appropriate config for Dylan.