Merge pull request #697 from PHPCSStandards/generators-html-only-display-toc-for-multiple-docs

jrfnl · web-flow · commit 806f4adcedc3 · 2024-11-22T17:05:02.000+01:00
Generators/HTML: only display a TOC when there is more than one doc
diff --git a/src/Generators/HTML.php b/src/Generators/HTML.php
@@ -156,6 +156,11 @@ protected function printHeader()
      */
     protected function printToc()
     {
+        // Only show a TOC when there are two or more docs to display.
+        if (count($this->docFiles) < 2) {
+            return;
+        }
+
         echo '  <h2>Table of Contents</h2>'.PHP_EOL;
         echo '  <ul class="toc">'.PHP_EOL;
 
diff --git a/tests/Core/Generators/Expectations/ExpectedOutputOneDoc.html b/tests/Core/Generators/Expectations/ExpectedOutputOneDoc.html
@@ -70,10 +70,6 @@
  </head>
  <body>
   <h1>GeneratorTest Coding Standards</h1>
-  <h2>Table of Contents</h2>
-  <ul class="toc">
-   <li><a href="#One-Standard-Block,-No-Code">One Standard Block, No Code</a></li>
-  </ul>
   <a name="One-Standard-Block,-No-Code" />
   <h2>One Standard Block, No Code</h2>
   <p class="text">Documentation contains one standard block and no code comparison.</p>
