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.
