Merge remote-tracking branch 'upstream/main' into main

* upstream/main:
  Fixed the generation of TOCs
  Tweaked the prompts of console code blocks (#103)
  Added some CSS class to configuration block tabs (#104)

Author: javiereguiluz

src/Templates/default/html/directives/configuration-block.html.twig

@@ -1,5 +1,5 @@
 <div class="configuration-block">
-    <ul class="configuration-tabs">
+    <ul class="configuration-tabs configuration-tabs-length-{{ blocks|length }}">
         {% for block in blocks %}
             <li data-language="{{ block.language }}" {{ loop.first ? 'data-active="true"' }}>
                 <span>{{ block.language_label }}</span>

src/Twig/TocExtension.php

@@ -24,10 +24,16 @@ public function getFunctions(): array
     public static function getOptions(array $toc): array
     {
         $flattendToc = self::flattenToc($toc);
-        $maxDepth = 0;
+        // FIXME: this hardcoded '2' value should instead be obtained
+        // automatically using the 'maxdepth' option of 'toctree' directive.
+        // See https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html
+        $maxDepth = 2;
         $numVisibleItems = 0;
         foreach ($flattendToc as $tocItem) {
-            $maxDepth = max($maxDepth, $tocItem['level']);
+            if ($tocItem['level'] > $maxDepth) {
+                continue;
+            }
+
             $numVisibleItems++;
         }
 

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

@@ -1,5 +1,5 @@
 <div class="configuration-block">
-    <ul class="configuration-tabs">
+    <ul class="configuration-tabs configuration-tabs-length-2">
         <li data-language="yaml" data-active="true"> <span>YAML</span> </li>
         <li data-language="php" > <span>PHP</span> </li>
     </ul>

tests/fixtures/expected/main/datetime.html

@@ -189,7 +189,7 @@ <h3 id="error-bubbling"><a class="headerlink" href="#error-bubbling" title="Perm
 </div>
 <p>And configuration blocks:</p>
 <div class="configuration-block">
-    <ul class="configuration-tabs">
+    <ul class="configuration-tabs configuration-tabs-length-3">
         <li data-language="yaml" data-active="true"> <span>YAML</span> </li>
         <li data-language="xml" > <span>XML</span> </li>
         <li data-language="php" > <span>PHP</span> </li>