ext.py

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


class CodeHref(ReferenceRole):
    def run(self):
        if '``' in self.title:
            result = []
            parts = self.title.split('``')
            result.append(self.create_ref(parts.pop(0)))
            while parts:
                result.append(nodes.literal('', '', self.create_ref(parts.pop(0))))
                result.append(self.create_ref(parts.pop(0)))

            return result, []
        else:
            return [nodes.literal('', '', self.create_ref(self.title))], []

    def create_ref(self, text):
        return nodes.reference(text, text, refuri=self.target)



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