version 2.0.1 84b42ab

2025-11-07 16:36:42 +08:00 · 2014-12-22 16:33:27 +08:00
commit 1468bd4d3d
1949 changed files with 275476 additions and 0 deletions
--- a/extensions/apidoc/helpers/IndexFileAnalyzer.php
+++ b/extensions/apidoc/helpers/IndexFileAnalyzer.php
@ -0,0 +1,85 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\apidoc\helpers;
+
+use cebe\markdown\Markdown;
+
+/**
+ * IndexFileAnalyzer analyzes index file with TOC. Typically README.md.
+ */
+class IndexFileAnalyzer extends Markdown
+{
+    public $title;
+    public $introduction;
+
+    private $_chapter = 0;
+    private $_chapters = [];
+
+
+    /**
+     * Parses text and returns list of chapters got from it
+     * @param string $text
+     * @return array
+     */
+    public function analyze($text)
+    {
+        $this->parse($text);
+
+        return $this->_chapters;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function renderHeadline($block)
+    {
+        if ($this->_chapter === 0) {
+            $this->title = $this->renderAbsy($block['content']);
+            $this->introduction = '';
+            $this->_chapter++;
+        } else {
+            $this->_chapter++;
+            $this->_chapters[$this->_chapter] = [
+                'headline' => $this->renderAbsy($block['content']),
+                'content' => [],
+            ];
+        }
+        return parent::renderHeadline($block);
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function renderParagraph($block)
+    {
+        if ($this->_chapter < 1) {
+            $this->introduction .= $this->renderAbsy($block['content']);
+        }
+        return parent::renderParagraph($block);
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function renderList($block)
+    {
+        if ($this->_chapter > 0) {
+            foreach ($block['items'] as $item => $absyElements) {
+                foreach($absyElements as $element) {
+                    if ($element[0] === 'link') {
+                        $this->_chapters[$this->_chapter]['content'][] = [
+                            'headline' => $this->renderAbsy($element['text']),
+                            'file' => $element['url'],
+                        ];
+                    }
+                }
+            }
+        }
+        return parent::renderList($block);
+    }
+}