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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: epub-generator
-Version: 0.1.1
+Version: 0.1.3
 Summary: A simple Python EPUB 3.0 generator with a single API call
 License: MIT
 Keywords: epub,epub3,ebook,generator,publishing
@@ -48,7 +48,7 @@ pip install epub-generator
 ### Generate Your First Book in 5 Minutes
 
 ```python
-from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, TextBlock, TextKind
 
 # Prepare book data
 epub_data = EpubData(
@@ -61,9 +61,9 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    Text(kind=TextKind.BODY, content=["This is the first paragraph."]),
-                    Text(kind=TextKind.BODY, content=["This is the second paragraph."]),
+                    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."]),
                 ]
             ),
         ),
@@ -80,9 +80,9 @@ That's it! You now have a valid EPUB 3.0 ebook file.
 
 - **Minimal API**: Just one function call `generate_epub()`
 - **EPUB 3.0**: Generates standards-compliant EPUB 3.0 format
-- **Rich Content**: Supports text, images, tables, math formulas, footnotes
+- **Rich Content**: Supports text, images, tables, math formulas (block-level and inline), footnotes, custom HTML tags
 - **Flexible Structure**: Nested chapters, prefaces, cover images
-- **Math Support**: LaTeX to MathML conversion
+- **Math Support**: LaTeX to MathML/SVG conversion with inline formula support
 - **Type Safe**: Full type annotations included
 
 ## Advanced Usage
@@ -92,7 +92,7 @@ That's it! You now have a valid EPUB 3.0 ebook file.
 ```python
 from datetime import datetime, timezone
 from pathlib import Path
-from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, TextBlock, TextKind
 
 epub_data = EpubData(
     meta=BookMeta(
@@ -111,8 +111,8 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    Text(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, content=["Chapter 1"]),
+                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
                 ]
             ),
         ),
@@ -125,7 +125,7 @@ generate_epub(epub_data, "book_with_cover.epub")
 ### Nested Chapter Structure
 
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind
 
 epub_data = EpubData(
     chapters=[
@@ -136,7 +136,7 @@ epub_data = EpubData(
                     title="Chapter 1.1",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            Text(kind=TextKind.BODY, content=["Content 1.1..."]),
+                            TextBlock(kind=TextKind.BODY, content=["Content 1.1..."]),
                         ]
                     ),
                 ),
@@ -144,7 +144,7 @@ epub_data = EpubData(
                     title="Chapter 1.2",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            Text(kind=TextKind.BODY, content=["Content 1.2..."]),
+                            TextBlock(kind=TextKind.BODY, content=["Content 1.2..."]),
                         ]
                     ),
                 ),
@@ -160,7 +160,7 @@ generate_epub(epub_data, "book_with_nested_chapters.epub")
 
 ```python
 from pathlib import Path
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Image
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Image
 
 epub_data = EpubData(
     chapters=[
@@ -168,7 +168,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Here's an image:"]),
+                    TextBlock(kind=TextKind.BODY, content=["Here's an image:"]),
                     Image(
                         path=Path("image.png"),  # Image path
                         alt_text="Image description",
@@ -185,7 +185,7 @@ generate_epub(epub_data, "book_with_images.epub")
 ### Add Footnotes
 
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Mark, Footnote
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Mark, Footnote
 
 epub_data = EpubData(
     chapters=[
@@ -193,7 +193,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(
+                    TextBlock(
                         kind=TextKind.BODY,
                         content=[
                             "This is text with a footnote",
@@ -206,7 +206,7 @@ epub_data = EpubData(
                     Footnote(
                         id=1,
                         contents=[
-                            Text(kind=TextKind.BODY, content=["This is the footnote content."]),
+                            TextBlock(kind=TextKind.BODY, content=["This is the footnote content."]),
                         ],
                     ),
                 ],
@@ -221,7 +221,7 @@ generate_epub(epub_data, "book_with_footnotes.epub")
 ### Add Tables
 
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Table
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Table
 
 epub_data = EpubData(
     chapters=[
@@ -229,7 +229,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Here's a table:"]),
+                    TextBlock(kind=TextKind.BODY, content=["Here's a table:"]),
                     Table(
                         html_content="""
                         <table>
@@ -250,8 +250,10 @@ generate_epub(epub_data, "book_with_tables.epub")
 
 ### Add Math Formulas
 
+Block-level formulas:
+
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Formula, LaTeXRender
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Formula, LaTeXRender
 
 epub_data = EpubData(
     chapters=[
@@ -259,8 +261,8 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Pythagorean theorem:"]),
-                    Formula(latex_expression="x^2 + y^2 = z^2"),  # LaTeX expression
+                    TextBlock(kind=TextKind.BODY, content=["Pythagorean theorem:"]),
+                    Formula(latex_expression="x^2 + y^2 = z^2"),  # Block-level formula
                 ]
             ),
         ),
@@ -271,10 +273,73 @@ epub_data = EpubData(
 generate_epub(epub_data, "book_with_math.epub", latex_render=LaTeXRender.MATHML)
 ```
 
