25 lines
561 B
Python
25 lines
561 B
Python
# -*- coding: utf-8 -*-
|
|
"""
|
|
pyspecific.py
|
|
~~~~~~~~~~~~~
|
|
|
|
Sphinx extension with Python doc-specific markup.
|
|
|
|
:copyright: 2008 by Georg Brandl.
|
|
:license: Python license.
|
|
"""
|
|
|
|
ISSUE_URI = 'http://bugs.python.org/issue%s'
|
|
|
|
from docutils import nodes, utils
|
|
|
|
def issue_role(typ, rawtext, text, lineno, inliner, options={}, content=[]):
|
|
issue = utils.unescape(text)
|
|
text = 'issue ' + issue
|
|
refnode = nodes.reference(text, text, refuri=ISSUE_URI % issue)
|
|
return [refnode], []
|
|
|
|
|
|
def setup(app):
|
|
app.add_role('issue', issue_role)
|