bug #138 Add support for CSS classes in code blocks (javiereguiluz, weaverryan)

This PR was merged into the main branch.

Discussion
----------

Add support for CSS classes in code blocks

In a Symfony book we have this RST code:

```rst
The workflow starts with the creation of a Git branch:

.. code-block:: terminal
    :class: hide

    $ git branch -D sessions-in-db || true

.. code-block:: terminal

    $ git checkout -b sessions-in-db

This command creates a ``sessions-in-db`` branch from the ``master`` branch. It "forks" the code and the infrastructure configuration.
```

The `:class: hide` attribute is important because that command should not be displayed to the book reader. Thus, we add the `hide` CSS class and hide that item on the webpage.

However, this doesn't work because the RST parser seems to not propagate CSS classes in code blocks. This PR tries to fix that, but it's not working. It contains a failing test in `terminal.rst`/ `terminal.html` files. Thanks!

Commits
-------

ee044c1 Forwarding CSS classes to CodeNode
6367bc3 Add support for CSS classes in code blocks

Author: javiereguiluz

src/Directive/CodeBlockDirective.php

@@ -33,6 +33,9 @@ public function process(Parser $parser, ?Node $node, string $variable, string $d
         }
 
         $node->setLanguage($data);
+        // grab the "class" option and forward it onto the Node
+        // CodeNodeRenderer can then use it when rendering
+        $node->setClasses(isset($options['class']) ? explode(' ', $options['class']) : []);
 
         if ('' !== $variable) {
             $environment = $parser->getEnvironment();

src/Renderers/CodeNodeRenderer.php

@@ -84,6 +84,7 @@ public function render(): string
         return $this->templateRenderer->render(
             'code.html.twig',
             [
+                'css_classes' => $this->codeNode->getClassesString(),
                 'languages' => $languages,
                 'line_numbers' => $lineNumbers,
                 'code' => $highlightedCode,

src/Templates/default/html/code.html.twig

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="{{ loc }}" class="notranslate codeblock codeblock-length-{{ length }} {{ languages|map(language => "codeblock-#{language}")|join(' ') }}">
+<div translate="no" data-loc="{{ loc }}" class="notranslate codeblock codeblock-length-{{ length }} {{ languages|map(language => "codeblock-#{language}")|join(' ') }} {{ css_classes }}">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">{{ line_numbers }}</pre>
         <pre class="codeblock-code"><code>{{ code|raw }}</code></pre>

tests/fixtures/expected/blocks/code-blocks/bash.html

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="1" class="notranslate codeblock codeblock-length-sm codeblock-bash">
+<div translate="no" data-loc="1" class="notranslate codeblock codeblock-length-sm codeblock-bash ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1</pre>
         <pre class="codeblock-code"><code>git <span class="hljs-built_in">clone</span> git@github.com:symfony/symfony.git</code></pre>

tests/fixtures/expected/blocks/code-blocks/diff.html

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="5" class="notranslate codeblock codeblock-length-sm codeblock-diff">
+<div translate="no" data-loc="5" class="notranslate codeblock codeblock-length-sm codeblock-diff ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1
 2
@@ -17,7 +17,7 @@
     </div>
 </div>
 
-<div translate="no" data-loc="6" class="notranslate codeblock codeblock-length-sm codeblock-diff">
+<div translate="no" data-loc="6" class="notranslate codeblock codeblock-length-sm codeblock-diff ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1
 2

tests/fixtures/expected/blocks/code-blocks/html-php.html

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="12" class="notranslate codeblock codeblock-length-md codeblock-html+php codeblock-html">
+<div translate="no" data-loc="12" class="notranslate codeblock codeblock-length-md codeblock-html+php codeblock-html ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1
 2

tests/fixtures/expected/blocks/code-blocks/html-twig.html

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="2" class="notranslate codeblock codeblock-length-sm codeblock-html+twig codeblock-twig">
+<div translate="no" data-loc="2" class="notranslate codeblock codeblock-length-sm codeblock-html+twig codeblock-twig ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1
 2</pre>

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

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="1" class="notranslate codeblock codeblock-length-sm codeblock-html">
+<div translate="no" data-loc="1" class="notranslate codeblock codeblock-length-sm codeblock-html ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1</pre>
         <pre class="codeblock-code"><code><span class="hljs-comment">&lt;!-- some code --&gt;</span>

tests/fixtures/expected/blocks/code-blocks/ini.html

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="1" class="notranslate codeblock codeblock-length-sm codeblock-ini">
+<div translate="no" data-loc="1" class="notranslate codeblock codeblock-length-sm codeblock-ini ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1</pre>
         <pre class="codeblock-code"><code><span class="hljs-attr">fetch</span> = +refs/notes/*:refs/notes/*</code></pre>

tests/fixtures/expected/blocks/code-blocks/php-annotations.html

@@ -1,4 +1,4 @@
-<div translate="no" data-loc="14" class="notranslate codeblock codeblock-length-md codeblock-php-annotations codeblock-php">
+<div translate="no" data-loc="14" class="notranslate codeblock codeblock-length-md codeblock-php-annotations codeblock-php ">
     <div class="codeblock-scroll">
         <pre class="codeblock-lines">1
 2