Принимается критика и пожелания к русской документации Yii

Обсуждение документации. Переводы Cookbook и авторские рецепты.
radioheaded
Сообщения: 8
Зарегистрирован: 2010.04.30, 17:24

Re: Принимается критика и пожелания к русской документации Y

Сообщение radioheaded »

Тогда извиняюсь, претензия, скорее, к структуре официального гайда, ибо в quickstart'е этой части нет, а без нее gii не запустится в 90% случаев (остальные 10%, так и быть, изучают на денверах и прочих XAMPP'ах =)
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение samdark »

С процентами скорее наоборот.
Аватара пользователя
superuser
Сообщения: 15
Зарегистрирован: 2010.12.12, 19:13
Откуда: Lutsk, Ukraine

Re: Принимается критика и пожелания к русской документации Y

Сообщение superuser »

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

Re: Принимается критика и пожелания к русской документации Y

Сообщение samdark »

Записал в TODO.
Аватара пользователя
porcelanosa
Сообщения: 570
Зарегистрирован: 2010.03.16, 04:31
Откуда: Москва

Re: Принимается критика и пожелания к русской документации Y

Сообщение porcelanosa »

критика скорее английской версии.
Больше примеров в API - сильно упростит жизнь начинающим.
mcintosh-club.ru - первый мой сайт с использование Yii //
Акустика Sonus Faber Hi-End класса//
Необрезная доска и другие пиломатериалы
Аватара пользователя
Shaleny
Сообщения: 28
Зарегистрирован: 2011.02.24, 18:50

Re: Принимается критика и пожелания к русской документации Y

Сообщение Shaleny »

Ошибка, точнее не полная информация тут: http://yiiframework.ru/doc/guide/ru/topics.url текст:

Использование именованных параметров
Правило может быть ассоциировано с несколькими GET-параметрами. Эти параметры указываются в шаблоне правила в виде маркеров следующим образом:
тут должен быть блок кода, даже теги pre есть.
где ParamName соответствует имени GET-параметра, а ........

И еще в том же разделе много где упоминается, что что-либо доступно с версии 1.1.7, например:
pattern: паттерн, который будет использован при сопоставлении и создании URL. Данная возможность доступна с версии 1.1.7.
Но ведь текущая версия 1.1.6.
Аватара пользователя
greatdane
Сообщения: 408
Зарегистрирован: 2010.10.20, 14:05
Откуда: Электросталь
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение greatdane »

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

Re: Принимается критика и пожелания к русской документации Y

Сообщение samdark »

pre поправил на прошлой неделе. По 1.1.7 я придерживаюсь того же мнения, что и greatdane.
tokamame
Сообщения: 11
Зарегистрирован: 2011.05.30, 16:18

насчет темы - создание блога на Yii

Сообщение tokamame »

Делал все по вашей инструкции, на шаге "Аутентификация пользователя" столкнулся с ошибкой:

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

include(User.php) [<a href='function.include'>function.include</a>]: failed to open stream: No such file or directory
.
Я в принципе и до этого когда читал, недоумевал почему в руководстве идет допустим речь о файлах User.php, Post.php, Tag.php, в то время, как мы сами до этого сгенерировали файлы (в соответствии с мануалом) с префиксом Tbl. В чем может быть ошибка? Я так понимаю, мне надо переименовать файл TblUser.php в User.php, поскольку указывается, что не найден такой файл или директория. Или нет?
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение samdark »

По идее, на этапе генерации надо было указать, что используется префикс. Тогда бы Gii выдало файлы вида User, а не TblUser.
tokamame
Сообщения: 11
Зарегистрирован: 2011.05.30, 16:18

Re: Принимается критика и пожелания к русской документации Y

Сообщение tokamame »

сгенерировал заново, можно, наверно, дописать на шаге "Генерация каркаса" примечания переводчика о том, что надо указать в поле talbe prefix префикс таблицы во избежание дальнейших неточностей
SpiLLeR
Сообщения: 350
Зарегистрирован: 2009.09.17, 16:47
Откуда: Санкт-Петербург
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение SpiLLeR »

http://yiiframework.ru/doc/guide/ru/extension.create раздел Компонент приложения, написано: Основной метод, который необходимо реализовать, — IApplicationComponent::init. Он может быть и основной, но так же надо реализовать getIsInitialized();
Предупрежден - значит вооружен.
devKP.ru
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение samdark »

