Generators/HTML: move section link creation to own function

Move the creation of in-page anchor link text to a separate function as this was done in two separate places.
The separate function will make it more straight-forward to safeguard that the anchors and the links to these anchors stay in sync.

Author: jrfnl

src/Generators/HTML.php

@@ -215,7 +215,7 @@ protected function getFormattedToc()
             $doc->load($file);
             $documentation = $doc->getElementsByTagName('documentation')->item(0);
             $title         = $this->getTitle($documentation);
-            $output       .= sprintf($listItemTemplate, str_replace(' ', '-', $title), $title);
+            $output       .= sprintf($listItemTemplate, $this->titleToAnchor($title), $title);
         }
 
         $output .= '  </ul>'.PHP_EOL;
@@ -290,14 +290,30 @@ public function processSniff(DOMNode $doc)
 
         if (trim($content) !== '') {
             $title = $this->getTitle($doc);
-            echo '  <a name="'.str_replace(' ', '-', $title).'" />'.PHP_EOL;
+            echo '  <a name="'.$this->titleToAnchor($title).'" />'.PHP_EOL;
             echo '  <h2>'.$title.'</h2>'.PHP_EOL;
             echo $content;
         }
 
     }//end processSniff()
 
 
+    /**
+     * Transform a title to a string which can be used as an HTML anchor.
+     *
+     * @param string $title The title.
+     *
+     * @since 3.12.0
+     *
+     * @return string
+     */
+    private function titleToAnchor($title)
+    {
+        return str_replace(' ', '-', $title);
+
+    }//end titleToAnchor()
+
+
     /**
      * Print a text block found in a standard.
      *