search

canonical / sphinx-docs-starter-pack

A documentation starter-pack
https://canonical-starter-pack.readthedocs-hosted.com/
Other
16 stars 43 forks source link

```make run``` command error #276

Closed beoin closed 2 months ago

beoin commented 2 months ago

In a clean state make run is currently throwing a FileNotFoundError.

To get around this build the project with make html first. This produces the required _build directory which satisfies subsequent calls to make run.

From a quick investigation the issue appears to be related to the arguments passed to sphinx-autobuild via sp-run.

SecondSkoll commented 2 months ago

This is an issue with the new release of sphinx-autobuild. I've tested and submitted an issue for them to fix here.

For now I would recommend using the workaround you have suggested, as the fix to sphinx-autobuild should be trivial. If it isn't fixed in the next few days we'll pin the old version internally.

We will be looking at pinning versions of all pip packages next cycle, which should prevent this issue from happening again - but we'll have to discuss this with the larger technical author team.

SecondSkoll commented 2 months ago

This has been resolved upstream with the merge of https://github.com/sphinx-doc/sphinx-autobuild/pull/175