Initial commit: Odoo 18.0-20251222 extra-addons

html_text/readme/CONTRIBUTORS.md

@@ -0,0 +1,9 @@
+- Dennis Sluijk \<d.sluijk@onestein.nl\>
+- [Tecnativa](https://www.tecnativa.com):",
+- Helly kapatel \<helly.kapatel@initos.com\>
+- Mantas Šniukas \<mantas@vialaurea.lt\>
+- Dhara Solanki \<dhara.solanki@initos.com\>
+  - Jairo Llopis
+  - Vicent Cubells
+  - Víctor Martínez
+- Chau Le \<chaulb@trobz.com\>

html_text/readme/DESCRIPTION.md

@@ -0,0 +1,8 @@
+This module provides some technical features that allow to extract text
+from any chunk of HTML, without HTML tags or attributes. You can chose
+either:
+
+- To truncate the result by amount of words or characters.
+- To append an ellipsis (or any character(s)) at the end of the result.
+
+It can be used to easily generate excerpts.

html_text/readme/ROADMAP.md

@@ -0,0 +1,2 @@
+- An option could be added to try to respect the basic HTML tags inside
+  the excerpt (`<b>`, `<i>`, `<p>`, etc.).

html_text/readme/USAGE.md

@@ -0,0 +1,19 @@
+This module just adds a technical utility, but nothing for the end user.
+
+If you are a developer and need this utility for your module, see these
+examples and read the docs inside the code.
+
+Python example:
+
+    def some_method(self):
+        # Get truncated text from an HTML field. It will 40 words and 100
+        # characters at most, and will have "..." appended at the end if it
+        # gets truncated.
+        truncated_text = self.env["ir.fields.converter"].text_from_html(
+            self.html_field, 40, 100, "...")
+
+QWeb example:
+
+    <t t-esc="env['ir.fields.converter'].text_from_html(doc.html_field)"/>
+
+[![Try me on Runbot](https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas)](https://runbot.odoo-community.org/runbot/149/11.0)