Hi Ned,

I've had this problem myself. If you build a given Sphinx project pointing
to a not yet built .inv file (or files), Sphinx will issue a bunch of
warnings (e.g., `WARNING: intersphinx inventory
'../path_to_other_project/objects.inv' not fetchable` ) but Sphinx will
build the project's own .inv file successfully. So I do a two-pass build
that ignores warnings on the first pass and ignores the saved environment
on the second pass. It looks a bit like this (though there's an
overcomplicated fabfile to do this all for me):

For each project, first pass, ignoring warnings:
> make SPHINXOPTS='-Q' html

For each project, second pass (or more, if you're building additional
formats):
> make SPHINXOPTS='-E -n -W' html

`-E` is the important part, forcing Sphinx to refetch the .inv file(s). I
like to use `-n` for nitpicky mode and `-W` to promote warnings to errors,
since I expect warnings in the first pass but would rather not have the
build succeed at all if there are unexpected warnings (your preferences—and
authorial discipline—may vary).

You might also want to add `-q` because seeing the build progress over and
over gets old fast.

A dedicated inventory builder would be nice to have, but this gets the job
done for me. I hope it helps solve your problem!


—Daniel


On Fri, Jan 22, 2016 at 5:30 PM, Ned Batchelder <n...@nedbatchelder.com>
wrote:

> At edX, we're using intersphinx to link among our own projects.  But it's
> designed to pull .inv files from readthedocs.  This means if we add a new
> reference between projects, the build will fail until the target has been
> published.  I tried using the second value in the mapping tuple to point to
> a local file, but the file hadn't been created yet.
>
> Is there a way to generate all the .inv files in a first pass, and then do
> the full build of the doc?
>
> --Ned.
>
> --
> 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 sphinx-users+unsubscr...@googlegroups.com.
> To post to this group, send email to sphinx-users@googlegroups.com.
> Visit this group at https://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>

-- 
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 sphinx-users+unsubscr...@googlegroups.com.
To post to this group, send email to sphinx-users@googlegroups.com.
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to