Introducing TextRendererMixin

Author: Lucas-C

.github/workflows/continuous-integration-workflow.yml

@@ -149,7 +149,7 @@ jobs:
           sed -i "s/author:.*/author: v$(python setup.py -V 2>/dev/null)/" mkdocs.yml
           cp tutorial/notebook.ipynb docs/
           mkdocs build
-          pdoc --html -o public/ fpdf --config "git_link_template='https://github.com/py-pdf/fpdf2/blob/{commit}/{path}#L{start_line}-L{end_line}'"
+          pdoc --html -o public/ fpdf --template-dir docs/pdoc
           scripts/add_pdoc_to_search_index.py
       - name: Build contributors map 🗺️
         # As build_contributors_html_page.py can hang due to GitHub rate-limiting, we only execute this on master for now

docs/Development.md

@@ -240,7 +240,7 @@ To preview the Markdown documentation, launch a local rendering server with:
 
 To preview the API documentation, launch a local rendering server with:
 
-    pdoc --html -o public/ fpdf --http :
+    pdoc --html -o public/ fpdf --template-dir docs/pdoc --http :
 
 ## PDF spec & new features
 The **PDF 1.7 spec** is available on Adobe website:

docs/Internals.md

@@ -94,4 +94,5 @@ drawing.py & svg.py packages
 
 ## Text shaping ?
 
++ add a diagram of the main links between modules/classes
 -->

docs/pdoc/config.mako

@@ -0,0 +1,7 @@
+<%!
+    # pdoc configuration
+    # * Doc: https://pdoc3.github.io/pdoc/doc/pdoc/#custom-templates
+    # * Defaults: https://github.com/pdoc3/pdoc/blob/master/pdoc/templates/config.mako
+    git_link_template = 'https://github.com/py-pdf/fpdf2/blob/{commit}/{path}#L{start_line}-L{end_line}'
+    show_inherited_members = True
+%>

fpdf/__init__.py

@@ -24,12 +24,12 @@
 from .fpdf import (
     FPDF,
     TitleStyle,
-    FPDF_FONT_DIR as _FPDF_FONT_DIR,
     FPDF_VERSION as _FPDF_VERSION,
 )
 from .html import HTMLMixin, HTML2FPDF
 from .prefs import ViewerPreferences
 from .template import Template, FlexTemplate
+from .text_renderer import FPDF_FONT_DIR as _FPDF_FONT_DIR
 from .util import get_scale_factor
 
 try:

fpdf/fonts.py

@@ -33,7 +33,7 @@ def __deepcopy__(self, _memo):
 
 from .deprecation import get_stack_level
 from .drawing import convert_to_device_color, DeviceGray, DeviceRGB
-from .enums import FontDescriptorFlags, TextEmphasis, Align
+from .enums import Align, FontDescriptorFlags, TextEmphasis
 from .syntax import Name, PDFObject
 from .util import escape_parens