source: rtems-docs/common/rtemsdomain.py @ 2a06644

5am
Last change on this file since 2a06644 was 2a06644, checked in by Richard Campbell <richard.campbell@…>, on Feb 22, 2018 at 4:23:08 PM

RTEMS Docs: Check sphinx version

Sphinx.util.compat module was removed at Sphinx version 1.7.
Imported module was not being used.

Closes #3311.

  • Property mode set to 100644
File size: 3.5 KB
Line 
1from docutils import nodes
2from docutils.parsers.rst import directives
3
4from sphinx import addnodes
5from sphinx.roles import XRefRole
6from sphinx.locale import l_, _
7from sphinx.directives import ObjectDescription
8from sphinx.domains import Domain, ObjType, Index
9from sphinx.util.nodes import make_refnode
10from sphinx.util.docfields import Field, TypedField
11
12"""
13:r:bsp:`sparc/sis`
14
15:r:arch:`sparc`
16
17:r:board:`...`
18
19:r:user:`amar`
20
21:r:list:`devel`
22"""
23
24role_name = {
25        "bsp":          "BSP",
26        "arch":         "Architecture",
27        "board":        "Board",
28        "user":         "User",
29        "list":         "Mailing List",
30        "rtems":        "`RTEMS`",
31}
32
33role_url = {
34        "trac":                         ("Trac",                                "https://devel.rtems.org"),
35        "devel":                        ("Developer Site",              "https://devel.rtems.org"),
36        "www":                          ("RTEMS Home",                  "https://www.rtems.org/"),
37        "buildbot":                     ("Buildbot Instance",   "https://buildbot.rtems.org/"),
38        "builder":                      ("Builder Site",                "https://builder.rtems.org/"),
39        "docs":                         ("Documentation Site",  "https://docs.rtems.org/"),
40        "lists":                        ("Mailing Lists",               "https://lists.rtems.org/"),
41        "git":                          ("Git Repositories",    "https://git.rtems.org/"),
42        "ftp":                          ("FTP File Server",     "https://ftp.rtems.org/"),
43        "review":                       ("Gerrit Code Review",  "https://review.rtems.org/"),
44        "bugs":                         ("Bugs Database",               "https://devel.rtems.org/wiki/Bugs/"),
45        "gsoc":                         ("Google Summer of Code", "https://devel.rtems.org/wiki/GSoC/"),
46        "socis":                        ("ESA SOCIS",                   "https://devel.rtems.org/wiki/SOCIS/")
47}
48
49
50role_list = {
51        "announce":     ("Announce Mailing List",                       "https://lists.rtems.org/mailman/listinfo/announce/"),
52        "bugs":         ("Bugs Mailing List",                           "https://lists.rtems.org/mailman/listinfo/bugs/"),
53        "devel":        ("Developers Mailing List",                     "https://lists.rtems.org/mailman/listinfo/devel/"),
54        "build":        ("Build logs",                                          "https://lists.rtems.org/mailman/listinfo/build"),
55        "users":        ("Users Mailing List",                          "https://lists.rtems.org/mailman/listinfo/users/"),
56        "vc":           ("Version Control Mailing List",        "https://lists.rtems.org/mailman/listinfo/vc/"),
57}
58
59
60def rtems_resolve_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
61        role = name.split(":")[1] #XXX: is there a better way?
62
63        try:
64                if role == "list":
65                        text, url = role_list[text]
66                elif role == "url":
67                        text, url = role_url[text]
68        except KeyError:
69                msg = inliner.reporter.error("rtems_resolve_role: '%s' is not a valid %s" % (text, role))
70                err = inliner.problematic("ERROR: %s" % rawtext, None, msg)
71                return [err], [msg]
72
73        # XXX: how do you add an alt tag?
74        node = nodes.reference(rawtext, text, refuri=url, **options)
75        return [node], []
76
77
78
79class RTEMSXrefRole(XRefRole):
80        def __init__(self, item, title, **kwargs):
81                XRefRole.__init__(self, **kwargs)
82                self.item = item
83                self.title = title
84
85        def process_link(self, env, refnode, has_explicit_title, title, target):
86                if has_explicit_title:
87                        title = has_explicit_title
88
89                return has_explicit_title or self.title, target
90
91
92
93
94class RTEMSDomain(Domain):
95        """RTEMS domain."""
96
97        name = "r"
98        label = "RTEMS"
99
100        directives = {}
101        object_types = {}
102
103        roles = {
104                "bsp":          RTEMSXrefRole("bsp", "BSP"),
105                "arch":         RTEMSXrefRole("arch", "Architecture"),
106                "user":         RTEMSXrefRole("user", "User"),
107                "list":         rtems_resolve_role,
108                "url":          rtems_resolve_role,
109        }
110
111
112        def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):
113                info = "*info*"
114                anchor = "*anchor*"
115                title = "*title*"
116
117                return make_refnode(builder, fromdocname, info, anchor, contnode, title)
118
119        def merge_domaindata(self, docnames, otherdata):
120                pass # XXX is this needed?
121
122
123
124def setup(app):
125        app.add_domain(RTEMSDomain)
126        return {'version': "1.0", 'parallel_read_safe': True}
Note: See TracBrowser for help on using the repository browser.