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

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

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

Сообщение samdark »

http://www.yiiframework.com/doc/guide/ru/index

Если найдёте ошибки, неточности. Что-либо в документации будет непонятно — отмечайтесь. Всё поправим.
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

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

Сообщение Ekstazi »

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

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

Сообщение samdark »

В качестве ознакомительного задания:
— Прочитать http://code.google.com/p/yiidoc/wiki/TransGuideRussian
— Выбрать отсюда http://www.yiiframework.com/doc/cookbook/ интересный рецепт, которого нет здесь http://yiiframework.ru/doc/cookbook/ru/index и перевести. Оформить в формате markdown. Перевод будет опубликован с указанием авторства в http://yiiframework.ru/doc/cookbook/ru/index.
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

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

Сообщение Ekstazi »

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

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

Сообщение samdark »

На данный момент вся официальная документация переведена (руководство и туториал по блогу).

Остались только рецепты (тут можно и авторские написать).
Ekstazi
Сообщения: 1428
Зарегистрирован: 2009.08.20, 22:54
Откуда: Молдова, Бельцы
Контактная информация:

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

Сообщение Ekstazi »

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

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

Сообщение samdark »

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

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

Сообщение SpiLLeR »

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

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

Сообщение samdark »

Сразу после главной странички с новостями займусь следующей порцией рецептов.
Аватара пользователя
Caveman
Сообщения: 152
Зарегистрирован: 2009.04.04, 20:56
Откуда: Москва
Контактная информация:

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

Сообщение Caveman »

Интересно, а вообще в планах есть официальный перевод API? Или стоит подумать, как сделать наиболее удобный и оптимальный процесс перевода. Структура классов, а, значит, и стабильный текст API может быть очень нескоро, а читать по-русски хочется уже сейчас :) Да и сам перевод займет немало времени, если соберемся делать-таки.

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

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

Сообщение samdark »

До стабильной 1.1 в планах точно не было русской или какой-либо ещё переведённой API-документации.

Диаграмма действительно оказалась востребованной. Обновлять стоит.
sshz
Сообщения: 28
Зарегистрирован: 2010.03.17, 12:26

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

Сообщение sshz »

Не совсем по русской документации, скорее может быть по документации на yiiframework.ru.

Объясню на примере, например я хочу найти информацию по удалению записи в статье по Active Record, для этого я захожу на страницу со статьей по Active Record и прокручиваю ~60% статьи, стараясь не пропустить нужный мне раздел, это неудобно. Было бы намного проще если бы в начале статьи было простое оглавление на anchor'ах. По крайней мере я бы точно пользовался документацией с оглавлением а не той, что на официальном сайте. Если конечно такой вариант возможен, я так понимаю документация "синхронизируется" с официальным сайтом.
nuclear
Сообщения: 31
Зарегистрирован: 2010.03.15, 15:34

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

Сообщение nuclear »

http://yiiframework.ru/doc/guide/ru/database.arr
Написаны все, кроме самого главного - как добавлять записи.
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

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

Сообщение samdark »

Это потому, что пока сохранение связанных моделей не поддерживается.
AbS_
Сообщения: 207
Зарегистрирован: 2010.03.27, 14:02

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

Сообщение AbS_ »

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

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

Сообщение samdark »

creocoder уже этим занимается.
radioheaded
Сообщения: 8
Зарегистрирован: 2010.04.30, 17:24

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

Сообщение radioheaded »

На странице http://yiiframework.ru/doc/guide/ru/qui ... .first-app, где рассказывается про Gii, тема раскрыта не полностью.

Для сравнения

Офдок

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

Gii is implemented in terms of a module and must be used within an existing Yii application. To use Gii, we first modify the application configuration as follows:

return array(
    ......
    'modules'=>array(
        'gii'=>array(
            'class'=>'system.gii.GiiModule',
            'password'=>'pick up a password here',
            // 'ipFilters'=>array(...a list of IPs...),
            // 'newFileMode'=>0666,
            // 'newDirMode'=>0777,
        ),
    ),
);
 
In the above, we declare a module named gii whose class is GiiModule. We also specify a password for the module which we will be prompted for when accessing Gii.

By default for security reasons, Gii is configured to be accessible only on localhost. If we want to make it accessible on other trustable computers, we can configure the GiiModule::ipFilters property as shown in the above code.

Because Gii may generate and save new code files in the existing application, we need to make sure that the Web server process has the proper permission to do so. The above GiiModule::newFileMode and GiiModule::newDirMode properties control how the new files and directories should be generated.
Русский док

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

return array(
    …
    'import'=>array(
        'application.models.*',
        'application.components.*',
    ),
 
    'modules'=>array(
        'gii'=>array(
            'class'=>'system.gii.GiiModule',
            'password'=>'задайте свой пароль',
        ),
    ),
);
 
После этого зайдите по URL http://hostname/testdrive/index.php?r=gii и введите указанный в конфигурации пароль.
Естественно, страница будет недоступна. В общем, я перевел этот кусочек, надеюсь, пригодится.

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

return array(
    ......
    'modules'=>array(
        'gii'=>array(
            'class'=>'system.gii.GiiModule',
            'password'=>'pick up a password here',
            // 'ipFilters'=>array(...список IP-адресов...),
            // 'newFileMode'=>0666,
            // 'newDirMode'=>0777,
        ),
    ),
);
 
Добавив эти строки, мы объявили модуль gii с классом GiiModule. Кроме этого, мы указали пароль для модуля, который будет запрошен при обращении к Gii.

Из соображений безопасности по умолчанию Gii настроен так, что доступен только с localhost. Если нам необходимо сделать его доступным и для других доверенных компьютеров, мы можем настроить свойство GiiModule::ipFilters, заполнив массив доверенными IP-адресами, с которых необходим доступ.

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

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

Сообщение samdark »

radioheaded
Откуда английский вариант?
radioheaded
Сообщения: 8
Зарегистрирован: 2010.04.30, 17:24

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

Сообщение radioheaded »

Из официальной документации. По крайней мере, мне так казалось... http://www.yiiframework.com/doc/guide/topics.gii
Аватара пользователя
samdark
Администратор
Сообщения: 9489
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

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

Сообщение samdark »

Ну так есть же всё и переведено: http://yiiframework.ru/doc/guide/ru/topics.gii
Ответить