[FEATURE] Create a rst theme to convert markdown

Convert basic mark-down into restructured Text

* blockquote

Author: linawolf

packages/guides-theme-rst/resources/template/rst/body/code.rst.twig

@@ -1,3 +1,6 @@
 ..  code-block:: plaintext
 
 {{ renderRstIndent(node.value|raw, 1)|raw }}
+{{ "\n" }}
+{{ "\n" }}
+

packages/guides-theme-rst/resources/template/rst/body/list/list.rst.twig

@@ -1,9 +1,11 @@
+{{ "\n" }}
 {% if node.isOrdered -%}
     {%- for item in node.value -%}
-        #.  {{ renderNode(item.value)|raw }}{{ "\n\n" }}
+        #.  {{ renderNode(item.value)|raw }}{{ "\n" }}
     {% endfor -%}
 {%- else -%}
     {%- for item in node.value -%}
         *   {{ renderNode(item.value)|raw }}{{ "\n" }}
     {%- endfor -%}
-{%- endif -%}
+{%- endif %}
+{{ "\n" }}

packages/guides-theme-rst/resources/template/rst/body/paragraph.rst.twig

@@ -1,4 +1,6 @@
-{%- set text = renderNode(node.value)|raw -%}
+{% set text = renderNode(node.value)|raw -%}
 {%- if text|trim %}
     {{- text|raw -}}
 {% endif -%}
+{{ "\n" }}
+{{ "\n" }}

packages/guides-theme-rst/resources/template/rst/body/quote.rst.twig

@@ -1 +1,3 @@
-    {{ renderNode(node.value) }}
+{{ renderRstIndent(renderNode(node.value)|raw, 1)|raw }}
+{{ "\n" }}
+{{ "\n" }}

packages/guides-theme-rst/resources/template/rst/inline/image.rst.twig

@@ -1,2 +1,4 @@
-..  figure:: {{ node.url }}
-    :alt: {{ node.altText }}
+{{ "\n" }}
+..  figure:: {{ node.url|raw }}
+    :alt: {{ node.altText|raw }}
+{{ "\n" }}

packages/guides-theme-rst/resources/template/rst/inline/inline-node.rst.twig

@@ -1,3 +1,3 @@
 {%- for child in node.children -%}
-    {{- renderNode(child) -}}
+    {{- renderNode(child)|raw -}}
 {%- endfor -%}

packages/guides-theme-rst/resources/template/rst/inline/literal.rst.twig

@@ -1,5 +1,5 @@
 {%- if node.value matches '/`/' -%}
-    ``{{- node.value -}}``
+    ``{{- node.value|raw -}}``
 {%- else -%}
-    `{{- node.value -}}`
+    `{{- node.value|raw -}}`
 {%- endif -%}

packages/guides-theme-rst/resources/template/rst/structure/document.rst.twig

@@ -1,3 +1,7 @@
-{% for child in node.children -%}
-    {{- renderNode(child) -}}
-{%- endfor %}
+{%- set renderedContent -%}
+    {%- for child in node.children -%}
+        {{- renderNode(child) -}}
+    {%- endfor -%}
+{%- endset -%}
+
+{{- renderedContent | clean_content | raw -}}

packages/guides-theme-rst/src/RstTheme/Twig/RstExtension.php

@@ -19,6 +19,7 @@
 use phpDocumentor\Guides\RstTheme\Configuration\HeaderSyntax;
 use phpDocumentor\Guides\Twig\GlobalMenuExtension;
 use Twig\Extension\AbstractExtension;
+use Twig\TwigFilter;
 use Twig\TwigFunction;
 
 use function min;
@@ -43,6 +44,24 @@ public function getFunctions(): array
         ];
     }
 
+    /** @return TwigFilter[] */
+    public function getFilters(): array
+    {
+        return [
+            new TwigFilter('clean_content', [$this, 'cleanContent']),
+        ];
+    }
+
+    public function cleanContent(string $content): string
+    {
+        $lines = explode("\n", $content);
+        $lines = array_map('rtrim', $lines);
+        $content = implode("\n", $lines);
+
+        $content = preg_replace('/(\n){2,}/', "\n\n", $content);
+        return rtrim($content)."\n";
+    }
+
     public function renderRstIndent(string $text, int $indentNr): string
     {
         $indent = str_repeat(' ', $indentNr*4);

tests/Integration/tests-full/md-to-rst/blockquote-md-to-rst/expected/index.rst

@@ -0,0 +1,32 @@
+====================
+Markdown Blockquotes
+====================
+
+    This is a blockquote. It can span multiple lines.
+
+Blockquotes with Multiple Paragraphs
+====================================
+
+    Dorothy followed her through many of the beautiful rooms in her castle.
+
+    The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.
+
+Blockquotes with Other Elements
+===============================
+
+    The quarterly results look great!
+
+    *   Revenue was off the chart.
+
+    *   Profits were higher than ever.
+
+    *Everything* is going according to **plan**.
+
+Blockquotes Best Practices
+==========================
+
+Try to put a blank line before...
+
+    This is a blockquote
+
+...and after a blockquote.