bug #181 Add support for tilde characters (javiereguiluz, wouterj)

This PR was merged into the main branch.

Discussion
----------

Add support for tilde characters

Related to
* symfony/symfony-docs#20215

This PR adds a failing test that shows the issue. This is the output change that would make test pass:

```diff
-<p>Excepteur &nbsp;1,000 sint! ...
+<p>Excepteur ~1,000 sint! ...
```

Commits
-------

9223ccc Temporary replace tildes to avoid it being parsed as NBSP
3a300ac Add support for tilde characters

Author: javiereguiluz

src/Renderers/SpanNodeRenderer.php

@@ -42,6 +42,19 @@ public function __construct(
         $this->symfonyVersion = $symfonyVersion;
     }
 
+    public function render(): string
+    {
+        // Work around "~" being parsed as non-breaking space by rst-parser,
+        // while this is not part of the specification.
+        $spanValue = $this->span->getValue();
+        $spanValue = str_replace('~', '__TILDE__', $spanValue);
+        $this->span->setValue($spanValue);
+
+        $rendered = parent::render();
+
+        return str_replace('__TILDE__', '~', $rendered);
+    }
+
     /** @inheritDoc */
     public function link(?string $url, string $title, array $attributes = []): string
     {

tests/IntegrationTest.php

@@ -142,6 +142,10 @@ public function parserUnitBlockProvider()
             'blockName' => 'nodes/span-link',
         ];
 
+        yield 'text' => [
+            'blockName' => 'nodes/text',
+        ];
+
         yield 'title' => [
             'blockName' => 'nodes/title',
         ];

tests/fixtures/expected/blocks/nodes/text.html

@@ -0,0 +1,7 @@
+<p><strong>Lorem ipsum</strong> dolor sit amet, consectetur adipisicing elit. Ut enim ad minim
+veniam, quis nostrud <em>exercitation ullamco laboris</em> nisi ut aliquip ex ea
+commodo consequat. <code translate="no" class="notranslate">Duis aute irure dolor</code> in reprehenderit in voluptate
+velit esse cillum dolore eu fugiat nulla pariatur.</p>
+
+<p>Excepteur ~1,000 sint! Occaecat cupidatat non proident, sunt in culpa qui officia
+deserunt mollit anim id est laborum. áàâäãåéèêëíìîïóòôöõúùûüñçÿ</p>

tests/fixtures/source/blocks/nodes/text.rst

@@ -0,0 +1,7 @@
+**Lorem ipsum** dolor sit amet, consectetur adipisicing elit. Ut enim ad minim
+veniam, quis nostrud *exercitation ullamco laboris* nisi ut aliquip ex ea
+commodo consequat. ``Duis aute irure dolor`` in reprehenderit in voluptate
+velit esse cillum dolore eu fugiat nulla pariatur.
+
+Excepteur ~1,000 sint! Occaecat cupidatat non proident, sunt in culpa qui officia
+deserunt mollit anim id est laborum. áàâäãåéèêëíìîïóòôöõúùûüñçÿ