Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/sphinx-doc/sphinx.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJakob Lykke Andersen <Jakob@caput.dk>2021-03-20 18:25:09 +0300
committerJakob Lykke Andersen <Jakob@caput.dk>2021-04-12 20:05:58 +0300
commitd131ec7acbc2026c0cc05c58fa39f3d845f3e6ba (patch)
tree247ab71fb8a0edc7d163b57fa5baa161d5410483 /sphinx/writers
parent3c9a74cb0b9e5ca90adfb1ee55b2262717fae223 (diff)
Decl styling, move desc dynamic classes to domain base class
Diffstat (limited to 'sphinx/writers')
-rw-r--r--sphinx/writers/html.py24
-rw-r--r--sphinx/writers/html5.py14
2 files changed, 26 insertions, 12 deletions
diff --git a/sphinx/writers/html.py b/sphinx/writers/html.py
index a92927cab..73e762c42 100644
--- a/sphinx/writers/html.py
+++ b/sphinx/writers/html.py
@@ -107,8 +107,15 @@ class HTMLTranslator(SphinxTranslator, BaseTranslator):
def depart_start_of_file(self, node: Element) -> None:
self.docnames.pop()
+ #############################################################
+ # Domain-specific object descriptions
+ #############################################################
+
+ # Top-level nodes for descriptions
+ ##################################
+
def visit_desc(self, node: Element) -> None:
- self.body.append(self.starttag(node, 'dl', CLASS=node['objtype']))
+ self.body.append(self.starttag(node, 'dl'))
def depart_desc(self, node: Element) -> None:
self.body.append('</dl>\n\n')
@@ -133,6 +140,15 @@ class HTMLTranslator(SphinxTranslator, BaseTranslator):
self.add_permalink_ref(node.parent, _('Permalink to this definition'))
self.body.append('<br />')
+ def visit_desc_content(self, node: Element) -> None:
+ self.body.append(self.starttag(node, 'dd', ''))
+
+ def depart_desc_content(self, node: Element) -> None:
+ self.body.append('</dd>')
+
+ # Nodes for high-level structure in signatures
+ ##############################################
+
def visit_desc_addname(self, node: Element) -> None:
self.body.append(self.starttag(node, 'code', '', CLASS='descclassname'))
@@ -205,11 +221,7 @@ class HTMLTranslator(SphinxTranslator, BaseTranslator):
def depart_desc_annotation(self, node: Element) -> None:
self.body.append('</em>')
- def visit_desc_content(self, node: Element) -> None:
- self.body.append(self.starttag(node, 'dd', ''))
-
- def depart_desc_content(self, node: Element) -> None:
- self.body.append('</dd>')
+ ##############################################
def visit_versionmodified(self, node: Element) -> None:
self.body.append(self.starttag(node, 'div', CLASS=node['type']))
diff --git a/sphinx/writers/html5.py b/sphinx/writers/html5.py
index 745e76b38..c3c082967 100644
--- a/sphinx/writers/html5.py
+++ b/sphinx/writers/html5.py
@@ -86,7 +86,7 @@ class HTML5Translator(SphinxTranslator, BaseTranslator):
##################################
def visit_desc(self, node: Element) -> None:
- self.body.append(self.starttag(node, 'dl', CLASS=node['objtype']))
+ self.body.append(self.starttag(node, 'dl'))
def depart_desc(self, node: Element) -> None:
self.body.append('</dl>\n\n')
@@ -111,6 +111,12 @@ class HTML5Translator(SphinxTranslator, BaseTranslator):
self.add_permalink_ref(node.parent, _('Permalink to this definition'))
self.body.append('<br />')
+ def visit_desc_content(self, node: Element) -> None:
+ self.body.append(self.starttag(node, 'dd', ''))
+
+ def depart_desc_content(self, node: Element) -> None:
+ self.body.append('</dd>')
+
# Nodes for high-level structure in signatures
##############################################
@@ -186,11 +192,7 @@ class HTML5Translator(SphinxTranslator, BaseTranslator):
def depart_desc_annotation(self, node: Element) -> None:
self.body.append('</em>')
- def visit_desc_content(self, node: Element) -> None:
- self.body.append(self.starttag(node, 'dd', ''))
-
- def depart_desc_content(self, node: Element) -> None:
- self.body.append('</dd>')
+ ##############################################
def visit_versionmodified(self, node: Element) -> None:
self.body.append(self.starttag(node, 'div', CLASS=node['type']))