+Inline formulas embedded in text:
+
+```python
+epub_data = EpubData(
+    chapters=[
+        TocItem(
+            title="Chapter 1",
+            get_chapter=lambda: Chapter(
+                elements=[
+                    TextBlock(
+                        kind=TextKind.BODY,
+                        content=[
+                            "The Pythagorean theorem ",
+                            Formula(latex_expression="a^2 + b^2 = c^2"),  # Inline formula
+                            " is fundamental. Einstein's equation ",
+                            Formula(latex_expression="E = mc^2"),
+                            " shows mass-energy equivalence.",
+                        ],
+                    ),
+                ]
+            ),
+        ),
+    ],
+)
+
+generate_epub(epub_data, "book_with_inline_math.epub", latex_render=LaTeXRender.MATHML)
+```
+
+### Add Custom HTML Tags
+
+You can embed custom HTML tags within text content:
+
+```python
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, HTMLTag
+
+epub_data = EpubData(
+    chapters=[
+        TocItem(
+            title="Chapter 1",
+            get_chapter=lambda: Chapter(elements=[TextBlock(
+                kind=TextKind.BODY,
+                content=[
+                    "This is normal text with ",
+                    HTMLTag(
+                        name="span",
+                        attributes=[("class", "highlight"), ("style", "color: red;")],
+                        content=["highlighted content"],
+                    ),
+                    " and more text with ",
+                    HTMLTag(
+                        name="strong",
+                        content=["bold text"],
+                    ),
+                    ".",
+                ],
+            )]),
+        ),
+    ],
+)
+
+generate_epub(epub_data, "book_with_html_tags.epub")
+```
+
 ### Add Prefaces
 
 ```python
-from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, TextBlock, TextKind
 
 epub_data = EpubData(
     meta=BookMeta(title="Book with Prefaces"),
@@ -283,8 +348,8 @@ epub_data = EpubData(
             title="Preface",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.HEADLINE, content=["Preface"]),
-                    Text(kind=TextKind.BODY, content=["This is the preface content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, content=["Preface"]),
+                    TextBlock(kind=TextKind.BODY, content=["This is the preface content..."]),
                 ]
             ),
         ),
@@ -294,7 +359,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
                 ]
             ),
         ),
@@ -387,12 +452,12 @@ class Chapter:
 
 `ContentBlock` is a union of:
 
-- **`Text`**: Text paragraph
+- **`TextBlock`**: Text paragraph
   ```python
   @dataclass
-  class Text:
-      kind: TextKind                            # BODY | HEADLINE | QUOTE
-      content: list[str | Mark]                 # Text content with optional marks
+  class TextBlock:
+      kind: TextKind                                # BODY | HEADLINE | QUOTE
+      content: list[str | Mark | Formula | HTMLTag] # Text with optional marks, inline formulas, and HTML tags
   ```
 
 - **`Image`**: Image reference
@@ -417,6 +482,15 @@ class Chapter:
       latex_expression: str                     # LaTeX expression
   ```
 
+- **`HTMLTag`**: HTML tag
+  ```python
+  @dataclass
+  class HTMLTag:
+      name: str                                 # Tag name (e.g., "span", "div")
+      attributes: list[tuple[str, str]] = []    # List of (attribute, value) pairs
+      content: list[str | Mark | Formula | HTMLTag] = [] # Inner HTML content
+  ```
+
 #### `Footnote`
 
 Footnote/citation.

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

