Abstract Class yii\apidoc\renderers\BaseRenderer

All Classes | Properties | Methods | Constants

Inheritance	yii\apidoc\renderers\BaseRenderer » yii\base\Component
Subclasses	yii\apidoc\renderers\ApiRenderer, yii\apidoc\renderers\GuideRenderer, yii\apidoc\templates\bootstrap\ApiRenderer, yii\apidoc\templates\bootstrap\GuideRenderer, yii\apidoc\templates\html\ApiRenderer, yii\apidoc\templates\html\GuideRenderer, yii\apidoc\templates\json\ApiRenderer, yii\apidoc\templates\online\ApiRenderer, yii\apidoc\templates\pdf\GuideRenderer
Available since extension's version	2.0
Source Code	https://github.com/yiisoft/yii2-apidoc/blob/master/renderers/BaseRenderer.php

Base class for all documentation renderers

Public Properties

Hide inherited properties

Property	Type	Description	Defined By
$apiContext	yii\apidoc\models\Context	The yii\apidoc\models\Context currently being rendered.	yii\apidoc\renderers\BaseRenderer
$apiUrl			yii\apidoc\renderers\BaseRenderer
$controller	\yii\console\Controller	The apidoc controller instance.	yii\apidoc\renderers\BaseRenderer
$guidePrefix			yii\apidoc\renderers\BaseRenderer
$guideUrl			yii\apidoc\renderers\BaseRenderer
$pageTitle	string	String to use as the title of the generated page.	yii\apidoc\renderers\BaseRenderer

Public Methods

Hide inherited methods

Method	Description	Defined By
createSubjectLink()	Creates a link to a subject	yii\apidoc\renderers\BaseRenderer
createTypeLink()	Creates a link to a type (class, interface or trait)	yii\apidoc\renderers\BaseRenderer
generateApiUrl()	Generate an url to a type in apidocs	yii\apidoc\renderers\BaseRenderer
generateGuideUrl()	Generate an url to a guide page	yii\apidoc\renderers\BaseRenderer
init()		yii\apidoc\renderers\BaseRenderer

Protected Methods

Hide inherited methods

Method	Description	Defined By
generateLink()	Generate link markup	yii\apidoc\renderers\BaseRenderer

Constants

Hide inherited constants

Constant	Value	Description	Defined By
GUIDE_PREFIX	'guide-'	Deprecated since 2.0.1 use $guidePrefix instead which allows configuring this options	yii\apidoc\renderers\BaseRenderer

Property Details

Hide inherited properties

$apiContext public property

The yii\apidoc\models\Context currently being rendered.

public yii\apidoc\models\Context $apiContext = null

$apiUrl public property

public $apiUrl = null

$controller public property

The apidoc controller instance. Can be used to control output.

public \yii\console\Controller $controller = null

$guidePrefix public property

public $guidePrefix = 'guide-'

$guideUrl public property

public $guideUrl = null

$pageTitle public property

String to use as the title of the generated page.

public string $pageTitle = null

Method Details

Hide inherited methods

createSubjectLink() public method

Creates a link to a subject

public string createSubjectLink ( $subject, string $title = null, array $options = [] )
$subject	yii\apidoc\models\PropertyDoc\|yii\apidoc\models\MethodDoc\|yii\apidoc\models\ConstDoc\|yii\apidoc\models\EventDoc
$title	string\|null
$options	array	Additional HTML attributes for the link.

Source code

                public function createSubjectLink($subject, string $title = null, array $options = []): string
{
    if ($title === null) {
        $title = $subject->shortName;
    }
    if (($type = $this->apiContext->getType($subject->definedBy)) === null) {
        return $subject->shortName;
    }
    $link = $this->generateApiUrl($type->name) . '#' . $subject->shortName . '-detail';
    return $this->generateLink($title, $link, $options);
}

createTypeLink() public method

Creates a link to a type (class, interface or trait)

public string createTypeLink ( $types, $context = null, $title = null, $options = [] )
$types	yii\apidoc\models\ClassDoc\|yii\apidoc\models\InterfaceDoc\|yii\apidoc\models\TraitDoc\|yii\apidoc\models\ClassDoc[]\|yii\apidoc\models\InterfaceDoc[]\|yii\apidoc\models\TraitDoc[]\|string\|string[]
$context	yii\apidoc\models\BaseDoc
$title	string	A title to be used for the link TODO check whether [[yii...\|Class]] is supported
$options	array	Additional HTML attributes for the link.

