[tor-bugs] #8671 [Stem]: Add a custom role for trac tickets

[Tor Bug Tracker & Wiki]

#8671: Add a custom role for trac tickets
--------------------------+-------------------------------------------------
 Reporter:  atagar        |          Owner:  atagar
     Type:  enhancement   |         Status:  new   
 Priority:  minor         |      Milestone:        
Component:  Stem          |        Version:        
 Keywords:  website easy  |         Parent:        
   Points:                |   Actualpoints:        
--------------------------+-------------------------------------------------
 It would be useful if, in our sphinx docs, we could use...

 {{{
 :trac:`1234`
 }}}

 ... to link to ticket #1234 rather than need to provide a full url every
 time. This will make our docs more readable and less error prone, and is
 quite doable via a custom sphinx role. For information on how to do this
 see [http://doughellmann.com/2010/05/defining-custom-roles-in-sphinx.html
 this tutorial] (or his [http://pyvideo.org/video/1703/better-
 documentation-through-automation-creating pycon presentation] about it).

-- 
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/8671>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online