Добавил в блог информацию про префиксы, на сайте будет со следующей порцией переводов.

getIsInitialized реализован в CApplicationComponent, так что реализовывать его самостоятельно необходимости нет.
SpiLLeR
Сообщения: 350
Зарегистрирован: 2009.09.17, 16:47
Откуда: Санкт-Петербург
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение SpiLLeR »

ну если расширяешь CApplicationComponent, то нет, а если реализовываешь интерфейс то да)
Предупрежден - значит вооружен.
devKP.ru
php
Сообщения: 5
Зарегистрирован: 2012.01.20, 04:57

Re: Принимается критика и пожелания к русской документации Y

Сообщение php »

читаю документацию.
1. Хотелось бы внизу текста ссылки на следующий раздел-предыдущий раздел. Чтобы было как в книге и на пхп.нет. Всё равно первый раз при знакомстве всю документацию прочитываешь.
2. http://yiiframework.ru/doc/guide/ru/topics.auth
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь, используя CWebUser::isGuest.
Лучше так
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь с помощью CWebUser::isGuest.


там же класс Identity то с маленькой буквы, то с большой.
esche
Сообщения: 1054
Зарегистрирован: 2010.11.24, 03:39

Re: Принимается критика и пожелания к русской документации Y

Сообщение esche »

php писал(а):2. http://yiiframework.ru/doc/guide/ru/topics.auth
там же класс Identity то с маленькой буквы, то с большой.
Это не название класса.. скорее "функциональное назначение" :) Хотя, да буква в одном месте пляшет.
...
Jampire
Сообщения: 207
Зарегистрирован: 2011.01.28, 11:45
Откуда: Гомель
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение Jampire »

php писал(а):Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь, используя CWebUser::isGuest.
Лучше так
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь с помощью CWebUser::isGuest.
Так не лучше, так полностью меняется смысл фразы. У вас получается, что пользователь прошел аутентификацию при помощи некоего свойства. Т.е. подразумевается, что существует еще несколько свойств, при помощи которых можно пройти аутентификацию.
А оригинальное предложение гласит, что мы можем проверить факт аутентификации при помощи некоего свойства.
Изображение
Человек, говорящий, что это невозможно сделать, не должен мешать тому, кто это делает.
Аватара пользователя
TBIKC
Сообщения: 133
Зарегистрирован: 2011.07.23, 16:30

Re: Принимается критика и пожелания к русской документации Y

Сообщение TBIKC »

В гайде создания блога
Управление записями - Доработка модели Post

После
где array2string и string2array — новые методы, определённые в классе модели Tag в файле /wwwroot/yii/demos/blog/protected/models/Tag.php.
Не хватает
..
where array2string and string2array are new methods we need to define in the Tag model class:

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

public static function string2array($tags)
{
    return preg_split('/\s*,\s*/',trim($tags),-1,PREG_SPLIT_NO_EMPTY);
}
 
public static function array2string($tags)
{
    return implode(', ',$tags);
} 
farw
Сообщения: 17
Зарегистрирован: 2012.07.29, 15:27

Re: Принимается критика и пожелания к русской документации Y

Сообщение farw »

Читал раздел "Создание блога" и нашел там ошибку в коде.

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

protected function beforeSave()
{
    if(parent::beforeSave())
    {
        if($this->isNewRecord)
        {
            $this->create_time=$this->update_time=time();
            $this->author_id=Yii::app()->user->id;
        }
        else
            $this->update_time=time();
        return true;
    }
    else
        return false;
} 
Если использовать именно такую реализацию метода, то в случае если я повторю код из раздела "управление комментариями"->Управление комментариями , то обновление статуса записи не будет происходить, т.к. метод beforeSave в классе Comment у меня переопределен по примеру из раздела "Управление записями" для того, чтобы при создании комментария можно было автоматом записывать значение date и status. Чтобы выполнялось обновление статуса(approve|pending), нужно в коде, который приведен выше, return false заменить на return parent::beforeSave();. И тогда проблема исчезает. Если я ошибаюсь в чем-то, пожалуйста укажите на мои ошибки!
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Принимается критика и пожелания к русской документации Y

Сообщение samdark »

Если так сделать, то parent::beforeSave() выполнится два раза.
Ответить