Source code

                public function createTypeLink($types, $context = null, $title = null, $options = [])
{
    if (!is_array($types)) {
        $types = [$types];
    }
    if (count($types) > 1) {
        $title = null;
    }
    $links = [];
    foreach ($types as $type) {
        $postfix = '';
        if (is_string($type)) {
            if (!empty($type) && substr_compare($type, '[]', -2, 2) === 0) {
                $postfix = '[]';
                $type = substr($type, 0, -2);
            }
            if ($type === '$this' && $context instanceof TypeDoc) {
                $title = '$this';
                $type = $context;
            } elseif (($t = $this->apiContext->getType(ltrim($type, '\\'))) !== null) {
                $type = $t;
            } elseif (!empty($type) && $type[0] !== '\\' && ($t = $this->apiContext->getType($this->resolveNamespace($context) . '\\' . ltrim($type, '\\'))) !== null) {
                $type = $t;
            } else {
                ltrim($type, '\\');
            }
        }
        if (is_object($type) && \method_exists($type, '__toString')) {
            $type = (string)$type;
        }
        if (is_string($type)) {
            $linkText = ltrim($type, '\\');
            if ($title !== null) {
                $linkText = $title;
                $title = null;
            }
            $phpTypes = [
                'callable',
                'array',
                'string',
                'boolean',
                'bool',
                'integer',
                'int',
                'float',
                'object',
                'resource',
                'null',
                'false',
                'true',
            ];
            $phpTypeAliases = [
                'true' => 'boolean',
                'false' => 'boolean',
                'bool' => 'boolean',
                'int' => 'integer',
            ];
            $phpTypeDisplayAliases = [
                'bool' => 'boolean',
                'int' => 'integer',
            ];
            // check if it is PHP internal class
            if (((class_exists($type, false) || interface_exists($type, false) || trait_exists($type, false)) &&
                ($reflection = new \ReflectionClass($type)) && $reflection->isInternal())) {
                $links[] = $this->generateLink($linkText, 'https://www.php.net/class.' . strtolower(ltrim($type, '\\')), $options) . $postfix;
            } elseif (in_array($type, $phpTypes)) {
                if (isset($phpTypeDisplayAliases[$type])) {
                    $linkText = $phpTypeDisplayAliases[$type];
                }
                if (isset($phpTypeAliases[$type])) {
                    $type = $phpTypeAliases[$type];
                }
                $links[] = $this->generateLink($linkText, 'https://www.php.net/language.types.' . strtolower(ltrim($type, '\\')), $options) . $postfix;
            } else {
                $links[] = $type . $postfix;
            }
        } elseif ($type instanceof BaseDoc) {
            $linkText = $type->name;
            if ($title !== null) {
                $linkText = $title;
                $title = null;
            }
            $links[] = $this->generateLink($linkText, $this->generateApiUrl($type->name), $options) . $postfix;
        }
    }
    return implode('|', $links);
}

generateApiUrl() public abstract method

Generate an url to a type in apidocs

public abstract mixed generateApiUrl ( $typeName )
$typeName

Source code

                abstract public function generateApiUrl($typeName);

generateGuideUrl() public method

Generate an url to a guide page

public string generateGuideUrl ( $file )
$file	string

Source code

                public function generateGuideUrl($file)
{
    //skip parsing external url
    if ( (strpos($file, 'https://') !== false) || (strpos($file, 'http://') !== false) ) {
        return $file;
    }
    $hash = '';
    if (($pos = strpos($file, '#')) !== false) {
        $hash = substr($file, $pos);
        $file = substr($file, 0, $pos);
    }
    return rtrim($this->guideUrl, '/') . '/' . $this->guidePrefix . basename($file, '.md') . '.html' . $hash;
}

generateLink() protected abstract method

Generate link markup

protected abstract mixed generateLink ( $text, $href, $options = [] )
$text
$href
$options	array	Additional HTML attributes for the link.

Source code

                abstract protected function generateLink($text, $href, $options = []);

init() public method

public void init ( )

Source code

                public function init()
{
    ApiMarkdown::$renderer = $this;
    ApiMarkdownLaTeX::$renderer = $this;
}