ext.py

# リテラルスタイルのアンカーを作る
#
# 使い方: :codehref:`blah blah blah <http://path.to/anywhere>`
#
from docutils import nodes
from sphinx.util.docutils import ReferenceRole


class CodeHref(ReferenceRole):
    def run(self):
        ref = nodes.reference(self.title, self.title, refuri=self.target)

        return [nodes.literal('', '', ref)], []


def setup(app):
    app.add_role('codehref', CodeHref())