-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Am 07.01.2011 07:39, schrieb D. Monarres: > Hello all, > > Right now I am trying to write a tutorial for the Sage computer > algebra system that heavily cross-references with the standard > documentation. Sage loads almost all functions/classes into the > default namespace so most users know nothing of the module structure > of program. I was wondering if there would be anyway to strip the > module info from the :py:*:` ` directive. For example, the user only > knows about a function named var(), but the real name of this function > in sage is sage.symbolic.ring.var(). Is there anyway I can link to the > right place without having the user see the "sage.symbolic.ring" > portion? The target audience knows very little about python but I > would like to be able to point to the additional examples in the > standard reference.
If there is no ambiguity, you can reference the function as :func:`.var` It will display as "var" and link to the "sage.symbolic.ring.var" target. If there is an ambiguity, you will get a warning stating that fact. > ps. is there also a way I can have the external crossrefs open in a > new window? Not by default, no -- mandating the opening of links in a new windows is usually frowned upon nowadays. Georg -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.16 (GNU/Linux) iEYEARECAAYFAk0m6n8ACgkQN9GcIYhpnLC6pgCgoonqxr8W5sati1ojUy4zuRT8 fK4AoIV9Hxgc2EIbFQ/sgcIK0x8xx6fU =r4mr -----END PGP SIGNATURE----- -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
