mirror of
https://git.rtems.org/rtems-docs/
synced 2025-05-15 04:16:57 +08:00
58 lines
1.9 KiB
Python
58 lines
1.9 KiB
Python
from docutils import nodes
|
|
import sphinx.domains.std
|
|
|
|
# Borrowed from: http://stackoverflow.com/questions/13848328/sphinx-references-to-other-sections-containing-section-number-and-section-title
|
|
class CustomStandardDomain(sphinx.domains.std.StandardDomain):
|
|
|
|
def __init__(self, env):
|
|
env.settings['footnote_references'] = 'superscript'
|
|
sphinx.domains.std.StandardDomain.__init__(self, env)
|
|
|
|
def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):
|
|
res = super(CustomStandardDomain, self).resolve_xref(env, fromdocname, builder, typ, target, node, contnode)
|
|
|
|
if res is None:
|
|
return res
|
|
|
|
if typ == 'ref' and not node['refexplicit']:
|
|
docname, labelid, sectname = self.data['labels'].get(target, ('','',''))
|
|
res['refdocname'] = docname
|
|
|
|
return res
|
|
|
|
def doctree_resolved(app, doctree, docname):
|
|
secnums = app.builder.env.toc_secnumbers
|
|
for node in doctree.traverse(nodes.reference):
|
|
if 'refdocname' in node:
|
|
refdocname = node['refdocname']
|
|
if refdocname in secnums:
|
|
secnum = secnums[refdocname]
|
|
emphnode = node.children[0]
|
|
textnode = emphnode.children[0]
|
|
|
|
toclist = app.builder.env.tocs[refdocname]
|
|
anchorname = None
|
|
for refnode in toclist.traverse(nodes.reference):
|
|
if refnode.astext() == textnode.astext():
|
|
anchorname = refnode['anchorname']
|
|
if anchorname is None:
|
|
continue
|
|
sec_number = secnum[anchorname]
|
|
chapter = sec_number[0]
|
|
section = None
|
|
|
|
if len(sec_number) > 1:
|
|
section = ".".join(map(str, sec_number[1:]))
|
|
|
|
if section:
|
|
node.replace(emphnode, nodes.Text("Chapter %s Section %s - %s" % (chapter, section, textnode)))
|
|
else:
|
|
node.replace(emphnode, nodes.Text("Chapter %s - %s" % (chapter, textnode)))
|
|
|
|
def setup(app):
|
|
app.override_domain(CustomStandardDomain)
|
|
app.connect('doctree-resolved', doctree_resolved)
|
|
|
|
return {'version': "1.0", 'parallel_read_safe': True}
|
|
|