epub-generator 0.1.3__tar.gz → 0.1.5__tar.gz

{epub_generator-0.1.3 → epub_generator-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: epub-generator
-Version: 0.1.3
+Version: 0.1.5
 Summary: A simple Python EPUB 3.0 generator with a single API call
 License: MIT
 Keywords: epub,epub3,ebook,generator,publishing
@@ -61,9 +61,9 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    TextBlock(kind=TextKind.BODY, content=["This is the first paragraph."]),
-                    TextBlock(kind=TextKind.BODY, content=["This is the second paragraph."]),
+                    TextBlock(kind=TextKind.HEADLINE, level=0, content=["Chapter 1"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["This is the first paragraph."]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["This is the second paragraph."]),
                 ]
             ),
         ),
@@ -111,8 +111,8 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, level=0, content=["Chapter 1"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Main content..."]),
                 ]
             ),
         ),
@@ -136,7 +136,7 @@ epub_data = EpubData(
                     title="Chapter 1.1",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            TextBlock(kind=TextKind.BODY, content=["Content 1.1..."]),
+                            TextBlock(kind=TextKind.BODY, level=0, content=["Content 1.1..."]),
                         ]
                     ),
                 ),
@@ -144,7 +144,7 @@ epub_data = EpubData(
                     title="Chapter 1.2",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            TextBlock(kind=TextKind.BODY, content=["Content 1.2..."]),
+                            TextBlock(kind=TextKind.BODY, level=0, content=["Content 1.2..."]),
                         ]
                     ),
                 ),
