1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
from docutils import nodes
from docutils.parsers.rst import directives
from sphinx import addnodes
from sphinx.roles import XRefRole
from sphinx.directives import ObjectDescription
from sphinx.domains import Domain, ObjType, Index
from sphinx.util.nodes import make_refnode
from sphinx.util.docfields import Field, TypedField
import version as rtems_version
"""
:r:bsp:`sparc/sis`
:r:arch:`sparc`
:r:board:`...`
:r:user:`amar`
:r:list:`devel`
"""
role_name = {
"bsp": "BSP",
"arch": "Architecture",
"board": "Board",
"user": "User",
"list": "Mailing List",
"rtems": "`RTEMS`",
}
role_url = {
"trac": ("Trac", "https://devel.rtems.org"),
"devel": ("Developer Site", "https://devel.rtems.org"),
"www": ("RTEMS Home", "https://www.rtems.org/"),
"buildbot": ("Buildbot Instance", "https://buildbot.rtems.org/"),
"builder": ("Builder Site", "https://builder.rtems.org/"),
"docs": ("Documentation Site", "https://docs.rtems.org/"),
"lists": ("Mailing Lists", "https://lists.rtems.org/"),
"git": ("Git Repositories", "https://git.rtems.org/"),
"ftp": ("FTP File Server", "https://ftp.rtems.org/"),
"review": ("Gerrit Code Review", "https://review.rtems.org/"),
"bugs": ("Bugs Database", "https://devel.rtems.org/wiki/Bugs/"),
"gsoc": ("Google Summer of Code", "https://devel.rtems.org/wiki/GSoC/"),
"socis": ("ESA SOCIS", "https://devel.rtems.org/wiki/SOCIS/")
}
role_list = {
"announce": ("Announce Mailing List", "https://lists.rtems.org/mailman/listinfo/announce/"),
"bugs": ("Bugs Mailing List", "https://lists.rtems.org/mailman/listinfo/bugs/"),
"devel": ("Developers Mailing List", "https://lists.rtems.org/mailman/listinfo/devel/"),
"build": ("Build Logs", "https://lists.rtems.org/mailman/listinfo/build"),
"users": ("Users Mailing List", "https://lists.rtems.org/mailman/listinfo/users/"),
"vc": ("Version Control Mailing List", "https://lists.rtems.org/mailman/listinfo/vc/"),
}
def rtems_resolve_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
role = name.split(":")[1] #XXX: is there a better way?
try:
if role == "list":
text, url = role_list[text]
elif role == "url":
text, url = role_url[text]
except KeyError:
msg = inliner.reporter.error("rtems_resolve_role: '%s' is not a valid %s" % (text, role))
err = inliner.problematic("ERROR: %s" % rawtext, None, msg)
return [err], [msg]
# XXX: how do you add an alt tag?
node = nodes.reference(rawtext, text, refuri=url, **options)
return [node], []
class RTEMSXrefRole(XRefRole):
def __init__(self, item, title, **kwargs):
XRefRole.__init__(self, **kwargs)
self.item = item
self.title = title
def process_link(self, env, refnode, has_explicit_title, title, target):
if has_explicit_title:
title = has_explicit_title
return has_explicit_title or self.title, target
class RTEMSDomain(Domain):
"""RTEMS domain."""
name = "r"
label = "RTEMS"
directives = {}
object_types = {}
roles = {
"bsp": RTEMSXrefRole("bsp", "BSP"),
"arch": RTEMSXrefRole("arch", "Architecture"),
"user": RTEMSXrefRole("user", "User"),
"list": rtems_resolve_role,
"url": rtems_resolve_role,
}
def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):
info = "*info*"
anchor = "*anchor*"
title = "*title*"
return make_refnode(builder, fromdocname, info, anchor, contnode, title)
def merge_domaindata(self, docnames, otherdata):
pass # XXX is this needed?
def rtems_replace(app, docname, source):
dump = False
line = source[0]
for key in app.config.replacements:
line = line.replace(key, app.config.replacements[key])
source[0] = line
replacements = {
}
def setup(app):
app.add_config_value('rtems_major', str(app.config.overrides['rtems_major']), True)
app.add_config_value('rtems_minor', str(app.config.overrides['rtems_minor']), True)
app.add_config_value('rtems_revision', str(app.config.overrides['rtems_revision']), True)
major = str(app.config.overrides['rtems_major'])
minor = str(app.config.overrides['rtems_minor'])
revision = str(app.config.overrides['rtems_revision'])
if revision.isdigit():
majminrev = major + '.' + minor + '.' + revision
else:
majminrev = major + '.' + revision
replacements["@rtems-version@"] = str(app.config.overrides['version'])
replacements["@rtems-ver-major@"] = major
replacements["@rtems-ver-minor@"] = minor
replacements["@rtems-ver-revision@"] = revision
replacements["@rtems-ver-majminrev@"] = majminrev
app.add_config_value('replacements', replacements, True)
app.connect('source-read', rtems_replace)
app.add_domain(RTEMSDomain)
return {'version': "1.0", 'parallel_read_safe': True}
|