A Python Sphinx Toolkit written in Java.
Currently the following utilities are available.
-
The class
EncodeDecodeObjectInv
is capable of encoding and decoding objects.inv files. This class has amain()
method, so run it to know how to use it. -
Class
Django
is specialized to 'fix' Django'sobjects.inv
files. The original ones which can be downloaded fromhttp://docs.djangoproject.com/en/<version>/_objects/
do not have fully qualified references for some classes. Take for example,django.forms.Select
. Although this reference is correct, but when using autodoc andshow-inheritance
option, it will generate the pathdjango.forms.widgets.Select
, which is the actual path. Unfortunately Django's providedobjects.inv
has no reference fordjango.forms.widgets.Select
, resulting inintersphinx
unable to link such references.This class will go over the known patterns in the original
objects.inv
and create a new one with all the missing references. Note that,main()
of classEncodeDecodeObjectInv
exposes this class for the user.
Some special files mentioned:-
- django1.4.1.inv - Is the 'fixed'
objects.inv
file of Django version 1.4.1. - sphinxutil.jar - Is a runnable jar of this util.