Feature: fenced code blocks

Fixes #98

Author: michalbundyra

build.sh

@@ -75,6 +75,10 @@ php ${SCRIPT_PATH}/table_responsive.php ${DOC_DIR}
 echo "Fixing pipes in tables"
 php ${SCRIPT_PATH}/table_fix_pipes.php ${DOC_DIR}
 
+# Fix fenced code blocks
+echo "Fixing fenced code blocks"
+php ${SCRIPT_PATH}/fenced_code.php ${DOC_DIR}
+
 # Replace landing page content
 if [ -e .zf-mkdoc-theme-landing ]; then
     echo "Replacing landing page content"

fenced_code.php

@@ -0,0 +1,50 @@
+<?php
+/**
+ * @license   http://opensource.org/licenses/BSD-3-Clause BSD-3-Clause
+ * @copyright Copyright (c) 2019 Zend Technologies USA Inc. (https://www.zend.com)
+ */
+
+$docPath = isset($argv[1]) ? $argv[1] : 'doc';
+$docPath = sprintf('%s/%s', getcwd(), $docPath);
+$docPath = realpath($docPath);
+
+$rdi = new RecursiveDirectoryIterator($docPath . '/html');
+$rii = new RecursiveIteratorIterator($rdi, RecursiveIteratorIterator::SELF_FIRST);
+$files = new RegexIterator($rii, '/\.html$/', RecursiveRegexIterator::GET_MATCH);
+
+$process = static function () use ($files) {
+    $fileInfo = $files->getInnerIterator()->current();
+    if (! $fileInfo->isFile()) {
+        return true;
+    }
+
+    if ($fileInfo->getBasename('.html') === $fileInfo->getBasename()) {
+        return true;
+    }
+
+    $file = $fileInfo->getRealPath();
+    $html = file_get_contents($file);
+
+    if (preg_match_all('#<p>(?:<code>|```)([a-z]+)(\n.*?)(?:</code>|```)</p>#s', $html, $matches)) {
+        foreach ($matches[0] as $i => $content) {
+            $code = strtr($matches[2][$i], [
+                '<p>' => '',
+                '</p>' => '',
+                '<' => '&lt;',
+                '>' => '&gt;',
+            ]);
+
+            $html = str_replace(
+                $content,
+                '<p><pre class=codehilite><code class=language-' . $matches[1][$i] . '>' . $code . '</code></pre></p>',
+                $html
+            );
+        }
+    }
+
+    file_put_contents($file, $html);
+
+    return true;
+};
+
+iterator_apply($files, $process);