#13116: The :trac: sphinx role does not work on the commandline
---------------------------------+------------------------------------------
Reporter: vbraun | Owner: mvngu
Type: defect | Status: needs_review
Priority: major | Milestone: sage-5.1
Component: documentation | Resolution:
Keywords: | Work issues:
Report Upstream: N/A | Reviewers:
Authors: John Palmieri | Merged in:
Dependencies: | Stopgaps:
---------------------------------+------------------------------------------
Comment (by jhpalmieri):
Replying to [comment:8 vbraun]:
> How about just `see http://trac.sagemath.org/12849:`.
Sure, that sounds fine.
> Also, I don't really understand why we are reimplementing sphinx here.
Shouldn't we make `sphinxify()` spit out the correct urls instead of this
bandaid? The `:wikipedia:` sphinx role would then also work, for example.
Okay, here's a better approach: turn on the "extlinks" Sphinx extension
when doing introspection. Then in the notebook, docstrings look fine, but
from the command line, `see :trac:`12849`` turns into `see trac ticket
#12849`: it includes the text, but not the associated url. So I think we
should still insert the url, so I still have a version of `process_trac`.
This version should also handle any other roles defined in `extlinks`.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/13116#comment:9>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
