Skip to content

Y
yii2
Commit fca81434 by Carsten Brandt
Options

Improved guide and api doc header and titles

fixes #7069 fixes #7031
parent 4e39381d
Showing with 22 additions and 7 deletions
extensions/apidoc/templates/bootstrap/layouts/api.php
......@@ -11,7 +11,7 @@ use yii\helpers\StringHelper;
/** @var $renderer ApiRenderer */
$renderer = $this->context;
$this->beginContent('@yii/apidoc/templates/bootstrap/layouts/main.php'); ?>
$this->beginContent('@yii/apidoc/templates/bootstrap/layouts/main.php', isset($type) ? ['type' => $type] : []); ?>
<div class="row">
<div class="col-md-3">
......
extensions/apidoc/templates/bootstrap/layouts/guide.php
......@@ -6,7 +6,17 @@ use yii\apidoc\templates\bootstrap\SideNavWidget;
/* @var $content string */
/* @var $chapters array */
$this->beginContent('@yii/apidoc/templates/bootstrap/layouts/main.php'); ?>
if (isset($currentFile)) {
foreach ($chapters as $chapter) {
foreach ($chapter['content'] as $chContent) {
if ($chContent['file'] == basename($currentFile)) {
$guideHeadline = "{$chContent['headline']} - {$chapter['headline']}";
}
}
}
}
$this->beginContent('@yii/apidoc/templates/bootstrap/layouts/main.php', isset($guideHeadline) ? ['guideHeadline' => $guideHeadline] : []); ?>
<div class="row">
<div class="col-md-2">
......
extensions/apidoc/templates/bootstrap/layouts/main.php
......@@ -3,6 +3,7 @@
use yii\bootstrap\Nav;
use yii\bootstrap\NavBar;
use yii\helpers\Html;
use yii\helpers\StringHelper;
/* @var $this yii\web\View */
......@@ -29,7 +30,14 @@ $this->beginPage();
<meta name="language" content="en" />
<?= Html::csrfMetaTags() ?>
<?php $this->head() ?>
<title><?= Html::encode($this->context->pageTitle) ?></title>
<title><?php if (isset($type)) {
echo Html::encode(StringHelper::basename($type->name) . ", {$type->name} - {$this->context->pageTitle}");
} elseif (isset($guideHeadline)) {
echo Html::encode("$guideHeadline - {$this->context->pageTitle}");
} else {
echo Html::encode($this->context->pageTitle);
}
?></title>
</head>
<body>
......
extensions/apidoc/templates/html/ApiRenderer.php
......@@ -102,9 +102,7 @@ class ApiRenderer extends BaseApiRenderer implements ViewContextInterface
Console::startProgress(0, $typeCount, 'Rendering files: ', false);
}
$done = 0;
$oldTitle = $this->pageTitle;
foreach ($types as $type) {
$this->pageTitle = StringHelper::basename($type->name) . ", {$type->name} - $oldTitle";
$fileContent = $this->renderWithLayout($this->typeView, [
'type' => $type,
'apiContext' => $context,
......@@ -116,7 +114,6 @@ class ApiRenderer extends BaseApiRenderer implements ViewContextInterface
Console::updateProgress(++$done, $typeCount);
}
}
$this->pageTitle = $oldTitle;
$indexFileContent = $this->renderWithLayout($this->indexView, [
'apiContext' => $context,
......
extensions/apidoc/templates/html/GuideRenderer.php
......@@ -43,7 +43,7 @@ abstract class GuideRenderer extends BaseGuideRenderer
parent::init();
if ($this->pageTitle === null) {
$this->pageTitle = 'Yii Framework 2.0 API Documentation'; // TODO guess page title
$this->pageTitle = 'The Definitive Guide to Yii 2.0';
}
}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment