Страница 1 из 3

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

Добавлено: 2009.04.15, 21:38
samdark
http://www.yiiframework.com/doc/guide/ru/index

Если найдёте ошибки, неточности. Что-либо в документации будет непонятно — отмечайтесь. Всё поправим.

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

Добавлено: 2009.08.27, 10:28
Ekstazi
Хочу присоединиться к переводу. Владею английским на уровне чтения и понимания технической документации.

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

Добавлено: 2009.08.27, 12:03
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.

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

Добавлено: 2009.09.24, 10:47
Ekstazi
Аналогично. Только по мне ближе перевод документации по классам.

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

Добавлено: 2009.09.24, 11:01
samdark
На данный момент вся официальная документация переведена (руководство и туториал по блогу).

Остались только рецепты (тут можно и авторские написать).

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

Добавлено: 2009.09.24, 15:25
Ekstazi
Я про справочник по классам.

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

Добавлено: 2009.09.24, 15:35
samdark
API пока переводить не планируется (официально) т.к. он часто обновляется.

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

Добавлено: 2009.09.24, 15:43
SpiLLeR
Хотелось бы увидеть больше рецептов.
А так же добавьте UMLку с классами на более видно место, а то случайно наткнулся на такую полезную вещь :)

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

Добавлено: 2009.09.24, 15:48
samdark
Сразу после главной странички с новостями займусь следующей порцией рецептов.

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

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

По поводу диаграммы классов. Я так понял, что штука востребованная :)
Тогда как будет время, сделаю актуальную версию.

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

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

Диаграмма действительно оказалась востребованной. Обновлять стоит.

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

Добавлено: 2010.03.19, 17:23
sshz
Не совсем по русской документации, скорее может быть по документации на yiiframework.ru.

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

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

Добавлено: 2010.03.19, 19:42
nuclear
http://yiiframework.ru/doc/guide/ru/database.arr
Написаны все, кроме самого главного - как добавлять записи.

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

Добавлено: 2010.03.19, 19:57
samdark
Это потому, что пока сохранение связанных моделей не поддерживается.

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

Добавлено: 2010.04.10, 21:00
AbS_
Хотелось бы видеть дополнение к документации по "Контроль доступа на основе ролей (RBAC)" А именно, как это все сделать в базе данных.
Так же в примере сказано, что можно подкючить для авторизации БД, и даже написано как, но хотелось бы более развернуто.
Было бы совсем хорошо, если бы это вышло отдельным уроком.

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

Добавлено: 2010.04.15, 00:10
samdark
creocoder уже этим занимается.

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

Добавлено: 2010.06.08, 13:24
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 описывают права доступа, с которыми должны создаваться новые файлы и директории.

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

Добавлено: 2010.06.10, 18:04
samdark
radioheaded
Откуда английский вариант?

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

Добавлено: 2010.06.10, 22:01
radioheaded
Из официальной документации. По крайней мере, мне так казалось... http://www.yiiframework.com/doc/guide/topics.gii

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

Добавлено: 2010.06.10, 22:53
samdark
Ну так есть же всё и переведено: http://yiiframework.ru/doc/guide/ru/topics.gii