Removed .md suffix from documentation urls (#1277)

Author: norberttech

web/landing/src/Flow/Website/Service/Documentation/Pages.php

@@ -34,6 +34,8 @@ public function all() : array
                 continue;
             }
 
+            $relativePath = str_replace('.md', '', $relativePath);
+
             $pages[] = new Page($relativePath, \file_get_contents($file->path->path()));
         }
 

web/landing/src/Flow/Website/Service/Markdown/FlowLinkRenderer.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Flow\Website\Service\Markdown;
+
+use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
+use League\CommonMark\Node\Node;
+use League\CommonMark\Renderer\{ChildNodeRendererInterface, NodeRendererInterface};
+use League\CommonMark\Util\HtmlElement;
+
+class FlowLinkRenderer implements NodeRendererInterface
+{
+    public function render(Node $node, ChildNodeRendererInterface $childRenderer)
+    {
+        if (!$node instanceof Link) {
+            throw new \InvalidArgumentException('Incompatible node type: ' . $node::class);
+        }
+
+        $attrs = $node->data->get('attributes');
+
+        $urlParts = parse_url($node->getUrl());
+
+        if (!isset($urlParts['scheme']) && !isset($urlParts['host'])) {
+            $node->setUrl(str_replace('.md', '', $node->getUrl()));
+        }
+
+        $attrs['href'] = $node->getUrl();
+
+        if ($node->getTitle()) {
+            $attrs['title'] = $node->getTitle();
+        }
+
+        return new HtmlElement('a', $attrs, $childRenderer->renderNodes($node->children()));
+    }
+}

web/landing/src/Flow/Website/Service/Markdown/LeagueCommonMarkConverterFactory.php

@@ -7,6 +7,7 @@
 use League\CommonMark\CommonMarkConverter;
 use League\CommonMark\Extension\CommonMark\CommonMarkCoreExtension;
 use League\CommonMark\Extension\CommonMark\Node\Block\FencedCode;
+use League\CommonMark\Extension\CommonMark\Node\Inline\Link;
 use League\CommonMark\Extension\ExternalLink\ExternalLinkExtension;
 
 final class LeagueCommonMarkConverterFactory
@@ -24,7 +25,8 @@ public function __invoke() : CommonMarkConverter
 
         $converter->getEnvironment()
             ->addExtension(new ExternalLinkExtension())
-            ->addRenderer(FencedCode::class, new FlowCodeRenderer(), 0);
+            ->addRenderer(FencedCode::class, new FlowCodeRenderer(), 0)
+            ->addRenderer(Link::class, new FlowLinkRenderer(), 0);
         //        $converter->getEnvironment()->addExtension(new CommonMarkCoreExtension());
         //        foreach ($this->extensions as $extension) {
         //            $converter->getEnvironment()->addRenderer(new FlowCodeRenderer());