]> git.mxchange.org Git - friendica.git/blobdiff - mod/help.php
Move credits out of util/
[friendica.git] / mod / help.php
index 44edbf931861133e0b7a9a853ca4473f9b280ccb..3a21695b090f05ee4f4170620ae22be8078f70d0 100644 (file)
 <?php
-define( 'MARKDOWN_PARSER_CLASS',  'ExtendedMarkdown' );
-require_once('library/markdown.php');
-
-class ExtendedMarkdown extends MarkdownExtra_Parser {
-
-       function ExtendedMarkdown() {
-               $this->block_gamut += array(
-                       "doBlockWarning" => 45,
-               );
-               parent::MarkdownExtra_Parser();
+/**
+ * @file mod/help.php
+ */
+
+use Friendica\App;
+use Friendica\Content\Nav;
+use Friendica\Content\Text\Markdown;
+use Friendica\Core\Config;
+use Friendica\Core\L10n;
+use Friendica\Core\Renderer;
+use Friendica\Core\System;
+use Friendica\Util\Strings;
+
+function load_doc_file($s)
+{
+       $lang = Config::get('system', 'language');
+       $b = basename($s);
+       $d = dirname($s);
+       if (file_exists("$d/$lang/$b")) {
+               return file_get_contents("$d/$lang/$b");
        }
 
-       function doBlockWarning($text) {
-               $text = preg_replace_callback('/
-                         (                                                             # Wrap whole match in $1
-                               (?>
-                                 ^[ ]*![ ]?                            # "!" at the start of a line
-                                       .+\n                                    # rest of the first line
-                                 (.+\n)*                                       # subsequent consecutive lines
-                                 \n*                                           # blanks
-                               )+
-                         )
-                       /xm', array(&$this, '_doBlockWarning_callback'), $text);
-
-               return $text;
-       }
-
-       function _doBlockWarning_callback($matches) {
-               $bq = $matches[1];
-               # trim one level of quoting - trim whitespace-only lines
-               $bq = preg_replace('/^[ ]*![ ]?|^[ ]+$/m', '', $bq);
-               $bq = $this->runBlockGamut($bq);  # recurse
-
-               $bq = preg_replace('/^/m', "  ", $bq);
-               # These leading spaces cause problem with <pre> content, 
-               # so we need to fix that:
-//             $bq = preg_replace_callback('{(\s*<pre>.+?</pre>)}sx', array(&$this, '__doBlockWarning_callback2'), $bq);
-
-               return "\n" . $this->hashBlock("<div class='md_warning'>\n$bq\n</div>") . "\n\n";
-       }
-
-       function _doBlockWarning_callback2($matches) {
-               $pre = $matches[1];
-               $pre = preg_replace('/^  /m', '', $pre);
-               return $pre;
+       if (file_exists($s)) {
+               return file_get_contents($s);
        }
 
+       return '';
 }
 
-if (!function_exists('load_doc_file')) {
-
-       function load_doc_file($s) {
-               global $lang;
-               if (!isset($lang))
-                       $lang = 'en';
-               $b = basename($s);
-               $d = dirname($s);
-               if (file_exists("$d/$lang/$b"))
-                       return file_get_contents("$d/$lang/$b");
-               if (file_exists($s))
-                       return file_get_contents($s);
-               return '';
-       }
-
-}
-
-function help_content(&$a) {
-       
-       
-       nav_set_selected('help');
-
-       global $lang;
+function help_content(App $a)
+{
+       Nav::setSelected('help');
 
        $text = '';
 
        if ($a->argc > 1) {
-               $text = load_doc_file('doc/' . $a->argv[1] . '.md');
-               $a->page['title'] = t('Help:') . ' ' . str_replace('-', ' ', notags($a->argv[1]));
+               $path = '';
+               // looping through the argv keys bigger than 0 to build
+               // a path relative to /help
+               for ($x = 1; $x < $a->argc; $x ++) {
+                       if (strlen($path)) {
+                               $path .= '/';
+                       }
+
+                       $path .= $a->getArgumentValue($x);
+               }
+               $title = basename($path);
+               $filename = $path;
+               $text = load_doc_file('doc/' . $path . '.md');
+               $a->page['title'] = L10n::t('Help:') . ' ' . str_replace('-', ' ', Strings::escapeTags($title));
        }
+
        $home = load_doc_file('doc/Home.md');
        if (!$text) {
                $text = $home;
-               $a->page['title'] = t('Help');
+               $filename = "Home";
+               $a->page['title'] = L10n::t('Help');
        } else {
-               $a->page['aside'] = Markdown($home);
+               $a->page['aside'] = Markdown::convert($home, false);
        }
 
        if (!strlen($text)) {
-               header($_SERVER["SERVER_PROTOCOL"] . ' 404 ' . t('Not Found'));
-               $tpl = get_markup_template("404.tpl");
-               return replace_macros($tpl, array(
-                                       '$message' => t('Page not found.')
-                               ));
+               header($_SERVER["SERVER_PROTOCOL"] . ' 404 ' . L10n::t('Not Found'));
+               $tpl = Renderer::getMarkupTemplate("404.tpl");
+               return Renderer::replaceMacros($tpl, [
+                       '$message' => L10n::t('Page not found.')
+               ]);
+       }
+
+       $html = Markdown::convert($text, false);
+
+       if ($filename !== "Home") {
+               // create TOC but not for home
+               $lines = explode("\n", $html);
+               $toc = "<h2>TOC</h2><ul id='toc'>";
+               $lastlevel = 1;
+               $idnum = [0, 0, 0, 0, 0, 0, 0];
+               foreach ($lines as &$line) {
+                       if (substr($line, 0, 2) == "<h") {
+                               $level = substr($line, 2, 1);
+                               if ($level != "r") {
+                                       $level = intval($level);
+                                       if ($level < $lastlevel) {
+                                               for ($k = $level; $k < $lastlevel; $k++) {
+                                                       $toc .= "</ul>";
+                                               }
+
+                                               for ($k = $level + 1; $k < count($idnum); $k++) {
+                                                       $idnum[$k] = 0;
+                                               }
+                                       }
+
+                                       if ($level > $lastlevel) {
+                                               $toc .= "<ul>";
+                                       }
+
+                                       $idnum[$level] ++;
+                                       $id = implode("_", array_slice($idnum, 1, $level));
+                                       $href = System::baseUrl() . "/help/{$filename}#{$id}";
+                                       $toc .= "<li><a href='{$href}'>" . strip_tags($line) . "</a></li>";
+                                       $line = "<a name='{$id}'></a>" . $line;
+                                       $lastlevel = $level;
+                               }
+                       }
+               }
+
+               for ($k = 0; $k < $lastlevel; $k++) {
+                       $toc .= "</ul>";
+               }
+
+               $html = implode("\n", $lines);
+
+               $a->page['aside'] = '<div class="help-aside-wrapper widget"><div id="toc-wrapper">' . $toc . '</div>' . $a->page['aside'] . '</div>';
        }
-       
-       $html = Markdown($text);
-       $html = "<style>.md_warning { padding: 1em; border: #ff0000 solid 2px; background-color: #f9a3a3; color: #ffffff;</style>".$html;
+
        return $html;
-               
 }