@@ -21,7 +21,7 @@ pip install epub-generator
 ### Generate Your First Book in 5 Minutes
 
 ```python
-from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, TextBlock, TextKind
 
 # Prepare book data
 epub_data = EpubData(
@@ -34,9 +34,9 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    Text(kind=TextKind.BODY, content=["This is the first paragraph."]),
-                    Text(kind=TextKind.BODY, content=["This is the second paragraph."]),
+                    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."]),
                 ]
             ),
         ),
@@ -53,9 +53,9 @@ That's it! You now have a valid EPUB 3.0 ebook file.
 
 - **Minimal API**: Just one function call `generate_epub()`
 - **EPUB 3.0**: Generates standards-compliant EPUB 3.0 format
-- **Rich Content**: Supports text, images, tables, math formulas, footnotes
+- **Rich Content**: Supports text, images, tables, math formulas (block-level and inline), footnotes, custom HTML tags
 - **Flexible Structure**: Nested chapters, prefaces, cover images
-- **Math Support**: LaTeX to MathML conversion
+- **Math Support**: LaTeX to MathML/SVG conversion with inline formula support
 - **Type Safe**: Full type annotations included
 
 ## Advanced Usage
@@ -65,7 +65,7 @@ That's it! You now have a valid EPUB 3.0 ebook file.
 ```python
 from datetime import datetime, timezone
 from pathlib import Path
-from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, TextBlock, TextKind
 
 epub_data = EpubData(
     meta=BookMeta(
@@ -84,8 +84,8 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.HEADLINE, content=["Chapter 1"]),
-                    Text(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, content=["Chapter 1"]),
+                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
                 ]
             ),
         ),
@@ -98,7 +98,7 @@ generate_epub(epub_data, "book_with_cover.epub")
 ### Nested Chapter Structure
 
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind
 
 epub_data = EpubData(
     chapters=[
@@ -109,7 +109,7 @@ epub_data = EpubData(
                     title="Chapter 1.1",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            Text(kind=TextKind.BODY, content=["Content 1.1..."]),
+                            TextBlock(kind=TextKind.BODY, content=["Content 1.1..."]),
                         ]
                     ),
                 ),
@@ -117,7 +117,7 @@ epub_data = EpubData(
                     title="Chapter 1.2",
                     get_chapter=lambda: Chapter(
                         elements=[
-                            Text(kind=TextKind.BODY, content=["Content 1.2..."]),
+                            TextBlock(kind=TextKind.BODY, content=["Content 1.2..."]),
                         ]
                     ),
                 ),
@@ -133,7 +133,7 @@ generate_epub(epub_data, "book_with_nested_chapters.epub")
 
 ```python
 from pathlib import Path
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Image
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Image
 
 epub_data = EpubData(
     chapters=[
@@ -141,7 +141,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Here's an image:"]),
+                    TextBlock(kind=TextKind.BODY, content=["Here's an image:"]),
                     Image(
                         path=Path("image.png"),  # Image path
                         alt_text="Image description",
@@ -158,7 +158,7 @@ generate_epub(epub_data, "book_with_images.epub")
 ### Add Footnotes
 
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Mark, Footnote
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Mark, Footnote
 
 epub_data = EpubData(
     chapters=[
@@ -166,7 +166,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(
+                    TextBlock(
                         kind=TextKind.BODY,
                         content=[
                             "This is text with a footnote",
@@ -179,7 +179,7 @@ epub_data = EpubData(
                     Footnote(
                         id=1,
                         contents=[
-                            Text(kind=TextKind.BODY, content=["This is the footnote content."]),
+                            TextBlock(kind=TextKind.BODY, content=["This is the footnote content."]),
                         ],
                     ),
                 ],
@@ -194,7 +194,7 @@ generate_epub(epub_data, "book_with_footnotes.epub")
 ### Add Tables
 
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Table
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Table
 
 epub_data = EpubData(
     chapters=[
@@ -202,7 +202,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Here's a table:"]),
+                    TextBlock(kind=TextKind.BODY, content=["Here's a table:"]),
                     Table(
                         html_content="""
                         <table>
@@ -223,8 +223,10 @@ generate_epub(epub_data, "book_with_tables.epub")
 
 ### Add Math Formulas
 
+Block-level formulas:
+
 ```python
