Fix function preview image display

Author: Fernando-A-Rocha

web/resources/function.html

@@ -60,27 +60,36 @@ <h2>Returns</h2>
         {% endif %}
         <ul>
             {% for item in function[type_name].returns["values"] %}
-                <li style="margin-bottom: 1em;">{{ item.type }} {{ item.name }}</li>
+                <li>{{ item.type }} {{ item.name }}</li>
             {% endfor %}
         </ul>
     {% endif %}
 {% endif %}
 {% endfor %}
 
 <!-- Preview Images -->
+{% if function.has_preview_image %}
+<h2>Images</h2>
 {% for type_name in ['shared', 'client', 'server'] %}
     {% if function[type_name] %}
 
         {% if function[type_name].preview_images %}
             <div>
+                <ul>
                 {% for image in function[type_name].preview_images %}
-                    <p style="margin-top: 1em; margin-bottom: 0.5em;"><em>{{ image.description }}</em></p>
-                    <img style="max-height: 150px;" src="{{ image.path_html }}" alt="{{ image.description }}">
+                    <li>
+                        {% if image.description_html %}
+                            <p>{{ image.description_html }}</p>
+                        {% endif %}
+                        <img style="max-height: 150px;" src="{{ image.path_html }}">
+                    </li>
                 {% endfor %}
+                </ul>
             </div>
         {% endif %}
     {% endif %}
 {% endfor %}
+{% endif %}
 
 <!-- Issues -->
 {% if function.has_issue %}

web/scripts/builder.py

@@ -101,6 +101,12 @@ def parse_functions(self):
                                     for issue in type_info['issues']:
                                         issue['description_html'] = utils.to_html(issue['description'], single_paragraph=True)
 
+                                if 'preview_images' in type_info:
+                                    function["has_preview_image"] = True
+                                    for preview_img in type_info['preview_images']:
+                                        if 'description' in preview_img:
+                                            preview_img['description_html'] = utils.to_html(preview_img['description'], single_paragraph=True)
+
                                 if ('returns' in type_info) and ('description' in type_info['returns']):
                                     type_info['returns']['description_html'] = utils.to_html(type_info['returns']['description'], single_paragraph=True)
 
@@ -190,17 +196,15 @@ def parse_function_preview_images(self, function):
                 base_name = os.path.basename(real_path)
                 output_path = os.path.join(preview_images_folder, base_name)
 
-                # Ignore if destination file already exists
-                if os.path.exists(output_path):
-                    continue
-
-                shutil.copyfile(real_path, output_path)
-                self.logger.info(f"Created function preview image {output_path}")
+                # Copy only if not already copied
+                if not os.path.exists(output_path):
+                    shutil.copyfile(real_path, output_path)
+                    self.logger.info(f"Created function preview image {output_path}")
 
                 preview_images[type_name].append({
                     'real_path': real_path,
                     'path_html': f"/function_images/{base_name}",
-                    'description': preview_img.get('description'),
+                    'description': preview_img.get('description', ''),
                 })
                 type_info['preview_images'] = preview_images[type_name]