id	summary	reporter	owner	description	type	status	priority	milestone	component	version	resolution	keywords	cc	blockedby	blocking	notify_on_close	platform	project
1077	Working with InterSphinx	Tristan Croll	Greg Couch	"(Hope I'm asking the right person!)

I'm finally getting around to seriously documenting ISOLDE's API (now that it's settled to the point where that's a worthwhile endeavour). It would be great to be able to use InterSphinx to automatically link references to ChimeraX classes back to the ChimeraX documentation, but I'm struggling to make that work.

I've added `sphinx.ext.intersphinx` to my Sphinx `conf.py`, and

{{{
intersphinx_mapping = {
    'chimerax': ('http://preview.cgl.ucsf.edu/chimerax/docs/devel', None),
}
}}}

... which triggers the Sphinx build to correctly download objects.inv, but that's where I'm stuck. Including a reference to e.g. 

{{{
:py:class:`chimerax.Atom`
}}}

... which *should* just work according to the intersphinx docs, doesn't find a way to link through (nor does chimerax.atomic.Atom or chimerax.core.atomic.Atom). "	defect	assigned	minor		Documentation								all	ChimeraX