Sphinx citation title

citename.py

import docutils.nodes
import sphinx.roles


class CiteRole(sphinx.roles.XRefRole):
    def result_nodes(self, document, env, node, is_ref):
        keys = node['reftarget'].split(',')
        refnodes = [
            docutils.nodes.reference(classes=['citation'], refuri=key)
            for key in keys]
        return refnodes, []


def process_citation_references(app, doctree, docname):
    mapping = {}
    for node in doctree.traverse(docutils.nodes.citation):
        mapping[node[0].astext()] = node[1][:]

    for node in doctree.traverse(docutils.nodes.reference):
        if node['classes'] == ['citation']:
            idx = node.parent.index(node)
            node.parent[idx:idx] = mapping[node['refuri']]


def setup(app):
    app.add_role("citename", CiteRole())
    app.connect("doctree-resolved", process_citation_references)