This is a lot more automation than I'm used to - does it actually create a
separate source folder, and what is in it?
My first suggestion would be to examine your index.rst file and see what's
in your toctree, then compare that to the actual contents of the source
directory. That should tell you which documents are being referenced at the
wrong path.
On Monday, November 6, 2017 at 6:11:23 PM UTC-5, Quantum Mechanic wrote:
>
> I'm new to Sphinx, this may be a D'oh moment...
>
> I want to use separate source/build folders, but when I do, the make html
> step
> reports toctree contains reference to nonexisting document.
>
> The document is there (in so far as I can guess where it's looking, which
> is not absolutely certain, even given the trailing pathname).
>
> When I start from scratch, and don't specify separate source/build, the
> index.rst file is in the project root (not ./source), and it builds fine.
>
> Am I doing something wrong, or is there a subtle bug or gotcha here?
>
> For clarity, here are the command I issue from the root of my project:
>
> sphinx-quickstart --quiet \
> --project='Hub Delivery Automation' \
> --author=HDA \
> -v 0.1 \
> --release 0.1.1 \
> --dot=_ \
>
> --extensions=sphinx.ext.autodoc,sphinx.ext.todo,sphinx.ext.viewcode,sphinx.ext.napoleon
>
> \
> --makefile \
> --no-batchfile \
> --sep
>
> for dir in `find * -type d | egrep -v "(^_)|(^\.)|(/docs)"`; do \
> sphinx-apidoc -f -e -a -o ${dir}/docs ${dir}; \
> done
>
> make html
>
> If I remove the --sep, it works fine.
>
--
You received this message because you are subscribed to the Google Groups
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
