Add Markdown output format for PHP documentation

.github/workflows/full_render_doc-en_test.yml

@@ -26,4 +26,4 @@ jobs:
         run: "php doc-base/configure.php --disable-libxml-check --enable-xml-details --redirect-stderr-to-stdout"
 
       - name: "Render documentation for doc-en"
-        run: "php phd/render.php --docbook doc-base/.manual.xml --package PHP --format xhtml --format bigxhtml --format php --format tocfeed --forceindex --output output"
+        run: "php phd/render.php --docbook doc-base/.manual.xml --package PHP --format xhtml --format bigxhtml --format php --format tocfeed --format markdown --forceindex --output output"

phpdotnet/phd/PI/MarkdownPHPDOCHandler.php

@@ -0,0 +1,26 @@
+<?php
+namespace phpdotnet\phd;
+
+class PI_MarkdownPHPDOCHandler extends PI_PHPDOCHandler {
+
+    protected function generateChangelogMarkup($changelogs): string {
+        usort($changelogs, [PI_PHPDOCHandler::class, '_sortByVersion']);
+
+        $ret = "| Version | Function | Description |\n| --- | --- | --- |\n";
+        $desc = "";
+        $lastVersion = "";
+        foreach ($changelogs as $entry) {
+            if (!$this->_changelogSince || version_compare($entry["version"], $this->_changelogSince) >= 0) {
+                $link    = $this->format->createLink($entry["docbook_id"], $desc);
+                $version = ($entry["version"] === $lastVersion) ? "" : $entry["version"];
+                $description = html_entity_decode($entry["description"], ENT_QUOTES | ENT_HTML5, 'UTF-8');
+                $description = preg_replace('/\s+/', ' ', trim($description));
+                $description = str_replace('|', '\\|', $description);
+                $ret    .= sprintf("| %s | [%s](%s) | %s |\n", $version, $desc, $link, $description);
+                $lastVersion = $entry["version"];
+            }
+        }
+        $this->_changelogSince = null;
+        return $ret;
+    }
+}

phpdotnet/phd/Package/PHP/Factory.php

@@ -13,6 +13,7 @@ class Package_PHP_Factory extends Format_Factory {
         'tocfeed'       => 'Package_PHP_TocFeed',
         'epub'          => 'Package_PHP_Epub',
         'enhancedchm'   => 'Package_PHP_EnhancedCHM',
+        'markdown'      => 'Package_PHP_Markdown',
     );
 
     /**