Самая свежая документация

Обсуждение документации второй версии фреймворка. Переводы Cookbook и авторские рецепты.
Ответить
Аватара пользователя
futbolim
Сообщения: 2051
Зарегистрирован: 2012.07.08, 19:28

Самая свежая документация

Сообщение futbolim »

@SamDark
1. Александр, я правильно понял, что разработчики фреймворка "поделили" между собой обязанности?
2. И #cebe будет следить за доками?
3. И тут будет самая свежая документация http://stuff.cebe.cc/yii2docs/guide-index.html ?
Аватара пользователя
slavcodev
Сообщения: 3134
Зарегистрирован: 2009.04.02, 21:42
Откуда: Valencia
Контактная информация:

Re: Самая свежая документация

Сообщение slavcodev »

Если я правильно понял, по ссылке просто движок для генерации новой документации, в которое User Guide совмещен с API Guide. Документация ведь пишется сразу в phpDoc фреймворка, за ней следить не надо.
После релиза он переедет на оф. сайт.
Жду Yii 3!
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Самая свежая документация

Сообщение samdark »

1. Более-менее.
2. Доки пишем всеми. Генератор делает cebe.
3. Временно да. Потом переедет.
Аватара пользователя
yiijeka
Сообщения: 3103
Зарегистрирован: 2012.01.28, 09:14
Откуда: Беларусь
Контактная информация:

Re: Самая свежая документация

Сообщение yiijeka »

Аватара пользователя
Антон Смирнов
Сообщения: 284
Зарегистрирован: 2011.07.08, 10:37
Контактная информация:

Re: Самая свежая документация

Сообщение Антон Смирнов »

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

Re: Самая свежая документация

Сообщение samdark »

Возможно ещё поменяем. Оформление уж точно не финальное да и поиск точно будет.
fly2k
Сообщения: 155
Зарегистрирован: 2013.03.19, 05:31

Re: Самая свежая документация

Сообщение fly2k »

yiijeka писал(а):На офф доступен
http://www.yiiframework.com/doc-2.0/guide-index.html руководство
http://www.yiiframework.com/doc-2.0/index.html АPI
подскажите плз, можно ли поиметь точную копию http://www.yiiframework.com/doc-2.0/ у себя на локальной машине? чтоб с поиском и тд... чет с ходу не нашел самого движка в открытом доступе...

спасибо!
// Yii2Rulez!
fly2k
Сообщения: 155
Зарегистрирован: 2013.03.19, 05:31

Re: Самая свежая документация

Сообщение fly2k »

спасибо! а то я это видел, но мимо прошел - думал это расширение для генерации своих доков... не догнал что так же можно и не только свои генерить :)
// Yii2Rulez!
fly2k
Сообщения: 155
Зарегистрирован: 2013.03.19, 05:31

Re: Самая свежая документация

Сообщение fly2k »

а чет я там не нашел ни вьюх ни веб-контроллера... сгенерить то ладно, а как сайт с поиском по апи запустить? можно подробнее плз?
// Yii2Rulez!
fly2k
Сообщения: 155
Зарегистрирован: 2013.03.19, 05:31

Re: Самая свежая документация

Сообщение fly2k »

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

Re: Самая свежая документация

Сообщение samdark »

Оно генерит кучку HTML-страничек и поиск на JS. Сервер всему этому не нужен.
fly2k
Сообщения: 155
Зарегистрирован: 2013.03.19, 05:31

Re: Самая свежая документация

Сообщение fly2k »

Sam Dark писал(а):Оно генерит кучку HTML-страничек и поиск на JS. Сервер всему этому не нужен.
Спасибо! Только все равно допинать не могу :(

Все сделал к написано в доках, всё генерит ок, красатища! Только вожделенная строка поиска отсутсвует :(
Пробовал указать для api template=online - оно в конце ругнулось: Error: Calling unknown method: yii\apidoc\templates\online\ApiRenderer::typeLink()

Подозреваю что какой то зависимости не хватает, но вот какой? Может в пхп какого расширения не хватает?
// Yii2Rulez!
fly2k
Сообщения: 155
Зарегистрирован: 2013.03.19, 05:31

Re: Самая свежая документация

Сообщение fly2k »

вообще, в файле templates/bootstrap/layouts/main.php при создании navbar'а нет никакого упоминания про поиск - получается старую версию стянул... странно, ибо стоит "minimum-stability": "dev", "prefer-stable": true - а он почему то тянеть альфу, когда есть rc... ну да ладно, стянул dev-master, так он мне почему то yii2 2.0.0rc заменил на 2.0.0alpha и прочие пакеты поменял чутка... но самое главное:
vendor/bin/apidoc api /var/www/docs/yii2src /var/www/docs/yii2
говорит:
The Yii Framework 2.0 does not seem to be installed. Try running composer install.

composer install и dumpautoload не помогают...
// Yii2Rulez!
fly2k
Сообщения: 155
Зарегистрирован: 2013.03.19, 05:31

Re: Самая свежая документация

Сообщение fly2k »

yii2 и apidoc поставил в dev-master и вроде все ок! урряяя! апшэ красатищща! теперь можно хоть в лес с ноутом :)
да и такие вещи мотивируют каментить свой код :)

огромное спасибо за всё!
// Yii2Rulez!
Аватара пользователя
ifelse
Сообщения: 227
Зарегистрирован: 2013.02.05, 13:05

Re: Самая свежая документация

Сообщение ifelse »

А как часто актуализируются эти доки? http://www.yiiframework.com/doc-2.0
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Самая свежая документация

Сообщение samdark »

Раз в день, если не ошибаюсь.
Ответить