Не полный обучающий мануал

Обсуждение документации

Не полный обучающий мануал

Сообщение Timlar » 2010.02.05, 22:29

Доброго времени суток, сообщество!

Начну с предыстории... Месяца 4 назад начинал изучать Yii, но из-за нехватки времени обучение пришлось отложить. С того времени фреймворк уже обновился до версии 1.1, а так же изменились обучающие мануалы. Решил все таки заняться изучением, но уже по новым мануалам.

Так вот столкнулся с тем, что в мануале по созданию блога отсутствуют определенные моменты. Я понимаю, что это перевод оригинального мануала, но там то же самое. Так же отличается местами код из оригинального мануала и переведенного здесь. Например:

В переведенном мануале, в разделе "Создание и редактирование записей" глава "Правки в действиях create и update" код:

Код: Выделить всё
<?php echo $form->dropDownList($post,'status',Lookup::items('PostStatus')); ?>


А в оригинальной версии, в разделе "Creating and Updating Posts" глава "Customizing create and update Operations" код:

Код: Выделить всё
<?php echo CHtml::activeDropDownList($post,'status',Lookup::items('PostStatus')); ?>


Возможно, это связано с тем, что после перевода, официальная документация еще обновлялась.

И вот запнулся я на том, что нигде в мануале (ни в русской, ни в оригинальной версии) не упоминается ничего об Tag::array2string() и Tag::string2array(), которые упоминаются в разделе "Доработка модели Post" глава "Изменение метода rules()". Т.е. нигде не описывается модель Tag.

Код: Выделить всё
public function normalizeTags($attribute,$params)
{
    $this->tags=Tag::array2string(array_unique(Tag::string2array($this->tags)));
}
 


Кто-нибудь может дописать недостающее? Мне, как начинающему, самому это сделать тяжело. Думаю, это не помешает и остальным, кто будет знакомиться с фреймворком по этому мануалу.

Заранее спасибо за ответы. Если еще найду несоответствия, напишу.
Конференция: yii@conference.jabber.ru (не стесняйтесь, заходите)
Аватара пользователя
Timlar
 
Сообщения: 546
Зарегистрирован: 2009.09.19, 17:49
Откуда: Украина, Днепропетровск

Re: Не полный обучающий мануал

Сообщение Sam Dark » 2010.02.07, 14:56

можно, это связано с тем, что после перевода, официальная документация еще обновлялась.

Так и есть. Документация на yiiframework.ru скорее по Yii 1.1.1, чем по Yii 1.1.0. Русская документация по 1.1.0 на yiiframework.com та же, что и документация на yiiframework.ru на момент выхода Yii 1.1.0.

Руководство по созданию блога лишь описывает основные моменты создания блога, но не позволяет написать его по инструкции от и до. Полный рабочий код идёт с каждой версией фреймворка в архиве.
Аватара пользователя
Sam Dark
Администратор
 
Сообщения: 1676
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж

Re: Не полный обучающий мануал

Сообщение Timlar » 2010.02.07, 19:38

В принципе, мне уже и этого хватило :) Разобрался как устроен и работает Yii, многие вещи стали очевидными :) Вот только все никак не могу понять, как вырубить автоматическое подключение jQuery, чтобы подключить его вручную. :(
Конференция: yii@conference.jabber.ru (не стесняйтесь, заходите)
Аватара пользователя
Timlar
 
Сообщения: 546
Зарегистрирован: 2009.09.19, 17:49
Откуда: Украина, Днепропетровск

Re: Не полный обучающий мануал

Сообщение Sam Dark » 2010.02.07, 20:08

Аватара пользователя
Sam Dark
Администратор
 
Сообщения: 1676
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж

Re: Не полный обучающий мануал

Сообщение zarafar » 2010.04.16, 16:41

Timlar писал(а):Доброго времени суток, сообщество!

Начну с предыстории... Месяца 4 назад начинал изучать Yii, но из-за нехватки времени обучение пришлось отложить. С того времени фреймворк уже обновился до версии 1.1, а так же изменились обучающие мануалы. Решил все таки заняться изучением, но уже по новым мануалам.

Так вот столкнулся с тем, что в мануале по созданию блога отсутствуют определенные моменты. Я понимаю, что это перевод оригинального мануала, но там то же самое. Так же отличается местами код из оригинального мануала и переведенного здесь.
...
И вот запнулся я на том, что нигде в мануале (ни в русской, ни в оригинальной версии) не упоминается ничего об Tag::array2string() и Tag::string2array(), которые упоминаются в разделе "Доработка модели Post" глава "Изменение метода rules()". Т.е. нигде не описывается модель Tag.

Код: Выделить всё
public function normalizeTags($attribute,$params)
{
    $this->tags=Tag::array2string(array_unique(Tag::string2array($this->tags)));
}
 





Поддерживаю :geek: Начал изучать Yii и столкнулся с точно такой же проблемой. Было очень сложно разобраться сначала, что да как. Хорошо догадался подглядывать в демо блог. Сейчас процесс изучения сдвинулся с мертвой точки) В документации создание блога описано хорошо, но местами с большими пробелами, которые как раз новичков ставят в тупик.
zarafar
 
Сообщения: 27
Зарегистрирован: 2010.04.04, 10:48

Re: Не полный обучающий мануал

Сообщение Sam Dark » 2010.04.16, 19:43

По мере сил и возможностей будем это дело поправлять.
Аватара пользователя
Sam Dark
Администратор
 
Сообщения: 1676
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж

Re: Не полный обучающий мануал

Сообщение Timlar » 2010.04.16, 20:53

Нужно просто в "обучалках" в нужных местах дописывать "код данной функции/класса смотрите в демонстрационном коде". :)
Конференция: yii@conference.jabber.ru (не стесняйтесь, заходите)
Аватара пользователя
Timlar
 
Сообщения: 546
Зарегистрирован: 2009.09.19, 17:49
Откуда: Украина, Днепропетровск

Re: Не полный обучающий мануал

Сообщение Sam Dark » 2010.04.16, 21:36

Было бы замечательно, если бы кто-нибудь указал эти нужные места…
Аватара пользователя
Sam Dark
Администратор
 
Сообщения: 1676
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж


Вернуться в Документация

Кто сейчас на конференции

Сейчас этот форум просматривают: нет зарегистрированных пользователей и гости: 1