add php highlighter

Author: nikophil

_build/notes.md

@@ -9,6 +9,5 @@ Changes needed in symfony.com
 Notes
 =====
 
-- warning about exceptions thrown and abortOnError conf
 - add some format check on references
-- conf file, at least for sf version
+- toc tree bugs whith :glob:

_build/src/Nodes/CodeNode.php

@@ -3,7 +3,7 @@
 namespace SymfonyDocs\Nodes;
 
 use Doctrine\RST\Nodes\CodeNode as Base;
-use function htmlspecialchars;
+use Highlight\Highlighter;
 
 class CodeNode extends Base
 {
@@ -18,15 +18,15 @@ class CodeNode extends Base
                 </td>
                 <td class="code">
                     <div class="highlight">
-                        <pre>%s</pre>
+                        <pre class="hljs">%s</pre>
                     </div>
                 </td>
             </tr>
         </table>
     </div>
 </div>';
 
-    public function render() : string
+    public function render(): string
     {
         $nodeValue = $this->getValue();
         assert(is_string($nodeValue));
@@ -41,11 +41,16 @@ public function render() : string
             $lineNumbers .= $iAsString."\n";
         }
 
+        $language = $this->getLanguage() ?? 'php';
+
+        $highLighter     = new Highlighter();
+        $highlightedCode = $highLighter->highlight($language, implode("\n", $lines));
+
         return sprintf(
             self::CODE_BLOCK_TEMPLATE,
-            $this->getLanguage() ?? 'php',
+            $language,
             rtrim($lineNumbers),
-            implode("\n", $lines)
+            $highlightedCode->value
         );
     }
 

_build/tests/IntegrationTest.php

@@ -42,9 +42,9 @@ public function testIntegration(string $folder)
 
     public function integrationProvider()
     {
-        //        yield 'main' => [
-        //            'folder' => 'main'
-        //        ];
+//        yield 'main' => [
+//            'folder' => 'main',
+//        ];
 
         yield 'toctree' => [
             'folder' => 'toctree',

_build/tests/fixtures/expected/blocks/code-block.html

@@ -21,12 +21,11 @@
                 </td>
                 <td class="code">
                     <div class="highlight">
-                        <pre>// config/routes.php
-namespace Symfony\Component\Routing\Loader\Configurator;
-
-return function (RoutingConfigurator $routes) {
-    $routes->add('about_us', ['nl' => '/over-ons', 'en' => '/about-us'])
-        ->controller('App\Controller\CompanyController::about');
+                        <pre class="hljs">
+                                    <span class="hljs-comment">// config/routes.php</span>
+<span class="hljs-keyword">namespace</span> <span class="hljs-title">Symfony</span>\<span class="hljs-title">Component</span>\<span class="hljs-title">Routing</span>\<span class="hljs-title">Loader</span>\<span class="hljs-title">Configurator</span>; <span class="hljs-keyword">return</span>
+                                    <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-params">(RoutingConfigurator $routes)</span> </span>
+                                    { $routes-&gt;add(<span class="hljs-string">'about_us'</span>, [<span class="hljs-string">'nl'</span> =&gt; <span class="hljs-string">'/over-ons'</span>, <span class="hljs-string">'en'</span> =&gt; <span class="hljs-string">'/about-us'</span>]) -&gt;controller(<span class="hljs-string">'App\Controller\CompanyController::about'</span>);
 };</pre>
                     </div>
                 </td>

_build/tests/fixtures/expected/blocks/configuration-block.html

@@ -15,7 +15,7 @@
                 </td>
                 <td class="code">
                     <div class="highlight">
-                        <pre># app/config/services.yml</pre>
+                        <pre class="hljs"><span class="hljs-comment"># app/config/services.yml</span></pre>
                     </div>
                 </td>
             </tr>
@@ -32,7 +32,7 @@
                             </td>
                             <td class="code">
                                 <div class="highlight">
-                                    <pre>// config/routes.php</pre>
+                                    <pre class="hljs"><span class="hljs-comment">// config/routes.php</span></pre>
                                 </div>
                             </td>
                         </tr>

_build/tests/fixtures/expected/blocks/literal.html

@@ -22,12 +22,11 @@
                 </td>
                 <td class="code">
                     <div class="highlight">
-                        <pre>// config/routes.php
-namespace Symfony\Component\Routing\Loader\Configurator;
-
-return function (RoutingConfigurator $routes) {
-    $routes->add('about_us', ['nl' => '/over-ons', 'en' => '/about-us'])
-        ->controller('App\Controller\CompanyController::about');
+                        <pre class="hljs">
+                                    <span class="hljs-comment">// config/routes.php</span>
+<span class="hljs-keyword">namespace</span> <span class="hljs-title">Symfony</span>\<span class="hljs-title">Component</span>\<span class="hljs-title">Routing</span>\<span class="hljs-title">Loader</span>\<span class="hljs-title">Configurator</span>; <span class="hljs-keyword">return</span>
+                                    <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-params">(RoutingConfigurator $routes)</span> </span>
+                                    { $routes-&gt;add(<span class="hljs-string">'about_us'</span>, [<span class="hljs-string">'nl'</span> =&gt; <span class="hljs-string">'/over-ons'</span>, <span class="hljs-string">'en'</span> =&gt; <span class="hljs-string">'/about-us'</span>]) -&gt;controller(<span class="hljs-string">'App\Controller\CompanyController::about'</span>);
 };</pre>
                     </div>
                 </td>

_build/tests/fixtures/expected/blocks/note-code-block-nested.html

@@ -20,7 +20,7 @@
                         </td>
                         <td class="code">
                             <div class="highlight">
-                                <pre>// code</pre>
+                                <pre class="hljs"><span class="hljs-comment">// code</span></pre>
                             </div>
                         </td>
                     </tr>

_build/tests/fixtures/expected/blocks/sidebar-code-block-nested.html

@@ -20,7 +20,7 @@
                         </td>
                         <td class="code">
                             <div class="highlight">
-                                <pre>// some code</pre>
+                                <pre class="hljs"><span class="hljs-comment">// some code</span></pre>
                             </div>
                         </td>
                     </tr>