Ошибка при генерации документации

Обсуждение документации второй версии фреймворка. Переводы Cookbook и авторские рецепты.
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Ошибка при генерации документации

Сообщение Stepan Selyuk »

Какое-то время назад (может пару недель) появилась ошибка при генерации документации через apidoc:

Код: Выделить всё

php54 ./yii2-apidoc/apidoc guide "yii2-guide" "yii2.docset/Contents/Resources/Documents/"
TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Updating cross references and backlinks... done.
Searching files to process... done.
Rendering markdown files: 0% (0/83) ETA: n/a   Error: array_unshift() expects parameter 1 to be array, null given
Ошибка происходит где-то в /yii2-apidoc/vendor/cebe/markdown/Parser.php, там есть два места где используется array_unshift($this->context, $...); и первым аргументом передается $this->context, который выставлен в null до вызова этого метода, в файле /yii2-apidoc/helpers/ApiMarkdown.php (метод "process").

Подскажите в чем может быть проблема? Все компоненты обновленные, раньше работало.
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Ошибка при генерации документации

Сообщение samdark »

Воспроизвёл, чиним.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Ошибка при генерации документации

Сообщение samdark »

Готово.
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Спасибо, заработало!
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Теперь появилась другая проблема:

Код: Выделить всё

Handling Yii2 guide, 1st iteration.
TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Updating cross references and backlinks... done.
Searching files to process... done.
Rendering markdown files: done.
generating search index...done.
Publishing images...done.
Handling phpDoc in Yii2 files.
TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Searching files to process... done.
Loading apidoc data from cache... no data available.
Checking for updated files... done.
320 files to update.
Processing files... 28% (91/320) ETA: 52 sec.   2014-06-28T12:33:29+03:00 ERR (3): @method contained invalid contents: ActiveRelationTrait[] all()
Processing files... done.
Updating cross references and backlinks... done.
Rendering files: 25% (81/321) ETA: 26 sec.   Error: Undefined offset: 1
Из-за нее рендер прекращается досрочно.
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Ошибка при генерации документации

Сообщение samdark »

Хм... а что за файлы? У меня нормально с официальным гайдом всё.
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Эта ошибка возникает при генерации api-doc:

Код: Выделить всё

php54 ./apidoc api ./vendor/yiisoft/yii2 "../yii2.docset/Contents/Resources/Documents/"
TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Searching files to process... done.
Loading apidoc data from cache... done.
Checking for updated files... done.
0 files to update.
Processing files... done.                 
Updating cross references and backlinks... done.
Rendering files: 25% (81/321) ETA: 17 sec.   Error: Undefined offset: 1
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Ошибка при генерации документации

Сообщение samdark »

Воспроизвели. Правим :)
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Ошибка при генерации документации

Сообщение samdark »

Проверяйте.
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Все сгенерировалось без ошибок, спасибо)
* точнее при генерировании документации было зафиксировано 110 ошибок, но это уже связано с самим phpDocumenter и phpDoc's в файлах.
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Ошибка при генерации документации

Сообщение samdark »

Присылайте pull request с фиксами, если есть время.
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Как будет время, обязательно :)
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Сегодня появилась проблема при генерации документации api:

Код: Выделить всё

TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Searching files to process... done.
Loading apidoc data from cache... no data available.
Checking for updated files... done.
320 files to update.
Processing files... 28% (92/320) ETA: 17 sec.   2014-07-24T16:16:41+03:00 ERR (3): @method contained invalid contents: ActiveRelationTrait[] all()
Processing files... done.
Updating cross references and backlinks... done.
Rendering files: 0% (3/321) ETA: 0 sec.   Error: substr_compare(): The start position cannot exceed initial string length
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Ошибка при генерации документации

Сообщение samdark »

