• Идеология проекта
• Инструменты переводчика
• Ответы на вопросы
• Рекомендации по переводу
• Шаблон статьи для перевода

А блог тут: http://scriptogr.am/entooru/

О чем всё это?

Энту́ру — это проект, посвященный переводам различных статей о Руби с английского языка на русский.

Добавление нового перевода

Любой желающий может пополнить репозиторий своим переводом. Сделать это очень просто. Пошаговая инструкция:

1. Проверьте раздел «Issues», на наличие статьи, которую вы желаете перевести. Возможно, кто-то уже её перевел ранее.

2. Форкните этот репозиторий на Гитхабе. Склонируйте его себе на жесткий диск:

    % git clone git://github.com/kyrylo/entooru.git
   
   
   Перейдите в директорию с репозиторием и создайте свою ветку (branch) с
   названием соответствующим названию переводимой статьи. Если название статьи
   слишком длинное, то можно название ветки укоротить по своему усмотрению.
   Пример:
   
    % cd entooru
    % git checkout -b name-of-the-article
   

3. Создайте в директории articles новую директорию с временно́й меткой и названием статьи. Временная метка должна выглядеть так: yyyymmdd (например: 20120419). В текущей директории создайте директорию второго уровня с названием en. В поддиректорию en поместите переводимую статью на английском языке. В корневую директорию статьи поместите её перевод:

    % cd articles
    % mkdir ./{20120419_name_of_the_article,en}
    % cd ./20120419_name_of_the_article/en
    % touch en_name_of_the_article.md
    % $EDITOR en_name_of_the_article.md
    % cd ..
    % $EDITOR ru_name_of_the_article.md
   
   _Внимание:_ временная метка — это метка которая обозначает дату, директория
   была добавлена в проект. _Не_ дату перевода, _не_ дату написания статьи автором,
   а именно _дату добавления директории в проект_!
   
   3.1 Пропустите этот подпункт, если переводимая статья не содержит
       изображений. Если содержит, то просто ставьте прямые ссылки на
       изображения из статьи.
   

4. Сделайте необходимые коммиты и отправьте пул реквест. После проверки перевода (не беспокойтесь, проверка более чем лояльна) он будет добавлен в общий блог, который расположен по адресу: http://scriptogr.am/entooru/. Обновление блога производится вручную.

5. Настоятельно рекомендуется уведомить автора статьи о переводе и дать ему ссылку на этот самый перевод. Возможно, он пожелает сообщить своих читателей о вашей кропотливой работе.

Автор проекта

Автором и координатором проекта является Кирилл Силин (Kyrylo Silin). Пожелания и вопросы можно писать в раздел «Issues» или на электронную почту kyrylosilin@gmail.com, если вопрос не является публичным.