-from epub_generator import generate_epub, EpubData, TocItem, Chapter, Text, TextKind, Formula, LaTeXRender
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, Formula, LaTeXRender
 
 epub_data = EpubData(
     chapters=[
@@ -232,8 +234,8 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Pythagorean theorem:"]),
-                    Formula(latex_expression="x^2 + y^2 = z^2"),  # LaTeX expression
+                    TextBlock(kind=TextKind.BODY, content=["Pythagorean theorem:"]),
+                    Formula(latex_expression="x^2 + y^2 = z^2"),  # Block-level formula
                 ]
             ),
         ),
@@ -244,10 +246,73 @@ epub_data = EpubData(
 generate_epub(epub_data, "book_with_math.epub", latex_render=LaTeXRender.MATHML)
 ```
 
+Inline formulas embedded in text:
+
+```python
+epub_data = EpubData(
+    chapters=[
+        TocItem(
+            title="Chapter 1",
+            get_chapter=lambda: Chapter(
+                elements=[
+                    TextBlock(
+                        kind=TextKind.BODY,
+                        content=[
+                            "The Pythagorean theorem ",
+                            Formula(latex_expression="a^2 + b^2 = c^2"),  # Inline formula
+                            " is fundamental. Einstein's equation ",
+                            Formula(latex_expression="E = mc^2"),
+                            " shows mass-energy equivalence.",
+                        ],
+                    ),
+                ]
+            ),
+        ),
+    ],
+)
+
+generate_epub(epub_data, "book_with_inline_math.epub", latex_render=LaTeXRender.MATHML)
+```
+
+### Add Custom HTML Tags
+
+You can embed custom HTML tags within text content:
+
+```python
+from epub_generator import generate_epub, EpubData, TocItem, Chapter, TextBlock, TextKind, HTMLTag
+
+epub_data = EpubData(
+    chapters=[
+        TocItem(
+            title="Chapter 1",
+            get_chapter=lambda: Chapter(elements=[TextBlock(
+                kind=TextKind.BODY,
+                content=[
+                    "This is normal text with ",
+                    HTMLTag(
+                        name="span",
+                        attributes=[("class", "highlight"), ("style", "color: red;")],
+                        content=["highlighted content"],
+                    ),
+                    " and more text with ",
+                    HTMLTag(
+                        name="strong",
+                        content=["bold text"],
+                    ),
+                    ".",
+                ],
+            )]),
+        ),
+    ],
+)
+
+generate_epub(epub_data, "book_with_html_tags.epub")
+```
+
 ### Add Prefaces
 
 ```python
-from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, Text, TextKind
+from epub_generator import generate_epub, EpubData, BookMeta, TocItem, Chapter, TextBlock, TextKind
 
 epub_data = EpubData(
     meta=BookMeta(title="Book with Prefaces"),
@@ -256,8 +321,8 @@ epub_data = EpubData(
             title="Preface",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.HEADLINE, content=["Preface"]),
-                    Text(kind=TextKind.BODY, content=["This is the preface content..."]),
+                    TextBlock(kind=TextKind.HEADLINE, content=["Preface"]),
+                    TextBlock(kind=TextKind.BODY, content=["This is the preface content..."]),
                 ]
             ),
         ),
@@ -267,7 +332,7 @@ epub_data = EpubData(
             title="Chapter 1",
             get_chapter=lambda: Chapter(
                 elements=[
-                    Text(kind=TextKind.BODY, content=["Main content..."]),
+                    TextBlock(kind=TextKind.BODY, content=["Main content..."]),
                 ]
             ),
         ),
@@ -360,12 +425,12 @@ class Chapter:
 
 `ContentBlock` is a union of:
 
