GuideRenderer.php 2.67 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
<?php
/**
 * @link http://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license http://www.yiiframework.com/license/
 */

namespace yii\apidoc\templates\bootstrap;
use yii\apidoc\helpers\ApiMarkdown;
use yii\apidoc\models\ClassDoc;
use yii\apidoc\models\ConstDoc;
use yii\apidoc\models\Context;
use yii\apidoc\models\EventDoc;
use yii\apidoc\models\InterfaceDoc;
use yii\apidoc\models\MethodDoc;
use yii\apidoc\models\PropertyDoc;
use yii\apidoc\models\TraitDoc;
use yii\console\Controller;
use Yii;
use yii\helpers\Console;
use yii\helpers\Html;

/**
 *
 * @author Carsten Brandt <mail@cebe.cc>
 * @since 2.0
 */
class GuideRenderer extends \yii\apidoc\templates\html\GuideRenderer
{
	public $layout = '@yii/apidoc/templates/bootstrap/layouts/guide.php';

	public $extensions = [
		'apidoc',
		'authclient',
		'bootstrap',
		'codeception',
		'composer',
		'debug',
		'elasticsearch',
		'faker',
		'gii',
		'imagine',
		'jui',
		'mongodb',
		'redis',
		'smarty',
		'sphinx',
		'swiftmailer',
		'twig',
	];
//
//	/**
//	 * Renders a given [[Context]].
//	 *
//	 * @param Controller $controller the apidoc controller instance. Can be used to control output.
//	 */
//	public function renderMarkdownFiles($controller)
//	{
//		$files = $this->markDownFiles;
//		$dir = Yii::getAlias($this->targetDir);
//		if (!is_dir($dir)) {
//			mkdir($dir, 0777, true);
//		}
//
//		ApiMarkdown::$renderer = $this;
//
//		$fileCount = count($files) + 1;
//		Console::startProgress(0, $fileCount, 'Rendering markdown files: ', false);
//		$done = 0;
//		$fileData = [];
//		$headlines = [];
//		foreach($files as $file) {
//			$fileData[$file] = file_get_contents($file);
//			if (basename($file) == 'index.md') {
//				continue; // to not add index file to nav
//			}
//			if (preg_match("/^(.*)\n=+/", $fileData[$file], $matches)) {
//				$headlines[$file] = $matches[1];
//			} else {
//				$headlines[$file] = basename($file);
//			}
//		}
//
//		foreach($fileData as $file => $content) {
//			$output = ApiMarkdown::process($content); // TODO generate links to yiiframework.com by default
//			$output = $this->fixMarkdownLinks($output);
//			if ($this->guideLayout !== false) {
//				$params = [
//					'headlines' => $headlines,
//					'currentFile' => $file,
//					'content' => $output,
//				];
//				$output = $this->getView()->renderFile($this->guideLayout, $params, $this);
//			}
//			$fileName = $this->generateGuideFileName($file);
//			file_put_contents($dir . '/' . $fileName, $output);
//			Console::updateProgress(++$done, $fileCount);
//		}
//		Console::updateProgress(++$done, $fileCount);
//		Console::endProgress(true);
//		$controller->stdout('done.' . PHP_EOL, Console::FG_GREEN);
//	}
//

}