[FEATURE] Handle image titles in Markdown

Resolves #1095

Author: linawolf

packages/guides-markdown/src/Markdown/Parsers/InlineParsers/InlineImageParser.php

@@ -52,7 +52,7 @@ protected function createInlineNode(CommonMarkNode $commonMarkNode, string|null
             );
         }
 
-        return new ImageInlineNode($commonMarkNode->getUrl(), $content ?? '');
+        return new ImageInlineNode($commonMarkNode->getUrl(), $content ?? '', $commonMarkNode->getTitle() ?? '');
     }
 
     protected function supportsCommonMarkNode(CommonMarkNode $commonMarkNode): bool

packages/guides/resources/template/html/inline/image.html.twig

@@ -1 +1,2 @@
-<img src="{%- if node.value is external_target -%} {{ node.value }} {%- else -%} {{ asset(node.value) }} {%- endif -%}" alt="{{- node.altText -}}"/>
+<img src="{%- if node.value is external_target -%} {{ node.value }} {%- else -%} {{ asset(node.value) }} {%- endif -%}" alt="{{- node.altText -}}"
+        {%- if node.title %} title="{{- node.title -}}" {%- endif  -%}/>

packages/guides/src/Nodes/Inline/ImageInlineNode.php

@@ -20,8 +20,11 @@ final class ImageInlineNode extends InlineNode
 {
     public const TYPE = 'image';
 
-    public function __construct(private readonly string $url, private readonly string $altText)
-    {
+    public function __construct(
+        private readonly string $url,
+        private readonly string $altText,
+        private readonly string|null $title = null,
+    ) {
         parent::__construct(self::TYPE, $url);
     }
 
@@ -34,4 +37,9 @@ public function getAltText(): string
     {
         return $this->altText;
     }
+
+    public function getTitle(): string
+    {
+        return $this->title ?? '';
+    }
 }

tests/Integration/tests/markdown/image-title-md/expected/hero-illustration.svg

@@ -0,0 +1,8 @@
+<!-- content start -->
+    <div class="section" id="markdown-image">
+            <h1>Markdown Image</h1>
+
+    <p><img src="/hero-illustration.svg" alt="Hero Illustrations" title="Some title"/></p>
+
+    </div>
+<!-- content end -->

tests/Integration/tests/markdown/image-title-md/expected/index.html

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<guides xmlns="https://www.phpdoc.org/guides"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="https://www.phpdoc.org/guides packages/guides-cli/resources/schema/guides.xsd"
+        input-format="md"
+>
+    <project title="Project Title" version="6.4"/>
+</guides>