Принимается критика и пожелания к русской документации Yii
-
- Сообщения: 8
- Зарегистрирован: 2010.04.30, 17:24
Re: Принимается критика и пожелания к русской документации Y
Тогда извиняюсь, претензия, скорее, к структуре официального гайда, ибо в quickstart'е этой части нет, а без нее gii не запустится в 90% случаев (остальные 10%, так и быть, изучают на денверах и прочих XAMPP'ах =)
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
С процентами скорее наоборот.
Нравится Yii? Давайте сделаем его лучше!.
Re: Принимается критика и пожелания к русской документации Y
Было бы хорошо, если б во всех статьях документации, рецептов, и примере создания блога, были ссылки на подзаголовки статей.
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
Записал в TODO.
Нравится Yii? Давайте сделаем его лучше!.
- porcelanosa
- Сообщения: 570
- Зарегистрирован: 2010.03.16, 04:31
- Откуда: Москва
Re: Принимается критика и пожелания к русской документации Y
критика скорее английской версии.
Больше примеров в API - сильно упростит жизнь начинающим.
Больше примеров в API - сильно упростит жизнь начинающим.
mcintosh-club.ru - первый мой сайт с использование Yii //
Акустика Sonus Faber Hi-End класса//
Необрезная доска и другие пиломатериалы
Акустика Sonus Faber Hi-End класса//
Необрезная доска и другие пиломатериалы
Re: Принимается критика и пожелания к русской документации Y
Ошибка, точнее не полная информация тут: http://yiiframework.ru/doc/guide/ru/topics.url текст:
Использование именованных параметров
Правило может быть ассоциировано с несколькими GET-параметрами. Эти параметры указываются в шаблоне правила в виде маркеров следующим образом:
тут должен быть блок кода, даже теги pre есть.
где ParamName соответствует имени GET-параметра, а ........
И еще в том же разделе много где упоминается, что что-либо доступно с версии 1.1.7, например:
pattern: паттерн, который будет использован при сопоставлении и создании URL. Данная возможность доступна с версии 1.1.7.
Но ведь текущая версия 1.1.6.
Использование именованных параметров
Правило может быть ассоциировано с несколькими GET-параметрами. Эти параметры указываются в шаблоне правила в виде маркеров следующим образом:
тут должен быть блок кода, даже теги pre есть.
где ParamName соответствует имени GET-параметра, а ........
И еще в том же разделе много где упоминается, что что-либо доступно с версии 1.1.7, например:
pattern: паттерн, который будет использован при сопоставлении и создании URL. Данная возможность доступна с версии 1.1.7.
Но ведь текущая версия 1.1.6.
- greatdane
- Сообщения: 408
- Зарегистрирован: 2010.10.20, 14:05
- Откуда: Электросталь
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
А мне нравится, что документация появляется с опережением. Это лучше, чем полгода ждать обновления документации и обнаружить потом, что все эти полгода ты не использовал офигенные нововведения... Я уже с нетерпением жду 1.1.7, в ней много вкусного ожидается.
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
pre поправил на прошлой неделе. По 1.1.7 я придерживаюсь того же мнения, что и greatdane.
Нравится Yii? Давайте сделаем его лучше!.
насчет темы - создание блога на Yii
Делал все по вашей инструкции, на шаге "Аутентификация пользователя" столкнулся с ошибкой:
.
Я в принципе и до этого когда читал, недоумевал почему в руководстве идет допустим речь о файлах User.php, Post.php, Tag.php, в то время, как мы сами до этого сгенерировали файлы (в соответствии с мануалом) с префиксом Tbl. В чем может быть ошибка? Я так понимаю, мне надо переименовать файл TblUser.php в User.php, поскольку указывается, что не найден такой файл или директория. Или нет?
Код: Выделить всё
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
По идее, на этапе генерации надо было указать, что используется префикс. Тогда бы Gii выдало файлы вида User, а не TblUser.
Нравится Yii? Давайте сделаем его лучше!.
Re: Принимается критика и пожелания к русской документации Y
сгенерировал заново, можно, наверно, дописать на шаге "Генерация каркаса" примечания переводчика о том, что надо указать в поле talbe prefix префикс таблицы во избежание дальнейших неточностей
-
- Сообщения: 350
- Зарегистрирован: 2009.09.17, 16:47
- Откуда: Санкт-Петербург
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
http://yiiframework.ru/doc/guide/ru/extension.create раздел Компонент приложения, написано: Основной метод, который необходимо реализовать, — IApplicationComponent::init. Он может быть и основной, но так же надо реализовать getIsInitialized();
Предупрежден - значит вооружен.
devKP.ru
devKP.ru
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
Добавил в блог информацию про префиксы, на сайте будет со следующей порцией переводов.
getIsInitialized реализован в CApplicationComponent, так что реализовывать его самостоятельно необходимости нет.
getIsInitialized реализован в CApplicationComponent, так что реализовывать его самостоятельно необходимости нет.
Нравится Yii? Давайте сделаем его лучше!.
-
- Сообщения: 350
- Зарегистрирован: 2009.09.17, 16:47
- Откуда: Санкт-Петербург
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
ну если расширяешь CApplicationComponent, то нет, а если реализовываешь интерфейс то да)
Предупрежден - значит вооружен.
devKP.ru
devKP.ru
Re: Принимается критика и пожелания к русской документации Y
читаю документацию.
1. Хотелось бы внизу текста ссылки на следующий раздел-предыдущий раздел. Чтобы было как в книге и на пхп.нет. Всё равно первый раз при знакомстве всю документацию прочитываешь.
2. http://yiiframework.ru/doc/guide/ru/topics.auth
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь, используя CWebUser::isGuest.
Лучше так
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь с помощью CWebUser::isGuest.
там же класс Identity то с маленькой буквы, то с большой.
1. Хотелось бы внизу текста ссылки на следующий раздел-предыдущий раздел. Чтобы было как в книге и на пхп.нет. Всё равно первый раз при знакомстве всю документацию прочитываешь.
2. http://yiiframework.ru/doc/guide/ru/topics.auth
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь, используя CWebUser::isGuest.
Лучше так
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь с помощью CWebUser::isGuest.
там же класс Identity то с маленькой буквы, то с большой.
Re: Принимается критика и пожелания к русской документации Y
Это не название класса.. скорее "функциональное назначение" Хотя, да буква в одном месте пляшет.php писал(а):2. http://yiiframework.ru/doc/guide/ru/topics.auth
там же класс Identity то с маленькой буквы, то с большой.
...
Re: Принимается критика и пожелания к русской документации Y
Так не лучше, так полностью меняется смысл фразы. У вас получается, что пользователь прошел аутентификацию при помощи некоего свойства. Т.е. подразумевается, что существует еще несколько свойств, при помощи которых можно пройти аутентификацию.php писал(а):Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь, используя CWebUser::isGuest.
Лучше так
Используя этот компонент, мы можем проверить, аутентифицирован ли пользователь с помощью CWebUser::isGuest.
А оригинальное предложение гласит, что мы можем проверить факт аутентификации при помощи некоего свойства.
Re: Принимается критика и пожелания к русской документации Y
В гайде создания блога
Управление записями - Доработка модели 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:
Управление записями - Доработка модели 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);
}
Re: Принимается критика и пожелания к русской документации Y
Читал раздел "Создание блога" и нашел там ошибку в коде.
Если использовать именно такую реализацию метода, то в случае если я повторю код из раздела "управление комментариями"->Управление комментариями , то обновление статуса записи не будет происходить, т.к. метод beforeSave в классе Comment у меня переопределен по примеру из раздела "Управление записями" для того, чтобы при создании комментария можно было автоматом записывать значение date и status. Чтобы выполнялось обновление статуса(approve|pending), нужно в коде, который приведен выше, return false заменить на return parent::beforeSave();. И тогда проблема исчезает. Если я ошибаюсь в чем-то, пожалуйста укажите на мои ошибки!
Код: Выделить всё
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;
}
- samdark
- Администратор
- Сообщения: 9489
- Зарегистрирован: 2009.04.02, 13:46
- Откуда: Воронеж
- Контактная информация:
Re: Принимается критика и пожелания к русской документации Y
Если так сделать, то parent::beforeSave() выполнится два раза.
Нравится Yii? Давайте сделаем его лучше!.