tyler.durden
/
icingaweb2
mirror of https://github.com/Icinga/icingaweb2.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Doc: Construct parser with the path to the documentation 

Before, the parser decided which path to used based on a given module name.
Now, the parser requires the path to the documentation.
Further the toc items no longer include a URL. The must URL must be generated
from a render function or view script.

refs #4820
This commit is contained in:
Eric Lippmann 2014-05-27 14:31:17 +02:00
parent b58ec5f445
commit 6ce739e23d
1 changed files with 22 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
modules/doc/library/Doc/DocParser.php
View File

@ -9,7 +9,7 @@ require_once 'vendor/Parsedown/Parsedown.php';
use RecursiveIteratorIterator;
use RecursiveDirectoryIterator;
use Parsedown;
use Icinga\Application\Icinga;
use Icinga\Exception\NotReadableError;
use Icinga\Web\Menu;
use Icinga\Web\Url;
@ -18,36 +18,30 @@ use Icinga\Web\Url;
*/
class DocParser
{
protected $dir;
protected $module;
/**
* Path to the documentation
*
* @var string
*/
protected $path;
/**
* Create a new documentation parser for the given module or the application
* Create a new documentation parser for the given path
*
* @param string $module
* @param string $path Path to the documentation
*
* @throws DocException
* @throws NotReadableError
*/
public function __construct($module = null)
public function __construct($path)
{
if ($module === null) {
$dir = Icinga::app()->getApplicationDir('/../doc');
} else {
$mm = Icinga::app()->getModuleManager();
if (! $mm->hasInstalled($module)) {
throw new DocException('Module is not installed');
}
if (! $mm->hasEnabled($module)) {
throw new DocException('Module is not enabled');
}
$dir = $mm->getModuleDir($module, '/doc');
if (! is_dir($path)) {
throw new DocException('Doc directory `' . $path .'\' does not exist');
}
if (! is_dir($dir)) {
throw new DocException('Doc directory `' . $dir .'\' does not exist');
if (! is_readable($path)) {
throw new NotReadableError('Doc directory `' . $path .'\' is not readable');
}
$this->dir = $dir;
$this->module = $module;
$this->path = $path;
}
/**
@ -60,7 +54,7 @@ class DocParser
{
$iter = new RecursiveIteratorIterator(
new MarkdownFileIterator(
new RecursiveDirectoryIterator($this->dir)
new RecursiveDirectoryIterator($this->path)
)
);
$fileInfos = iterator_to_array($iter);
@ -89,7 +83,7 @@ class DocParser
if ($header !== null) {
list($header, $level) = $header;
$id = $this->extractHeaderId($header);
$attribs = array();
$nofollow = false;
$this->reduceToc($toc, $level);
if ($id === null) {
$path = array();
@ -98,20 +92,16 @@ class DocParser
}
$path[] = $header;
$id = implode('-', $path);
$attribs['rel'] = 'nofollow';
$nofollow = true;
}
$id = urlencode(str_replace('.', '.', strip_tags($id)));
$item = end($toc)->item->addChild(
$id,
array(
// TODO(el): URL should be generated from a route else we always have to adapt the
// URL here when we change URLs
'url' => Url::fromPath(
$this->module === null ? 'doc/icingaweb' : 'doc/module/' . $this->module
)->setAnchor($id)->getRelativeUrl(),
'title' => htmlspecialchars($header),
'id' => $id,
'title' => $header,
'priority' => $itemPriority++, // Post-increment is on purpose
'attribs' => $attribs
'nofollow' => $nofollow
)
);
$toc[] = ((object) array(