most cross-references in sphinx-generated HTML are wrong
|Reported by:||niccl||Owned by:||nobody|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
to reproduce (an example)
- generate the sphinx html documentation using make html in the django_trunk/docs directory
- (eg) open
_build/html/install.htmlin a browser. The link 'How to use Django with mod_python' (in the Install Apache and mod_python section) points to a modpython directory in the directory above the original directory, instead of modpython.html at the same level as the original file
The reason is that the references are not in the form suggested by the sphinx documentation (http://sphinx.pocoo.org/markup/inline.html#cross-referencing-syntax).
A quick grep indicates there are about 320 instances of the wrong links across 56 of the .txt files.
I'd be happy to claim this ticket, but it seems like there's be a great option for merge conflicts with that many files. Any suggestions? feel free to contact me at nic \at\ tymar \dot\ com if there's an easy way of avoiding conflicts