Make definition lists handle multiple definitions

Author: has2k1

quartodoc/pandoc/blocks.py

@@ -60,7 +60,10 @@ def html(self):
 # TypeAlias declared here to avoid forward-references which
 # break beartype
 BlockContent: TypeAlias = InlineContent | Block | Sequence[Block]
-DefinitionItem: TypeAlias = tuple[InlineContent, BlockContent]
+ContentItem: TypeAlias = str | Inline | Block
+DefinitionItem: TypeAlias = tuple[
+    InlineContent, ContentItem | Sequence[BlockContent]
+]
 
 
 @dataclass
@@ -97,12 +100,16 @@ def __str__(self):
         return Div_TPL.format(content=content, attr=attr)
 
 
-# Description starts on the 4th column, and subsequent lines will be
+# Definition starts on the 4th column, and subsequent lines will be
 # indented with 4 spaces. This is crucial for proper handling of
-# descriptions with more than one block.
+# definition with more than one block.
 DefinitionItem_TPL = """\
 {term}
-:   {description}
+{definitions}
+"""
+
+Definition_TPL = """
+:   {definition}
 """
 
 
@@ -121,18 +128,26 @@ def __str__(self):
         if not self.content:
             return ""
 
-        lst = []
-        fmt = DefinitionItem_TPL.format
-        for term, description in self.content:
-            term = inlinecontent_to_str(term)
-            description = blockcontent_to_str(description)
+        tfmt = DefinitionItem_TPL.format
+        dfmt = Definition_TPL.format
+        items = []
+        for term, definitions in self.content:
+            term, defs = inlinecontent_to_str(term), []
+
+            # Single Definition
+            if isinstance(definitions, (str, Inline, Block)):
+                definitions = [definitions]
+
+            # Multiple defnitions
+            for definition in definitions:
+                s = blockcontent_to_str(definition)
+                # strip away the indentation on the first line as it
+                # is handled by the template
+                defs.append(dfmt(definition=indent(s, INDENT).strip()))
 
-            # strip away the indentation on the first line as it
-            # is handled by the template
-            desc = indent(str(description).strip(), INDENT).strip()
-            lst.append(fmt(term=term, description=desc))
+            items.append(tfmt(term=term, definitions="".join(defs)))
 
-        return join_block_content(lst)
+        return join_block_content(items)
 
 
 @dataclass