angularjsrus / angular-doc Goto Github PK

Перевод от Владимир Бондаренко:
http://angular.ru/tutorial/step_05#comment-948403624
http://rghost.ru/47152751

Ссылка на страницу:
http://angular.ru/tutorial/step_05

Для сравнения
http://docs.angularjs.org/api/ng.$rootScope.Scope
и
http://www.angular.ru/api/ng.$rootScope.Scope

Стоит сделать выпадайку с выбором языка (примерно как тут: http://www.php.net/manual/ru/function.include.php) и поместить ее на видное место, например, в шапку рядом с поиском... пожертвовав пунктом «Главная» если что.

При смене языка, в адресе страницы меняется домен и делается переадресация. Все относительные ссылки идентичны, поэтому переход произойдет на ту же статью только на другом языке.

И то же самое закомитить на официальный сайт (только язык на английский поменять), а то они три года будут поддержку многоязычности рожать :-)

На примере руководства разработчика сделать раздел, куда можно будет помещать статьи с живыми примерами. Например, по созданию комбобоксов или древовидных структур (http://jsfiddle.net/brendanowen/uXbn6/8/).

Проблема в том, как добавлять новые статьи по коммиту из веб-интерфейса.

Надо выкинуть из travis-а, минимизацию с использованием Java или заменить на uglify.
Что бы избежать таких ошибок:

https://travis-ci.org/maksimr/angular-doc/builds/7010566#L744

Иногда встречаются моменты, которые сложно понять и, соответственно, перевести. Наверное, не стоит по поводу них создавать отдельные темы и пока можно всё собирать здесь.

Заметил, что https://docs.angularjs.org/api и http://angular.ru/api/ немного отличаются. В первом случае присутствует возможность выбора версии Angular'a, во втором случае данная возможность отсутствует. Также при выборе версии 1.3 на оригинальном сайте изменяются дизайн и порядок следования разделов (плюс присутствуют новые разделы, такие как ngTouch и ngMessages).

На мой взгляд поддерживать переводы для различных версий AngularJS слишком трудозатратно, поэтому предлагаю просто добавить переводы для новых компонентов (таких как ngTouch / ngMessages) в http://angular.ru/api/

Ваше мнение?

Надо! :)

• Оживить страничку
• Повесить ее на /

Можно будет подумать о группах в соц. сетях.
Основная идея, что бы народ держался вместе, гдето в одно месте :)

Уже что-то есть в VK:
http://vk.com/angularjs

Можно будет сделать на G+. Там можно будет делиться ссылка и документами.

И после того как все устоканиться перенести этот репозиторий в отдельный проект.

По мотивам maksimr/docs.angularjs.ru#1 (comment)

Надо продумать как сделать такое сравнение, не навязчивым.

Сейчас действительно возникнут проблемы, если в официальный репозиторий будут
добавлять дополнения, исправлять текст. Сложно будет понять что поменялось
после перевода.

Варианты решения:

Ручной:

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

Например:

guide:
name: bootstrap.ngdoc
hash: f24cf4b
date: 2013-05-03

Где f24cf4b58f3c2e56df188738356b21e6c898ff0c(Кнопка History)
hash файла bootstrap.ngdoc с которого мы делали
перевод.

Это позволит нам:

1. Если узнать что файл изменился, если изменился hash (в оф. репозитории)
2. Посмотреть diff между коммитом, с которого мы делали перевод и последним

Минус очевиден, необходимо всегда поддерживать файл соответствия и следить за
изменения в оф. репозитории.

Автоматический:

Надо подумать как это можно автоматизировать.
Первое что приходит на ум, положить наши файлы с переводом отдельно от английских.
Сделать hook(pre-commit) или скрипт, который будет проходить по файлам русской документации, смотреть дату изменения,
находить соответствующие им английские файлы, и собирать из этого файл соответствия.

Второе что пришло на ум, чтобы не править исходники сделать под-модулем основной репозиторий
и от туда брать hash-и файлов документации.

Минус:

1. Надо затратить время и сделать это :)
2. Придется править исходники сборки, так как теперь у нас будет две версии файлов, оригиналы и перевод, что может привести к конфликтам при мердже с офф репозиторием. (~)
3. Где лучше запускать этот скрипт? Подходящее место как мне кажется для этого сборка документации на heroku,
   но тут проблема что нам придется пушить этот файл на гитхаб, что инициирует сборку на travis-е, который в свою очередь снова запустит билд на heroku %).

В общем надо подумать...

Надо настроить travis так что бы при прогонке тестов для pull request'ов он не просился на heroku.

http://www.angular.ru/cookbook/service_provide_factory

Страница: http://angular.ru/tutorial/step_03

"Запустите тесты командой npm run protractor, чтобы убедиться, что тесты не прошли.
Вы могли бы подумать, что нужно просто добавить в title тег следующим образом:
Однако, когда вы перезагрузите страницу, вы не увидите ожидаемого результата. ..."

Каким образом?

Если этот пример запустить по прямой ссылке http://www.angular.ru/cookbook/watcharray он не заведется не зависимо от браузера. Если же перейти на него с другого примера, то все ОК.

При вставке примера в статью (http://www.angular.ru/cookbook) код скрипта должен находиться в script.js, иначе не работает. Не смотря на то, что дополнительные файлы автоматически подключаются в index.html

Чего только не пробовал. Работает только <link> для CSSок. @import в CSS не работает, ссылка на внешний файл в <script> не работает, даже ссылка в deps тега <example> не инклудится.

Пример: http://www.angular.ru/cookbook/jqplugins

P.S. Может попробовать залить в движок сайта что-то типа jQuery.getScript(), если сейчас ничего подобного нет?

"что колбэк error для таких ответов вызываться ((на)) будет."

На странице http://angular.ru/tutorial в слове "фрейморками".

Вчера перестала собираться документация. Например раздел http://doc.angularjs.cloudbees.net/guide/di