On Wed, Mar 10, 2010 at 11:59:57AM -0600, Kevin Horn wrote:
> On Wed, Mar 10, 2010 at 11:15 AM, Mike Pumphrey <[email protected]> wrote:
>
> > I have a few Sphinx projects in svn, and there is some content overlap. I
> > would like to pull certain pages / sets of pages from another project, and
> > I'm curious the best way to do this.
> >
> > I have looked at the intersphinx extension, but it appears to hinge on
> > having the docs online at a URL, which isn't what we have. I have also
> > tried to add an external file in the toctree, but the toctree doesn't seem
> > to be able to find the external file. For example:
> >
> > .. toctree::
> >
> > some/local/file.rst
> > ../../../some/other/project.rst
> >
> > This yields a "can't find file'some/other/project.rst'"
> >
> > I do note that the include directive does see the file at
> > "../../../some/other/project.rst", so I wonder if I should just create empty
> > .rst files with a single include directive.
> >
> > I'm basically trying to figure out a way to do this without resorting to
> > using svn externals, which could get ugly fast. Can anyone give any
> > suggestions? Thanks in advance.
> >
> >
> > Thanks,
> > Mike Pumphrey
> > OpenGeo - http://opengeo.org
> >
>
> Have you tried using intersphinx with a file:// url? I haven't, so I have
> no idea whether it will work, but it might be worth a shot.
>
Just to confirm this works.
If the objects.inv file of another project is in the directory (absolute)
/path/to/objects/inv/, then an entry in the conf.py intersphinx_mapping
dictionary of either
'file:///path/to/objects/inv/':None
or
'/path/to/objects/inv/':None
works.
>From the docs:
> "Relative local paths in the keys are taken as relative to the base of the
> built documentation, while relative local paths in the values are taken as
> relative to the source directory."
--
Anita
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en.
