[FEATURE] Move tip admonition from doctrine/doctrine-website

lib/Directives/Admonition.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\RST\Directives;
+
+use Doctrine\RST\Nodes\Node;
+use Doctrine\RST\Nodes\WrapperNode;
+use Doctrine\RST\Parser;
+
+use function sprintf;
+
+class Admonition extends SubDirective
+{
+    /** @var string */
+    private $name;
+
+    /** @var string */
+    private $backgroundColor;
+
+    /** @var string */
+    private $textColor;
+
+    /** @var string */
+    private $icon;
+
+    public function __construct(string $name, string $backgroundColor, string $textColor, string $icon)
+    {
+        $this->name            = $name;
+        $this->backgroundColor = $backgroundColor;
+        $this->textColor       = $textColor;
+        $this->icon            = $icon;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+
+    /** @param string[] $options */
+    public function processSub(
+        Parser $parser,
+        ?Node $document,
+        string $variable,
+        string $data,
+        array $options
+    ): ?Node {
+        return new WrapperNode($document, sprintf(
+            '<div class="alert %s-admonition %s %s border"><table width="100%%"><tr><td width="10" class="align-top"><i class="%s mr-2"></i></td><td>',
+            $this->name,
+            $this->backgroundColor,
+            $this->textColor,
+            $this->icon
+        ), '</td></tr></table></div>');
+    }
+}

lib/Directives/Tip.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\RST\Directives;
+
+class Tip extends Admonition
+{
+    public function __construct()
+    {
+        parent::__construct('tip', 'bg-success', 'text-light', 'fas fa-question-circle');
+    }
+}

lib/Kernel.php

@@ -38,6 +38,7 @@ public function __construct(
             new Directives\CodeBlock(),
             new Directives\Raw(),
             new Directives\Replace(),
+            new Directives\Tip(),
             new Directives\Toctree(),
         ], $this->configuration->getFormat()->getDirectives(), $directives);
 

tests/Functional/tests/tip-multiline/tip-multiline.html

@@ -0,0 +1,12 @@
+<div class="alert tip-admonition bg-success text-light border">
+    <table width="100%">
+        <tr>
+            <td width="10" class="align-top"><i class="fas fa-question-circle mr-2"></i></td>
+            <td>
+                <p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+voluptua. At vero eos et accusam et justo duo dolores et ea rebum.</p>
+            </td>
+        </tr>
+    </table>
+</div>

tests/Functional/tests/tip-multiline/tip-multiline.rst

@@ -0,0 +1,5 @@
+.. tip::
+
+    Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
+    eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
+    voluptua. At vero eos et accusam et justo duo dolores et ea rebum.

tests/Functional/tests/tip/tip.html

@@ -0,0 +1,10 @@
+<div class="alert tip-admonition bg-success text-light border">
+    <table width="100%">
+        <tr>
+            <td width="10" class="align-top"><i class="fas fa-question-circle mr-2"></i></td>
+            <td>
+                <p>This is a tip</p>
+            </td>
+        </tr>
+    </table>
+</div>

tests/Functional/tests/tip/tip.rst

@@ -0,0 +1,2 @@
+.. tip::
+    This is a tip