Fixes in Basic vs Pro comparison table (#1235)

* Update comparison table

Signed-off-by: Emilio Cuesta <emiliocuesta@eprosima.com>

* Resolve pathto

Signed-off-by: Emilio Cuesta <emiliocuesta@eprosima.com>

---------

Signed-off-by: Emilio Cuesta <emiliocuesta@eprosima.com>

Author: emiliocuestaf

docs/02-formalia/titlepage.rst

@@ -77,66 +77,73 @@ The following table contains a brief comparison between *Fast DDS* and *Fast DDS
       <tr>
         <th style="width:20%"></th>
         <th style="width:40%; text-align:center; vertical-align:bottom;">
-          <img src="_static/fast-dds-pro-logo-large.png" alt="Fast DDS Pro" width="300px"><br>
+          <img src="pathto('_static/fast-dds-pro-logo-large.png', 1)" alt="Fast DDS Pro" width="300px"><br>
         </th>
         <th style="width:40%; text-align:center; vertical-align:bottom;">
-          <img src="_static/fast-dds-logo-large.png" alt="Fast DDS" width="250px"><br>
+          <img src="pathto('_static/fast-dds-logo-large.png', 1)" alt="Fast DDS (Community)" width="250px"><br>
         </th>
       </tr>
     </thead>
     <tbody>
       <tr>
-        <td>Uses</td>
-        <td>Industrial &amp; Defense</td>
-        <td>R&amp;D</td>
+        <th>Target usage</th>
+        <td>Production systems, industrial, robotics, defense</td>
+        <td>Evaluation, prototyping, early development, research</td>
       </tr>
       <tr>
-        <td>OS</td>
-        <td>POSIX compliant (Linux, Windows, MacOS)</td>
-        <td>POSIX compliant (Linux, Windows, MacOS)</td>
+        <th>License</th>
+        <td>Commercial</td>
+        <td>Open Source (Apache 2.0)</td>
       </tr>
       <tr>
-        <td>License</td>
-        <td>Commercial</td>
-        <td>Open Source</td>
+        <th>Support</th>
+        <td>✅ Direct engineering support (unlimited)</td>
+        <td>❌ Community-based</td>
+      </tr>
+      <tr>
+        <th>Maintenance / LTS</th>
+        <td>✅ Long-term support (~24 months, backports)</td>
+        <td>❌ No guaranteed maintenance</td>
       </tr>
       <tr>
-        <td colspan="3" class="section-header">Feature Set</td>
+        <th>Predictability</th>
+        <td>✅ Controlled releases &amp; fixes</td>
+        <td>⚠️ Best-effort evolution</td>
       </tr>
       <tr>
-        <td>DDS Pub/Sub &amp; QoS</td>
-        <td>✅ With extended features</td>
-        <td>✅ With extended features</td>
+        <th>DDS Pub/Sub &amp; QoS</th>
+        <td>✅ Full</td>
+        <td>✅ Full</td>
       </tr>
       <tr>
-        <td>TSN over DDS</td>
+        <th>TSN over DDS</th>
         <td>✅</td>
         <td>❌</td>
       </tr>
       <tr>
-        <td>RPC over DDS</td>
-        <td>✅ Including RPC streaming</td>
+        <th>RPC over DDS</th>
+        <td>✅ (incl. streaming)</td>
         <td>❌</td>
       </tr>
       <tr>
-        <td>IP Mobility</td>
+        <th>IP Mobility</th>
         <td>✅</td>
         <td>❌</td>
       </tr>
       <tr>
-        <td>Low Bandwidth Transports</td>
+        <th>Low Bandwidth Transports</th>
         <td>✅</td>
         <td>❌</td>
       </tr>
       <tr>
-        <td>Adaptive Congestion Control</td>
+        <th>Adaptive Congestion Control</th>
         <td>✅</td>
         <td>❌</td>
       </tr>
       <tr>
-        <td>Discovery Server</td>
-        <td>✅ With enhanced matching algorithm</td>
-        <td>⚠️ Basic functionality</td>
+        <th>Discovery Server</th>
+        <td>✅ Advanced / optimized matching</td>
+        <td>⚠️ Standard functionality</td>
       </tr>
     </tbody>
   </table>

docs/conf.py

@@ -18,11 +18,14 @@
 #
 # import sys
 # sys.path.insert(0, os.path.abspath('.'))
+from docutils import nodes
 import git
 import json
 import os
 import os.path
 import pathlib
+import posixpath
+import re
 import requests
 import shutil
 import subprocess
@@ -32,6 +35,47 @@
 def setup(app):
     # Add property to avoid warning.
     app.add_config_value("skip_python", None, "")
+    app.connect("doctree-resolved", replace_pathto_in_raw_html)
+
+
+_PATHTO_RE = re.compile(
+    r"""pathto\(\s*(['"])(?P<target>[^'"]+)\1(?:\s*,\s*(?P<resource>\d+))?\s*\)"""
+)
+
+
+def replace_pathto_in_raw_html(app, doctree, docname):
+    """
+    Replace pathto(...) usages inside raw HTML nodes.
+
+    Sphinx only expands ``pathto`` in Jinja templates, not in reStructuredText
+    document bodies. Some pages embed raw HTML and expect ``pathto('_static/...', 1)``
+    to resolve to the correct relative asset path. Convert those calls after the
+    doctree has been resolved so included documents are rewritten using the final
+    output page path.
+    """
+
+    if app.builder.format != "html":
+        return
+
+    depth = docname.count("/")
+    prefix = "../" * depth
+
+    def repl(match):
+        target = match.group("target").lstrip("/")
+        if "://" in target or target.startswith(("#", "mailto:", "javascript:")):
+            return target
+        return posixpath.normpath(prefix + target)
+
+    for node in doctree.findall():
+        if node.tagname != "raw":
+            continue
+        if "html" not in node.get("format", "").split():
+            continue
+        updated = _PATHTO_RE.sub(repl, node.astext())
+        if updated == node.astext():
+            continue
+        node.rawsource = updated
+        node.children = [nodes.Text(updated)]
 
 
 def download_json():