Hello

Sphinx is probably one of the most powerful documentation system, with 
dozens of abilities to reference python stuff, internet links and such but 
seems pretty obsessive in its refusal to let us link to local content that 
is not under its "conf.py" directory.

Is there any plan to support some syntax like this 
'local:my_other_package_in_the_python_path/any/path/relative/to/the/mentioned/package/root'

It would be beautiful if this worked with *include *as well as* :ref:* so 
that we could keep documentation in one relevant single point and reference 
it from other narratives documentations or more global documentation.

The one and one package roof/root only for doc becomes a real pain now that 
very little applications are built with only one python package or only one 
whatever is documented.

Right now the solutions are ugly and dangerous from copying (EVIL), 
intersphinx-ing with hard coded path to the final delivery point of the 
documentation (EVIL), symlinking (non portable, brittle, outside tooling 
through scripts), copying before building the doc (idem).

Is there a "philosophical" opposition to a solution or is this something 
planned I missed ?

Thanks a lot for this great tool.

.X.


-- 
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 [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to