3 namespace Friendica\Module;
5 use Friendica\BaseModule;
6 use Friendica\Content\Nav;
7 use Friendica\Content\Text\Markdown;
8 use Friendica\Core\L10n;
9 use Friendica\Network\HTTPException;
10 use Friendica\Util\Strings;
13 * Shows the friendica help based on the /doc/ directory
15 class Help extends BaseModule
17 public static function content()
19 Nav::setSelected('help');
24 $app = self::getApp();
25 $config = $app->getConfig();
26 $lang = $config->get('system', 'language');
28 // @TODO: Replace with parameter from router
31 // looping through the argv keys bigger than 0 to build
32 // a path relative to /help
33 for ($x = 1; $x < $app->argc; $x ++) {
38 $path .= $app->getArgumentValue($x);
40 $title = basename($path);
42 $text = self::loadDocFile('doc/' . $path . '.md', $lang);
43 $app->page['title'] = L10n::t('Help:') . ' ' . str_replace('-', ' ', Strings::escapeTags($title));
46 $home = self::loadDocFile('doc/Home.md', $lang);
50 $app->page['title'] = L10n::t('Help');
52 $app->page['aside'] = Markdown::convert($home, false);
56 throw new HTTPException\NotFoundException();
59 $html = Markdown::convert($text, false);
61 if ($filename !== "Home") {
62 // create TOC but not for home
63 $lines = explode("\n", $html);
64 $toc = "<h2>TOC</h2><ul id='toc'>";
66 $idNum = [0, 0, 0, 0, 0, 0, 0];
67 foreach ($lines as &$line) {
68 if (substr($line, 0, 2) == "<h") {
69 $level = substr($line, 2, 1);
71 $level = intval($level);
72 if ($level < $lastLevel) {
73 for ($k = $level; $k < $lastLevel; $k++) {
77 for ($k = $level + 1; $k < count($idNum); $k++) {
82 if ($level > $lastLevel) {
87 $id = implode("_", array_slice($idNum, 1, $level));
88 $href = $app->getBaseURL() . "/help/{$filename}#{$id}";
89 $toc .= "<li><a href='{$href}'>" . strip_tags($line) . "</a></li>";
90 $line = "<a name='{$id}'></a>" . $line;
96 for ($k = 0; $k < $lastLevel; $k++) {
100 $html = implode("\n", $lines);
102 $a->page['aside'] = '<div class="help-aside-wrapper widget"><div id="toc-wrapper">' . $toc . '</div>' . $a->page['aside'] . '</div>';
108 private static function loadDocFile($fileName, $lang = 'en')
110 $baseName = basename($fileName);
111 $dirName = dirname($fileName);
112 if (file_exists("$dirName/$lang/$baseName")) {
113 return file_get_contents("$dirName/$lang/$baseName");
116 if (file_exists($fileName)) {
117 return file_get_contents($fileName);