From cc34c79495145c340d48107f577405f9a7ab05e2 Mon Sep 17 00:00:00 2001
From: Duncan Tourolle <duncan@tourolle.paris>
Date: Sun, 9 Nov 2025 21:40:59 +0100
Subject: [PATCH] more examples

---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index 972fc53..f8569b8 100644
--- a/README.md
+++ b/README.md
@@ -119,6 +119,25 @@ The library supports various page layouts and configurations:
       <em>Buttons, forms, and callback binding</em>
     </td>
   </tr>
+  <tr>
+    <td align="center" width="50%">
+      <b>🆕 Pagination & PageBreak</b><br>
+      <img src="docs/images/example_08_pagination_explicit.png" width="300" alt="Pagination"><br>
+      <em>Multi-page documents with explicit and automatic breaks</em>
+    </td>
+    <td align="center" width="50%">
+      <b>🆕 Link Navigation</b><br>
+      <img src="docs/images/example_09_link_navigation.png" width="300" alt="Links"><br>
+      <em>All 4 link types: Internal, External, API, Function</em>
+    </td>
+  </tr>
+  <tr>
+    <td align="center" colspan="2">
+      <b>🆕 Comprehensive Forms</b><br>
+      <img src="docs/images/example_10_forms.png" width="300" alt="Forms"><br>
+      <em>All 14 form field types with validation</em>
+    </td>
+  </tr>
 </table>
 
 ## Examples
@@ -133,12 +152,20 @@ The `examples/` directory contains working demonstrations:
 - **[05_html_table_with_images.py](examples/05_html_table_with_images.py)** - Tables with embedded images
 - **[06_functional_elements_demo.py](examples/06_functional_elements_demo.py)** - Interactive buttons and forms with callbacks
 
+### 🆕 Advanced Features (NEW)
+- **[08_pagination_demo.py](examples/08_pagination_demo.py)** - Multi-page documents with PageBreak ([11 tests](tests/examples/test_08_pagination_demo.py))
+- **[09_link_navigation_demo.py](examples/09_link_navigation_demo.py)** - All link types and navigation ([10 tests](tests/examples/test_09_link_navigation_demo.py))
+- **[10_forms_demo.py](examples/10_forms_demo.py)** - All 14 form field types ([9 tests](tests/examples/test_10_forms_demo.py))
+
 Run any example:
 ```bash
 cd examples
 python 01_simple_page_rendering.py
+python 08_pagination_demo.py  # NEW: Multi-page documents
 ```
 
+**All new examples include comprehensive test coverage!** See [NEW_EXAMPLES_AND_TESTS_SUMMARY.md](docs/NEW_EXAMPLES_AND_TESTS_SUMMARY.md) for details.
+
 See **[examples/README.md](examples/README.md)** for detailed documentation.
 
 ## Documentation