-- **`Text`**: Text paragraph
+- **`TextBlock`**: Text paragraph
   ```python
   @dataclass
-  class Text:
-      kind: TextKind                            # BODY | HEADLINE | QUOTE
-      content: list[str | Mark]                 # Text content with optional marks
+  class TextBlock:
+      kind: TextKind                                # BODY | HEADLINE | QUOTE
+      content: list[str | Mark | Formula | HTMLTag] # Text with optional marks, inline formulas, and HTML tags
   ```
 
 - **`Image`**: Image reference
@@ -390,6 +455,15 @@ class Chapter:
       latex_expression: str                     # LaTeX expression
   ```
 
+- **`HTMLTag`**: HTML tag
+  ```python
+  @dataclass
+  class HTMLTag:
+      name: str                                 # Tag name (e.g., "span", "div")
+      attributes: list[tuple[str, str]] = []    # List of (attribute, value) pairs
+      content: list[str | Mark | Formula | HTMLTag] = [] # Inner HTML content
+  ```
+
 #### `Footnote`
 
 Footnote/citation.

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

@@ -8,10 +8,11 @@ from .types import (
     EpubData,
     Footnote,
     Formula,
+    HTMLTag,
     Image,
     Mark,
     Table,
-    Text,
+    TextBlock,
     TextKind,
     TocItem,
 )
@@ -29,10 +30,11 @@ __all__ = [
     "Chapter",
     "ChapterGetter",
     "ContentBlock",
-    "Text",
+    "TextBlock",
     "TextKind",
     "Table",
     "Formula",
+    "HTMLTag",
     "Image",
     "Footnote",
     "Mark",

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

@@ -53,4 +53,16 @@ div.alt-wrapper th,
 div.alt-wrapper th {
   background-color: #f6f8fa;
   font-weight: 600;
+}
+
+span.formula-inline {
+  display: inline;
+  vertical-align: middle;
+}
+
+span.formula-inline img {
+  display: inline-block;
+  vertical-align: middle;
+  margin: 0 0.2em;
+  max-height: 1.2em;
 }

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

@@ -34,7 +34,12 @@ def process_table(context: Context, table: Table) -> Element | None:
         return None
 
 
-def process_formula(context: Context, formula: Formula) -> Element | None:
+def process_formula(
+        context: Context, 
+        formula: Formula, 
+        inline_mode: bool,
+    ) -> Element | None:
+
     if context.latex_render == LaTeXRender.CLIPPING:
         return None
 
@@ -43,22 +48,28 @@ def process_formula(context: Context, formula: Formula) -> Element | None:
         return None
 
     if context.latex_render == LaTeXRender.MATHML:
-        return _latex2mathml(latex_expr)
-
+        return _latex2mathml(
+            latex=latex_expr, 
+            inline_mode=inline_mode,
+        )
     elif context.latex_render == LaTeXRender.SVG:
         svg_image = _latex_formula2svg(latex_expr)
         if svg_image is None:
             return None
         file_name = context.add_asset(
-            data=svg_image, 
-            media_type="image/svg+xml", 
+            data=svg_image,
+            media_type="image/svg+xml",
             file_ext=".svg",
         )
         img_element = Element("img")
         img_element.set("src", f"../assets/{file_name}")
         img_element.set("alt", "formula")
 
-        wrapper = Element("div", attrib={"class": "alt-wrapper"})
+        if inline_mode:
+            wrapper = Element("span", attrib={"class": "formula-inline"})
+        else:
+            wrapper = Element("div", attrib={"class": "alt-wrapper"})
+
         wrapper.append(img_element)
         return wrapper
 
@@ -83,9 +94,12 @@ def process_image(context: Context, image: Image) -> Element | None:
 _ESCAPE_UNICODE_PATTERN = re.compile(r"&#x([0-9A-Fa-f]{5});")
 
 
-def _latex2mathml(latex: str) -> None | Element:
+def _latex2mathml(latex: str, inline_mode: bool) -> None | Element:
     try:
-        html_latex = convert(latex)
+        html_latex = convert(
+            latex=latex,
+            display="inline" if inline_mode else "block",
+        )
     except Exception:
         return None
 

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

@@ -7,14 +7,15 @@ from ..types import (
     Chapter,
     ContentBlock,
     Formula,
+    HTMLTag,
     Image,
     Mark,
     Table,
-    Text,
+    TextBlock,
     TextKind,
 )
-from .xml_utils import serialize_element, set_epub_type
 from .gen_asset import process_formula, process_image, process_table
+from .xml_utils import serialize_element, set_epub_type
 
 
 def generate_chapter(
@@ -88,7 +89,7 @@ def _render_footnotes(
 
 
 def _render_content_block(context: Context, block: ContentBlock) -> Element | None:
-    if isinstance(block, Text):
+    if isinstance(block, TextBlock):
         if block.kind == TextKind.HEADLINE:
             container = Element("h1")
         elif block.kind == TextKind.QUOTE:
@@ -98,8 +99,11 @@ def _render_content_block(context: Context, block: ContentBlock) -> Element | No
         else:
             raise ValueError(f"Unknown TextKind: {block.kind}")
 
-        _render_text_content(container, block.content)
-
+        _render_text_content(
+            context=context, 
+            parent=container, 
+            content=block.content,
+        )
         if block.kind == TextKind.QUOTE:
             blockquote = Element("blockquote")
             blockquote.append(container)
@@ -111,7 +115,7 @@ def _render_content_block(context: Context, block: ContentBlock) -> Element | No
         return process_table(context, block)
 
     elif isinstance(block, Formula):
-        return process_formula(context, block)
+        return process_formula(context, block, inline_mode=False)
 
     elif isinstance(block, Image):
         return process_image(context, block)
@@ -120,7 +124,7 @@ def _render_content_block(context: Context, block: ContentBlock) -> Element | No
         return None
 
 
-def _render_text_content(parent: Element, content: list[str | Mark]) -> 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:
@@ -135,6 +139,29 @@ def _render_text_content(parent: Element, content: list[str | Mark]) -> 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")

{epub_generator-0.1.1 → epub_generator-0.1.3}/epub_generator/generation/gen_epub.py

@@ -6,9 +6,10 @@ from uuid import uuid4
 from zipfile import ZipFile
 
 from ..context import Context, Template
+from ..html_tag import search_content
 from ..i18n import I18N
 from ..options import LaTeXRender, TableRender
-from ..types import EpubData, Formula
+from ..types import Chapter, EpubData, Formula, TextBlock
 from .gen_chapter import generate_chapter
 from .gen_nav import gen_nav
 from .gen_toc import NavPoint, gen_toc
@@ -135,10 +136,23 @@ def _write_chapters_from_data(
             assert_not_aborted()
 
 
-def _chapter_has_formula(chapter) -> bool:
+def _chapter_has_formula(chapter: Chapter) -> bool:
+    """Check if chapter contains any formulas (block-level or inline)."""
     for element in chapter.elements:
         if isinstance(element, Formula):
             return True
+        if isinstance(element, TextBlock):
+            for item in search_content(element.content):
+                if isinstance(item, Formula):
+                    return True
+    for footnote in chapter.footnotes:
+        for content_block in footnote.contents:
+            if isinstance(content_block, Formula):
+                return True
+            if isinstance(content_block, TextBlock):
+                for item in search_content(content_block.content):
+                    if isinstance(item, Formula):
+                        return True
     return False
 
 def _write_basic_files(

epub_generator-0.1.3/epub_generator/generation/xml_utils.py

@@ -0,0 +1,31 @@
+import re
+from xml.etree.ElementTree import Element, tostring
+
+_EPUB_NS = "http://www.idpf.org/2007/ops"
+_MATHML_NS = "http://www.w3.org/1998/Math/MathML"
+
+
+def set_epub_type(element: Element, epub_type: str) -> None:
+    element.set(f"{{{_EPUB_NS}}}type", epub_type)
+
+def serialize_element(element: Element) -> str:
+    xml_string = tostring(element, encoding="unicode")
+    for prefix, namespace_uri, keep_xmlns in (
+        ("epub", _EPUB_NS, False),  # EPUB namespace: remove xmlns (declared at root)
+        ("m", _MATHML_NS, True),     # MathML namespace: keep xmlns with clean prefix
+    ):
+        xml_string = xml_string.replace(f"{{{namespace_uri}}}", f"{prefix}:")
+        pattern = r"xmlns:(ns\d+)=\"" + re.escape(namespace_uri) + r"\""
+        matches = re.findall(pattern, xml_string)
+
+        for ns_prefix in matches:
+            if keep_xmlns:
+                xml_string = xml_string.replace(
+                    f" xmlns:{ns_prefix}=\"{namespace_uri}\"",
+                    f" xmlns:{prefix}=\"{namespace_uri}\""
+                )
+            else:
+                xml_string = xml_string.replace(f" xmlns:{ns_prefix}=\"{namespace_uri}\"", "")
+            xml_string = xml_string.replace(f"{ns_prefix}:", f"{prefix}:")
+
+    return xml_string

epub_generator-0.1.3/epub_generator/html_tag.py

@@ -0,0 +1,11 @@
+from typing import Generator
+
+from .types import Formula, HTMLTag, Mark
+
+
+def search_content(content: list[str | Mark | Formula | HTMLTag]) -> Generator[str | Mark | Formula, None, None]:
+    for child in content:
+        if isinstance(child, HTMLTag):
+            yield from search_content(child.content)
+        else:
+            yield child

{epub_generator-0.1.1 → epub_generator-0.1.3}/epub_generator/types.py

@@ -83,13 +83,6 @@ class Mark:
     id: int
     """Citation ID, matches Footnote.id"""
 
-@dataclass
-class Text:
-    kind: TextKind
-    """Kind of text block."""
-    content: list[str | Mark]
-    """Text content with optional citation marks."""
-    
 @dataclass
 class Table:
     """HTML table."""
@@ -113,6 +106,12 @@ class Image:
     alt_text: str = "image"
     """Alt text (defaults to "image")"""
 
+@dataclass
+class TextBlock:
+    kind: TextKind
+    """Kind of text block."""
+    content: list["str | Mark | Formula | HTMLTag"]
+    """Text content with optional citation marks."""
 
 @dataclass
 class Footnote:
@@ -127,7 +126,7 @@ class Footnote:
     """Content blocks"""
 
 
-ContentBlock = Text | Table | Formula | Image
+ContentBlock = TextBlock | Table | Formula | Image
 """Union of all content blocks that appear in main chapter content."""
 
 @dataclass
@@ -139,4 +138,17 @@ class Chapter:
     footnotes: list[Footnote] = field(default_factory=list)
     """Footnotes"""
 
-ChapterGetter = Callable[[], Chapter]
+ChapterGetter = Callable[[], Chapter]
+
+@dataclass
+class HTMLTag:
+    """Generic HTML tag representation."""
+
+    name: str
+    """Tag name"""
+
+    attributes: list[tuple[str, str]] = field(default_factory=list)
+    """List of (attribute, value) pairs"""
+
+    content: list["str | Mark | Formula | HTMLTag"] = field(default_factory=list)
+    """Inner HTML content"""

{epub_generator-0.1.1 → epub_generator-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "epub-generator"
-version = "0.1.1"
+version = "0.1.3"
 description = "A simple Python EPUB 3.0 generator with a single API call"
 authors = ["Tao Zeyu <i@taozeyu.com>"]
 license = "MIT"

epub_generator-0.1.1/epub_generator/generation/xml_utils.py

@@ -1,18 +0,0 @@
-import re
-from xml.etree.ElementTree import Element, tostring
-
-_EPUB_NS = "http://www.idpf.org/2007/ops"
-
-
-def set_epub_type(element: Element, epub_type: str) -> None:
-    element.set(f"{{{_EPUB_NS}}}type", epub_type)
-
-def serialize_element(element: Element) -> str:
-    xml_string = tostring(element, encoding="unicode")
-    xml_string = xml_string.replace(f"{{{_EPUB_NS}}}", "epub:")
-    ns_pattern = r'xmlns:(ns\d+)="' + re.escape(_EPUB_NS) + r'"'
-    matches = re.findall(ns_pattern, xml_string)
-    for ns_prefix in matches:
-        xml_string = xml_string.replace(f' xmlns:{ns_prefix}="{_EPUB_NS}"', "")
-        xml_string = xml_string.replace(f"{ns_prefix}:", "epub:")
-    return xml_string