@@ -168,7 +168,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Here's an image:"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Here's an image:"]),
                     Image(
                         path=Path("image.png"),  # Image path
                         alt_text="Image description",
@@ -195,6 +195,7 @@ epub_data = EpubData(
                 elements=[
                     TextBlock(
                         kind=TextKind.BODY,
+                        level=0,
                         content=[
                             "This is text with a footnote",
                             Mark(id=1),  # Footnote marker
@@ -206,7 +207,7 @@ epub_data = EpubData(
                     Footnote(
                         id=1,
                         contents=[
-                            TextBlock(kind=TextKind.BODY, content=["This is the footnote content."]),
+                            TextBlock(kind=TextKind.BODY, level=0, content=["This is the footnote content."]),
                         ],
                     ),
                 ],
@@ -229,7 +230,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Here's a table:"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Here's a table:"]),
                     Table(
                         html_content="""
                         <table>
@@ -261,7 +262,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Pythagorean theorem:"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Pythagorean theorem:"]),
                     Formula(latex_expression="x^2 + y^2 = z^2"),  # Block-level formula
                 ]
             ),
@@ -284,6 +285,7 @@ epub_data = EpubData(
                 elements=[
                     TextBlock(
                         kind=TextKind.BODY,
+                        level=0,
                         content=[
                             "The Pythagorean theorem ",
                             Formula(latex_expression="a^2 + b^2 = c^2"),  # Inline formula
@@ -314,6 +316,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(elements=[TextBlock(
                 kind=TextKind.BODY,
+                level=0,
                 content=[
                     "This is normal text with ",
                     HTMLTag(
@@ -348,8 +351,8 @@ epub_data = EpubData(
             title="Preface",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.HEADLINE, content=["Preface"]),
-                    TextBlock(kind=TextKind.BODY, content=["This is the preface content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, level=0, content=["Preface"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["This is the preface content..."]),
                 ]
             ),
         ),
@@ -359,7 +362,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Main content..."]),
                 ]
             ),
         ),
@@ -457,6 +460,7 @@ class Chapter:
   @dataclass
   class TextBlock:
       kind: TextKind                                # BODY | HEADLINE | QUOTE
+      level: int                                    # Heading level (0→h1, 1→h2, max h6; only for HEADLINE)
       content: list[str | Mark | Formula | HTMLTag] # Text with optional marks, inline formulas, and HTML tags
   ```
 

{epub_generator-0.1.3 → epub_generator-0.1.5}/README.md

@@ -34,9 +34,9 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    TextBlock(kind=TextKind.BODY, content=["This is the first paragraph."]),
-                    TextBlock(kind=TextKind.BODY, content=["This is the second paragraph."]),
+                    TextBlock(kind=TextKind.HEADLINE, level=0, content=["Chapter 1"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["This is the first paragraph."]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["This is the second paragraph."]),
                 ]
             ),
         ),
@@ -84,8 +84,8 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, level=0, content=["Chapter 1"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Main content..."]),
                 ]
             ),
         ),
@@ -109,7 +109,7 @@ epub_data = EpubData(
                     title="Chapter 1.1",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            TextBlock(kind=TextKind.BODY, content=["Content 1.1..."]),
+                            TextBlock(kind=TextKind.BODY, level=0, content=["Content 1.1..."]),
                         ]
                     ),
                 ),
@@ -117,7 +117,7 @@ epub_data = EpubData(
                     title="Chapter 1.2",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            TextBlock(kind=TextKind.BODY, content=["Content 1.2..."]),
+                            TextBlock(kind=TextKind.BODY, level=0, content=["Content 1.2..."]),
                         ]
                     ),
                 ),
@@ -141,7 +141,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Here's an image:"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Here's an image:"]),
                     Image(
                         path=Path("image.png"),  # Image path
                         alt_text="Image description",
@@ -168,6 +168,7 @@ epub_data = EpubData(
                 elements=[
                     TextBlock(
                         kind=TextKind.BODY,
+                        level=0,
                         content=[
                             "This is text with a footnote",
                             Mark(id=1),  # Footnote marker
@@ -179,7 +180,7 @@ epub_data = EpubData(
                     Footnote(
                         id=1,
                         contents=[
-                            TextBlock(kind=TextKind.BODY, content=["This is the footnote content."]),
+                            TextBlock(kind=TextKind.BODY, level=0, content=["This is the footnote content."]),
                         ],
                     ),
                 ],
@@ -202,7 +203,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Here's a table:"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Here's a table:"]),
                     Table(
                         html_content="""
                         <table>
@@ -234,7 +235,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Pythagorean theorem:"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Pythagorean theorem:"]),
                     Formula(latex_expression="x^2 + y^2 = z^2"),  # Block-level formula
                 ]
             ),
@@ -257,6 +258,7 @@ epub_data = EpubData(
                 elements=[
                     TextBlock(
                         kind=TextKind.BODY,
+                        level=0,
                         content=[
                             "The Pythagorean theorem ",
                             Formula(latex_expression="a^2 + b^2 = c^2"),  # Inline formula
@@ -287,6 +289,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(elements=[TextBlock(
                 kind=TextKind.BODY,
+                level=0,
                 content=[
                     "This is normal text with ",
                     HTMLTag(
@@ -321,8 +324,8 @@ epub_data = EpubData(
             title="Preface",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.HEADLINE, content=["Preface"]),
-                    TextBlock(kind=TextKind.BODY, content=["This is the preface content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, level=0, content=["Preface"]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["This is the preface content..."]),
                 ]
             ),
         ),
@@ -332,7 +335,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.BODY, level=0, content=["Main content..."]),
                 ]
             ),
         ),
@@ -430,6 +433,7 @@ class Chapter:
   @dataclass
   class TextBlock:
       kind: TextKind                                # BODY | HEADLINE | QUOTE
+      level: int                                    # Heading level (0→h1, 1→h2, max h6; only for HEADLINE)
       content: list[str | Mark | Formula | HTMLTag] # Text with optional marks, inline formulas, and HTML tags
   ```
 

{epub_generator-0.1.3 → epub_generator-0.1.5}/epub_generator/__init__.py

@@ -1,6 +1,7 @@
 from .generation import generate_epub
 from .options import LaTeXRender, TableRender
 from .types import (
+    BasicAsset,
     BookMeta,
     Chapter,
     ChapterGetter,
@@ -35,6 +36,7 @@ __all__ = [
     "Table",
     "Formula",
     "HTMLTag",
+    "BasicAsset",
     "Image",
     "Footnote",
     "Mark",

{epub_generator-0.1.3 → epub_generator-0.1.5}/epub_generator/context.py

@@ -55,15 +55,14 @@ class Context:
         nodes = list(self._hash_to_node.values())
         nodes.sort(key=lambda node: node.file_name)
         return [(node.file_name, node.media_type) for node in nodes]
+    
+    @property
+    def chapters_with_mathml(self) -> set[str]:
+        return self._chapters_with_mathml
 
     def mark_chapter_has_mathml(self, chapter_file_name: str) -> None:
-        """Mark a chapter as containing MathML content for EPUB 3.0 manifest properties."""
         self._chapters_with_mathml.add(chapter_file_name)
 
-    def chapter_has_mathml(self, chapter_file_name: str) -> bool:
-        """Check if a chapter contains MathML content."""
-        return chapter_file_name in self._chapters_with_mathml
-
     def use_asset(
         self,
         source_path: Path,

{epub_generator-0.1.3 → epub_generator-0.1.5}/epub_generator/data/nav.xhtml.jinja

@@ -20,7 +20,7 @@
         <a href="Text/head.xhtml">{{ head_chapter_title }}</a>
       </li>
 {% endif %}
-{{ toc_list|safe }}
+{{ toc_body|safe }}
     </ol>
   </nav>
 

{epub_generator-0.1.3 → epub_generator-0.1.5}/epub_generator/data/style.css.jinja

@@ -65,4 +65,26 @@ span.formula-inline img {
   vertical-align: middle;
   margin: 0 0.2em;
   max-height: 1.2em;
+}
+
+div.asset {
+  page-break-inside: avoid;
+  margin: 1em 0;
+}
+
+div.asset-title {
+  text-align: center;
+  font-weight: 600;
+  font-size: 0.95em;
+  color: #333;
+  margin-bottom: 0.5em;
+  font-style: italic;
+}
+
+div.asset-caption {
+  text-align: center;
+  font-size: 0.9em;
+  color: #666;
+  margin-top: 0.5em;
+  font-style: italic;
 }

{epub_generator-0.1.3 → epub_generator-0.1.5}/epub_generator/generation/gen_asset.py

@@ -8,7 +8,8 @@ from latex2mathml.converter import convert
 
 from ..context import Context
 from ..options import LaTeXRender, TableRender
-from ..types import Formula, Image, Table
+from ..types import BasicAsset, Formula, Image, Table
+from .gen_content import render_html_tag, render_inline_content
 
 _MEDIA_TYPE_MAP = {
     ".png": "image/png",
@@ -18,25 +19,40 @@ _MEDIA_TYPE_MAP = {
     ".svg": "image/svg+xml",
 }
 
-def process_table(context: Context, table: Table) -> Element | None:
-    if context.table_render == TableRender.CLIPPING:
-        return None
-    try:
-        wrapped_html = f"<div>{table.html_content}</div>"
-        parsed = fromstring(wrapped_html)
-        wrapper = Element("div", attrib={"class": "alt-wrapper"})
 
-        for child in parsed:
-            wrapper.append(child)
+def render_inline_formula(context: Context, formula: Formula) -> Element | None:
+    return _render_formula(
+        context=context, 
+        formula=formula, 
+        inline_mode=True,
+    )
 
-        return wrapper if len(wrapper) > 0 else None
-    except Exception:
+
+def render_asset_block(context: Context, block: Table | Formula | Image) -> Element | None: 
+    element: Element | None = None
+    if isinstance(block, Table):
+        element = _render_table(context, block)
+    elif isinstance(block, Formula):
+        element = _render_formula(context, block, inline_mode=False)
+    elif isinstance(block, Image):
+        element = _process_image(context, block)
+    return element
+
+
+def _render_table(context: Context, table: Table) -> Element | None:
+    if context.table_render == TableRender.CLIPPING:
         return None
 
+    return _wrap_asset_content(
+        context=context, 
+        asset=table, 
+        content_element=render_html_tag(context, table.html_content),
+    )
+
 
-def process_formula(
-        context: Context, 
-        formula: Formula, 
+def _render_formula(
+        context: Context,
+        formula: Formula,
         inline_mode: bool,
     ) -> Element | None:
 
@@ -47,9 +63,10 @@ def process_formula(
     if not latex_expr:
         return None
 
+    content_element = None
     if context.latex_render == LaTeXRender.MATHML:
-        return _latex2mathml(
-            latex=latex_expr, 
+        content_element = _latex2mathml(
+            latex=latex_expr,
             inline_mode=inline_mode,
         )
     elif context.latex_render == LaTeXRender.SVG:
@@ -64,31 +81,40 @@ def process_formula(
         img_element = Element("img")
         img_element.set("src", f"../assets/{file_name}")
         img_element.set("alt", "formula")
+        content_element = img_element
 
-        if inline_mode:
-            wrapper = Element("span", attrib={"class": "formula-inline"})
-        else:
-            wrapper = Element("div", attrib={"class": "alt-wrapper"})
+    if content_element is None:
+        return None
 
-        wrapper.append(img_element)
-        return wrapper
+    return _wrap_asset_content(
+        context=context,
+        asset=formula, 
+        content_element=content_element,
+        inline_mode=inline_mode,
+    )
 
-    return None
 
-def process_image(context: Context, image: Image) -> Element | None:
+def _process_image(context: Context, image: Image) -> Element:
     file_ext = image.path.suffix or ".png"
     file_name = context.use_asset(
-        source_path=image.path, 
-        media_type=_MEDIA_TYPE_MAP.get(file_ext.lower(), "image/png"), 
+        source_path=image.path,
+        media_type=_MEDIA_TYPE_MAP.get(file_ext.lower(), "image/png"),
         file_ext=file_ext,
     )
     img_element = Element("img")
     img_element.set("src", f"../assets/{file_name}")
-    img_element.set("alt", image.alt_text)
+    img_element.set("alt", "")  # Empty alt text, use caption instead
 
-    wrapper = Element("div", attrib={"class": "alt-wrapper"})
-    wrapper.append(img_element)
-    return wrapper
+    return _wrap_asset_content(
+        context=context, 
+        asset=image, 
+        content_element=img_element,
+    )
+
+def _normalize_expression(expression: str) -> str:
+    expression = expression.replace("\n", "")
+    expression = expression.strip()
+    return expression
 
 
 _ESCAPE_UNICODE_PATTERN = re.compile(r"&#x([0-9A-Fa-f]{5});")
@@ -148,9 +174,35 @@ def _latex_formula2svg(latex: str, font_size: int = 12):
         return output.getvalue()
     except Exception:
         return None
+    
+
+def _wrap_asset_content(
+    context: Context,
+    asset: BasicAsset,
+    content_element: Element,
+    inline_mode: bool = False,
+) -> Element:
+    
+    if inline_mode:
+        wrapper = Element("span", attrib={"class": "formula-inline"})
+    else:
+        wrapper = Element("div", attrib={"class": "alt-wrapper"})
 
+    wrapper.append(content_element)
 
-def _normalize_expression(expression: str) -> str:
-    expression = expression.replace("\n", "")
-    expression = expression.strip()
-    return expression
+    if not asset.title and not asset.caption:
+        return wrapper
+
+    container = Element("div", attrib={"class": "asset"})
+    if asset.title:
+        title_div = Element("div", attrib={"class": "asset-title"})
+        render_inline_content(context, title_div, asset.title)
+        container.append(title_div)
+
+    container.append(wrapper)
+    if asset.caption:
+        caption_div = Element("div", attrib={"class": "asset-caption"})
+        render_inline_content(context, caption_div, asset.caption)
+        container.append(caption_div)
+
+    return container

{epub_generator-0.1.3 → epub_generator-0.1.5}/epub_generator/generation/gen_chapter.py

@@ -7,16 +7,17 @@ from ..types import (
     Chapter,
     ContentBlock,
     Formula,
-    HTMLTag,
     Image,
-    Mark,
     Table,
     TextBlock,
     TextKind,
 )
-from .gen_asset import process_formula, process_image, process_table
+from .gen_asset import render_asset_block
+from .gen_content import render_inline_content
 from .xml_utils import serialize_element, set_epub_type
 
+_MAX_HEADING_LEVEL = 6 # HTML standard defines heading levels from h1 to h6
+
 
 def generate_chapter(
     context: Context,
@@ -89,9 +90,13 @@ def _render_footnotes(
 
 
 def _render_content_block(context: Context, block: ContentBlock) -> Element | None:
-    if isinstance(block, TextBlock):
+    if isinstance(block, Table | Formula | Image):
+        return render_asset_block(context, block)
+
+    elif isinstance(block, TextBlock):
         if block.kind == TextKind.HEADLINE:
-            container = Element("h1")
+            heading_level = min(block.level + 1, _MAX_HEADING_LEVEL)
+            container = Element(f"h{heading_level}")
         elif block.kind == TextKind.QUOTE:
             container = Element("p")
         elif block.kind == TextKind.BODY:
@@ -99,9 +104,9 @@ def _render_content_block(context: Context, block: ContentBlock) -> Element | No
         else:
             raise ValueError(f"Unknown TextKind: {block.kind}")
 
-        _render_text_content(
-            context=context, 
-            parent=container, 
+        render_inline_content(
+            context=context,
+            parent=container,
             content=block.content,
         )
         if block.kind == TextKind.QUOTE:
@@ -110,68 +115,6 @@ def _render_content_block(context: Context, block: ContentBlock) -> Element | No
             return blockquote
 
         return container
-
-    elif isinstance(block, Table):
-        return process_table(context, block)
-
-    elif isinstance(block, Formula):
-        return process_formula(context, block, inline_mode=False)
-
-    elif isinstance(block, Image):
-        return process_image(context, block)
-
+    
     else:
         return None
-
-
-def _render_text_content(context: Context, parent: Element, content: list[str | Mark | Formula | HTMLTag]) -> None:
-    """Render text content with inline citation marks."""
-    current_element = parent
-    for item in content:
-        if isinstance(item, str):
-            if current_element is parent:
-                if parent.text is None:
-                    parent.text = item
-                else:
-                    parent.text += item
-            else:
-                if current_element.tail is None:
-                    current_element.tail = item
-                else:
-                    current_element.tail += item
-
-        elif isinstance(item, HTMLTag):
-            tag_element = Element(item.name)
-            for attr, value in item.attributes:
-                tag_element.set(attr, value)
-            _render_text_content(
-                context=context,
-                parent=tag_element,
-                content=item.content,
-            )
-            parent.append(tag_element)
-            current_element = tag_element
-
-        elif isinstance(item, Formula):
-            formula_element = process_formula(
-                context=context,
-                formula=item,
-                inline_mode=True,
-            )
-            if formula_element is not None:
-                parent.append(formula_element)
-                current_element = formula_element
-
-        elif isinstance(item, Mark):
-            # EPUB 3.0 noteref with semantic attributes
-            anchor = Element("a")
-            anchor.attrib = {
-                "id": f"ref-{item.id}",
-                "href": f"#fn-{item.id}",
-                "class": "super",
-            }
-            # Set epub:type using utility function (avoids global namespace pollution)
-            set_epub_type(anchor, "noteref")
-            anchor.text = f"[{item.id}]"
-            parent.append(anchor)
-            current_element = anchor

epub_generator-0.1.5/epub_generator/generation/gen_content.py

@@ -0,0 +1,59 @@
+from xml.etree.ElementTree import Element
+
+from ..context import Context
+from ..types import Formula, HTMLTag, Mark
+from .xml_utils import set_epub_type
+
+
+def render_inline_content(
+    context: Context,
+    parent: Element,
+    content: list[str | Mark | Formula | HTMLTag]
+) -> None:
+    current_element = parent
+    for item in content:
+        if isinstance(item, str):
+            if current_element is parent:
+                if parent.text is None:
+                    parent.text = item
+                else:
+                    parent.text += item
+            else:
+                if current_element.tail is None:
+                    current_element.tail = item
+                else:
+                    current_element.tail += item
+
+        elif isinstance(item, HTMLTag):
+            tag_element = render_html_tag(context, item)
+            parent.append(tag_element)
+            current_element = tag_element
+
+        elif isinstance(item, Formula):
+            from .gen_asset import render_inline_formula  # avoid circular import
+            formula_element = render_inline_formula(context, item)
+            if formula_element is not None:
+                parent.append(formula_element)
+                current_element = formula_element
+
+        elif isinstance(item, Mark):
+            # EPUB 3.0 noteref with semantic attributes
+            anchor = Element("a")
+            anchor.attrib = {
+                "id": f"ref-{item.id}",
+                "href": f"#fn-{item.id}",
+                "class": "super",
+            }
+            set_epub_type(anchor, "noteref")
+            anchor.text = f"[{item.id}]"
+            parent.append(anchor)
+            current_element = anchor
+
+
+def render_html_tag(context: Context, tag: HTMLTag) -> Element:
+    """Convert HTMLTag to XML Element with full inline content support."""
+    element = Element(tag.name)
+    for attr, value in tag.attributes:
+        element.set(attr, value)
+    render_inline_content(context, element, tag.content)
+    return element