You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
111 lines
4.2 KiB
111 lines
4.2 KiB
10 years ago
|
<?php
|
||
|
/**
|
||
|
* Created by PhpStorm.
|
||
|
* User: cebe
|
||
|
* Date: 28.05.14
|
||
|
* Time: 15:30
|
||
|
*/
|
||
|
|
||
|
namespace yii\apidoc\helpers;
|
||
|
|
||
|
use phpDocumentor\Reflection\DocBlock\Type\Collection;
|
||
|
use yii\apidoc\models\MethodDoc;
|
||
|
use yii\apidoc\models\TypeDoc;
|
||
|
|
||
|
/**
|
||
|
* Class ApiMarkdownTrait
|
||
|
*
|
||
|
* @property TypeDoc $context
|
||
|
*/
|
||
|
trait ApiMarkdownTrait
|
||
|
{
|
||
|
protected function parseApiLinks($text)
|
||
|
{
|
||
|
$context = $this->context;
|
||
|
|
||
|
if (preg_match('/^\[\[([\w\d\\\\\(\):$]+)(\|[^\]]*)?\]\]/', $text, $matches)) {
|
||
|
|
||
|
$offset = strlen($matches[0]);
|
||
|
|
||
|
$object = $matches[1];
|
||
|
$title = (empty($matches[2]) || $matches[2] == '|') ? null : substr($matches[2], 1);
|
||
|
|
||
|
if (($pos = strpos($object, '::')) !== false) {
|
||
|
$typeName = substr($object, 0, $pos);
|
||
|
$subjectName = substr($object, $pos + 2);
|
||
|
if ($context !== null) {
|
||
|
// Collection resolves relative types
|
||
|
$typeName = (new Collection([$typeName], $context->phpDocContext))->__toString();
|
||
|
}
|
||
|
$type = static::$renderer->apiContext->getType($typeName);
|
||
|
if ($type === null) {
|
||
|
static::$renderer->apiContext->errors[] = [
|
||
|
'file' => ($context !== null) ? $context->sourceFile : null,
|
||
|
'message' => 'broken link to ' . $typeName . '::' . $subjectName . (($context !== null) ? ' in ' . $context->name : ''),
|
||
|
];
|
||
|
|
||
|
return [
|
||
|
'<span style="background: #f00;">' . $typeName . '::' . $subjectName . '</span>',
|
||
|
$offset
|
||
|
];
|
||
|
} else {
|
||
|
if (($subject = $type->findSubject($subjectName)) !== null) {
|
||
|
if ($title === null) {
|
||
|
$title = $type->name . '::' . $subject->name;
|
||
|
if ($subject instanceof MethodDoc) {
|
||
|
$title .= '()';
|
||
|
}
|
||
|
}
|
||
|
|
||
|
return [
|
||
|
static::$renderer->createSubjectLink($subject, $title),
|
||
|
$offset
|
||
|
];
|
||
|
} else {
|
||
|
static::$renderer->apiContext->errors[] = [
|
||
|
'file' => ($context !== null) ? $context->sourceFile : null,
|
||
|
'message' => 'broken link to ' . $type->name . '::' . $subjectName . (($context !== null) ? ' in ' . $context->name : ''),
|
||
|
];
|
||
|
|
||
|
return [
|
||
|
'<span style="background: #ff0;">' . $type->name . '</span><span style="background: #f00;">::' . $subjectName . '</span>',
|
||
|
$offset
|
||
|
];
|
||
|
}
|
||
|
}
|
||
|
} elseif ($context !== null && ($subject = $context->findSubject($object)) !== null) {
|
||
|
return [
|
||
|
static::$renderer->createSubjectLink($subject, $title),
|
||
|
$offset
|
||
|
];
|
||
|
}
|
||
|
|
||
|
if ($context !== null) {
|
||
|
// Collection resolves relative types
|
||
|
$object = (new Collection([$object], $context->phpDocContext))->__toString();
|
||
|
}
|
||
|
if (($type = static::$renderer->apiContext->getType($object)) !== null) {
|
||
|
return [
|
||
|
static::$renderer->createTypeLink($type, null, $title),
|
||
|
$offset
|
||
|
];
|
||
|
} elseif (strpos($typeLink = static::$renderer->createTypeLink($object, null, $title), '<a href') !== false) {
|
||
|
return [
|
||
|
$typeLink,
|
||
|
$offset
|
||
|
];
|
||
|
}
|
||
|
static::$renderer->apiContext->errors[] = [
|
||
|
'file' => ($context !== null) ? $context->sourceFile : null,
|
||
|
'message' => 'broken link to ' . $object . (($context !== null) ? ' in ' . $context->name : ''),
|
||
|
];
|
||
|
|
||
|
return [
|
||
|
'<span style="background: #f00;">' . $object . '</span>',
|
||
|
$offset
|
||
|
];
|
||
|
}
|
||
|
|
||
|
return ['[[', 2];
|
||
|
}
|
||
|
}
|