Поправил.
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Спасибо, заработало!
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Сегодня вылезла еще одна ошибка, связанная с обновлением assets management:
Handling Yii2 guide, 1st iteration.
TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Updating cross references and backlinks... done.
Searching files to process... done.
Rendering markdown files: 0% (0/85) ETA: n/a Error: The file or directory to be published does not exist: /Volumes/WebDev HD/dash-docset-yii2/yii2-apidoc/vendor/bower/bootstrap/dist
Handling phpDoc in Yii2 files.
TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Searching files to process... done.
Loading apidoc data from cache... no data available.
Checking for updated files... done.
325 files to update.
Processing files... done.
Updating cross references and backlinks... done.
Rendering files: 0% (0/326) ETA: n/a Error: The file or directory to be published does not exist: /Volumes/WebDev HD/dash-docset-yii2/yii2-apidoc/vendor/bower/bootstrap/dist
Handling Yii2 guide, 2nd iteration (creating links)
TargetDirectory already exists. Overwrite? (yes|no) [yes]:
Loading apidoc data from cache... done.
Updating cross references and backlinks... done.
Searching files to process... done.
Rendering markdown files: 0% (0/85) ETA: n/a Error: The file or directory to be published does not exist: /Volumes/WebDev HD/dash-docset-yii2/yii2-apidoc/vendor/bower/bootstrap/dist
Вроде нужный каталог находится в ./vendor/bower-asset/bootstrap/dist
Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
Stepan Selyuk
Сообщения: 198
Зарегистрирован: 2010.02.03, 05:51
Откуда: Cyprus, Limassol
Контактная информация:

Re: Ошибка при генерации документации

Сообщение Stepan Selyuk »

Сначала невидимое, затем видимое. И так у всех программистов :)
Аватара пользователя
keltstr
Сообщения: 83
Зарегистрирован: 2013.01.12, 23:17

Re: Ошибка при генерации документации

Сообщение keltstr »

Sam Dark писал(а):Поправил.
win7x64, xampp, php5.5.3
Установил через композер apidoc (2014/12/28)
папку c доками закинул прямо в apidoc
делаю так:

Код: Выделить всё

php apidoc guide ./docs ./yii2doc
создается папка yii2doc, а в ней assets и там разные css js и больше ничего.
Оконко консоли закрывается, но ловлю принтскрином ETA n/a
А в логах php - PHP Fatal error: Cannot use yii\web\AssetBundle as AssetBundle because the name is already in use in V:\xampp\htdocs\_projects\xxxx\vendor\yiisoft\yii2-apidoc\templates\bootstrap\assets\JsSearchAsset.php on line 10
http://guide.yii2.org-info.by/ - руководство Yii2 по-русски, со сквозным сопоставлением ссылок на рус. и англ. темы.Русский поиск.Работает на телефонах.Обновляется.Предложени по доработке viewtopic.php?f=19&t=21391
Аватара пользователя
keltstr
Сообщения: 83
Зарегистрирован: 2013.01.12, 23:17

Re: Ошибка при генерации документации

Сообщение keltstr »

keltstr писал(а): win7x64, xampp, php5.5.3
Установил через композер apidoc (2014/12/28)
папку c доками закинул прямо в apidoc
делаю так:

Код: Выделить всё

php apidoc guide ./docs ./yii2doc
создается папка yii2doc, а в ней assets и там разные css js и больше ничего.
Оконко консоли закрывается, но ловлю принтскрином ETA n/a
А в логах php - PHP Fatal error: Cannot use yii\web\AssetBundle as AssetBundle because the name is already in use in V:\xampp\htdocs\_projects\xxxx\vendor\yiisoft\yii2-apidoc\templates\bootstrap\assets\JsSearchAsset.php on line 10
Надо в файле \vendor\yiisoft\yii2-apidoc\templates\bootstrap\assets\JsSearchAsset.php
удалить

Код: Выделить всё

use yii\web\AssetBundle; 
и дописать полный путь к наследуемому классу

Код: Выделить всё

class JsSearchAsset extends \yii\web\AssetBundle
http://guide.yii2.org-info.by/ - руководство Yii2 по-русски, со сквозным сопоставлением ссылок на рус. и англ. темы.Русский поиск.Работает на телефонах.Обновляется.Предложени по доработке viewtopic.php?f=19&t=21391
zelenin
Сообщения: 10596
Зарегистрирован: 2013.04.20, 11:30

Re: Ошибка при генерации документации

Сообщение zelenin »

keltstr писал(а):Надо в файле \vendor\
в vendor сторонние расширения, в которых ничего никогда править нельзя.
Ответить