mir/bind
2
0
Fork 0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-31 14:35:26 +00:00
Code Issues Releases Wiki Activity

Accept rst syntax in .. statement:: short: text

Browse Source 
Nested rst syntax is now parsed and rendered. E.g.:

.. namedconf:statement:: example
   :short: Use ``this`` **cool** syntax!
This commit is contained in:
Petr Špaček
2022-06-27 17:03:47 +02:00
parent 0e7ca5b5e0
commit 563eb8e1b9
1 changed files with 9 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
doc/arm/_ext/iscconf.py
View File

@@ -114,10 +114,18 @@ def domain_factory(domainname, domainlabel, todolist):
def isc_short(self):
return self.options.get("short", "")
def parse_nested_str(self, instr):
"""Parse string as nested rst syntax and produce a node"""
raw = nodes.paragraph(text=instr)
parsed = nodes.paragraph()
self.state.nested_parse(raw, self.content_offset, parsed)
return parsed
def transform_content(self, contentnode: addnodes.desc_content) -> None:
"""autogenerate content from structured data"""
if self.isc_short:
contentnode.insert(0, nodes.paragraph(text=self.isc_short))
short_parsed = self.parse_nested_str(self.isc_short)
contentnode.insert(0, short_parsed)
if self.isc_tags:
tags = nodes.paragraph()
tags += nodes.strong(text="Tags: ")