Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Sphinx - generate automatic references to Trac tickets and changesets

Is Sphinx, is there way to automatically link text like #112 or r1023 to the corresponding tickets/changesets in Trac?

For eg:

#112  -> http://mytracsite/tickets/112
r1023 -> http://mytracsite/changeset/1023

See TracLinks for more examples.

like image 998
Sridhar Ratnakumar Avatar asked Jan 19 '10 19:01

Sridhar Ratnakumar


2 Answers

If you put this in your config.py


trac_url = 'http://mytratsite/'

from docutils import nodes, utils
from docutils.parsers.rst import roles
import urllib

def trac_role(role, rawtext, text, lineno, inliner, options={}, content=[]):
  ref = trac_url + '/intertrac/' + urllib.quote(text, safe='')
  node = nodes.reference(rawtext, utils.unescape(text), refuri=ref, **options)
  return [node],[]

roles.register_canonical_role('trac', trac_role)

Then you can use :trac:`#123` and :trac:`r1023` in your documents.

This is probably the easiest way to make quick links to a trac site. It automatically works for all kinds of TracLinks because it uses the intertrac mechanism for the links.

like image 158
Geoff Reedy Avatar answered Nov 03 '22 19:11

Geoff Reedy


Sphinx 1.0 now supports external links using the extlinks extension. Using a configurable role name (e.g. 'issue') you can write your links like:

:issue:`123`

and it will be converted to http://mytracsite/123.

like image 40
Kurt McKee Avatar answered Nov 03 '22 17:11

Kurt McKee