#27: Add Image support to Markdown class

A new `Image` class is added inside the `Markdown` class, within the `Documentation` project. This class facilitates incorporating images in markdown files, handling file paths and providing a way to specify alternate text for an image. Also, it allows to specify the image path relative to a specific file.

Documentation/Synergy.Documentation.Tests/Architecture/Public/Api.of.Synergy.Documentation.verified.md

@@ -181,3 +181,13 @@
    ) : void
  - ToString() : string
 
+## Markup.Markdown+Image (class) : Markdown+IElement
+ - ctor(
+     filePath: CodeFile,
+     alternateText: string? [Nullable, Optional]
+   )
+ - RelativeTo(
+     file: CodeFile
+   ) : Markdown+Image
+ - ToString() : string
+

Documentation/Synergy.Documentation/Markup/Markdown.cs

@@ -231,5 +231,27 @@ public override string ToString()
         }
 
         #endregion
+
+        #region Image
+
+        public class Image : IElement
+        {
+            private readonly CodeFile _filePath;
+            private readonly string _alternateText;
+
+            public Image(CodeFile filePath, string? alternateText = null)
+            {
+                _filePath = filePath;
+                _alternateText = alternateText ?? filePath.FileName;
+            }
+
+            public override string ToString()
+                => $"![{_alternateText}]({_filePath.ToString().Replace(" ", "%20")}){Markdown.NL}";
+
+            public Image RelativeTo(CodeFile file)
+                => new(_filePath.RelativeTo(file.Folder), _alternateText);
+        }
+
+        #endregion
     }
 }