mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
Implemented "simple" docroles for things that only format the text in a different style.
This commit is contained in:
parent
59cf3db674
commit
482720cf65
@ -22,17 +22,10 @@ from sphinx.util.nodes import split_explicit_title
|
|||||||
|
|
||||||
|
|
||||||
generic_docroles = {
|
generic_docroles = {
|
||||||
'command' : nodes.strong,
|
|
||||||
'dfn' : nodes.emphasis,
|
|
||||||
'guilabel' : nodes.strong,
|
|
||||||
'kbd' : nodes.literal,
|
|
||||||
'mailheader' : addnodes.literal_emphasis,
|
'mailheader' : addnodes.literal_emphasis,
|
||||||
'makevar' : nodes.strong,
|
|
||||||
'manpage' : addnodes.literal_emphasis,
|
'manpage' : addnodes.literal_emphasis,
|
||||||
'mimetype' : addnodes.literal_emphasis,
|
'mimetype' : addnodes.literal_emphasis,
|
||||||
'newsgroup' : addnodes.literal_emphasis,
|
'newsgroup' : addnodes.literal_emphasis,
|
||||||
'program' : nodes.strong, # XXX should be an x-ref
|
|
||||||
'regexp' : nodes.literal,
|
|
||||||
}
|
}
|
||||||
|
|
||||||
for rolename, nodeclass in generic_docroles.iteritems():
|
for rolename, nodeclass in generic_docroles.iteritems():
|
||||||
@ -40,6 +33,26 @@ for rolename, nodeclass in generic_docroles.iteritems():
|
|||||||
role = roles.CustomRole(rolename, generic, {'classes': [rolename]})
|
role = roles.CustomRole(rolename, generic, {'classes': [rolename]})
|
||||||
roles.register_local_role(rolename, role)
|
roles.register_local_role(rolename, role)
|
||||||
|
|
||||||
|
simple_docroles = [
|
||||||
|
'command',
|
||||||
|
'dfn',
|
||||||
|
'guilabel',
|
||||||
|
'kbd',
|
||||||
|
'makevar',
|
||||||
|
'program',
|
||||||
|
'regexp',
|
||||||
|
]
|
||||||
|
|
||||||
|
def simple_docrole(typ, rawtext, text, lineno, inliner, options={}, content=[]):
|
||||||
|
node = nodes.inline()
|
||||||
|
textnode = nodes.Text(text, rawtext)
|
||||||
|
node += textnode
|
||||||
|
node["classes"].append(typ)
|
||||||
|
return [node], []
|
||||||
|
|
||||||
|
for rolename in simple_docroles:
|
||||||
|
roles.register_local_role(rolename, simple_docrole)
|
||||||
|
|
||||||
|
|
||||||
# -- generic cross-reference role ----------------------------------------------
|
# -- generic cross-reference role ----------------------------------------------
|
||||||
|
|
||||||
|
@ -368,6 +368,28 @@ dl.glossary dt {
|
|||||||
margin-left: 1.5em;
|
margin-left: 1.5em;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
.command,
|
||||||
|
.guilabel,
|
||||||
|
.makevar,
|
||||||
|
.program
|
||||||
|
{
|
||||||
|
font-weight: bold;
|
||||||
|
}
|
||||||
|
|
||||||
|
.kbd,
|
||||||
|
.regexp
|
||||||
|
{
|
||||||
|
font-family: monospace;
|
||||||
|
white-space: pre-wrap;
|
||||||
|
background-color: #ecf0f3;
|
||||||
|
padding: 0 1px 0 1px;
|
||||||
|
font-size: 0.95em;
|
||||||
|
}
|
||||||
|
|
||||||
|
.dfn {
|
||||||
|
font-style: italic;
|
||||||
|
}
|
||||||
|
|
||||||
/* -- code displays --------------------------------------------------------- */
|
/* -- code displays --------------------------------------------------------- */
|
||||||
|
|
||||||
pre {
|
pre {
|
||||||
|
Loading…
Reference in New Issue
Block a user