angularjsrus / angular-doc Goto Github PK
View Code? Open in Web Editor NEWРусская документация по Angulajs
License: MIT License
Русская документация по Angulajs
License: MIT License
Можно будет подумать о группах в соц. сетях.
Основная идея, что бы народ держался вместе, гдето в одно месте :)
Уже что-то есть в VK:
http://vk.com/angularjs
Можно будет сделать на G+. Там можно будет делиться ссылка и документами.
И после того как все устоканиться перенести этот репозиторий в отдельный проект.
Надо выкинуть из travis-а, минимизацию с использованием Java или заменить на uglify.
Что бы избежать таких ошибок:
https://travis-ci.org/maksimr/angular-doc/builds/7010566#L744
Стоит сделать выпадайку с выбором языка (примерно как тут: http://www.php.net/manual/ru/function.include.php) и поместить ее на видное место, например, в шапку рядом с поиском... пожертвовав пунктом «Главная» если что.
При смене языка, в адресе страницы меняется домен и делается переадресация. Все относительные ссылки идентичны, поэтому переход произойдет на ту же статью только на другом языке.
И то же самое закомитить на официальный сайт (только язык на английский поменять), а то они три года будут поддержку многоязычности рожать :-)
При вставке примера в статью (http://www.angular.ru/cookbook) код скрипта должен находиться в script.js, иначе не работает. Не смотря на то, что дополнительные файлы автоматически подключаются в index.html
Если этот пример запустить по прямой ссылке http://www.angular.ru/cookbook/watcharray он не заведется не зависимо от браузера. Если же перейти на него с другого примера, то все ОК.
Вчера перестала собираться документация. Например раздел http://doc.angularjs.cloudbees.net/guide/di
"что колбэк error для таких ответов вызываться ((на)) будет."
Страница: http://angular.ru/tutorial/step_03
"Запустите тесты командой npm run protractor, чтобы убедиться, что тесты не прошли.
Вы могли бы подумать, что нужно просто добавить в title тег следующим образом:
Однако, когда вы перезагрузите страницу, вы не увидите ожидаемого результата. ..."
Каким образом?
Иногда встречаются моменты, которые сложно понять и, соответственно, перевести. Наверное, не стоит по поводу них создавать отдельные темы и пока можно всё собирать здесь.
Надо настроить travis так что бы при прогонке тестов для pull request'ов он не просился на heroku.
По мотивам maksimr/docs.angularjs.ru#1 (comment)
Надо продумать как сделать такое сравнение, не навязчивым.
Сейчас действительно возникнут проблемы, если в официальный репозиторий будут
добавлять дополнения, исправлять текст. Сложно будет понять что поменялось
после перевода.
Варианты решения:
Ручной:
Смотреть на оф. репозиторий(официальный репозиторий) и ручками составить
файл где будут перечислены файлы с переводом и соответствующие
им номера коммитов с офф. репозитория.
Например:
guide:
name: bootstrap.ngdoc
hash: f24cf4b
date: 2013-05-03
Где f24cf4b58f3c2e56df188738356b21e6c898ff0c
(Кнопка History)
hash файла bootstrap.ngdoc с которого мы делали
перевод.
Это позволит нам:
Минус очевиден, необходимо всегда поддерживать файл соответствия и следить за
изменения в оф. репозитории.
Автоматический:
Надо подумать как это можно автоматизировать.
Первое что приходит на ум, положить наши файлы с переводом отдельно от английских.
Сделать hook(pre-commit) или скрипт, который будет проходить по файлам русской документации, смотреть дату изменения,
находить соответствующие им английские файлы, и собирать из этого файл соответствия.
Второе что пришло на ум, чтобы не править исходники сделать под-модулем основной репозиторий
и от туда брать hash-и файлов документации.
Минус:
В общем надо подумать...
Заметил, что https://docs.angularjs.org/api и http://angular.ru/api/ немного отличаются. В первом случае присутствует возможность выбора версии Angular'a, во втором случае данная возможность отсутствует. Также при выборе версии 1.3 на оригинальном сайте изменяются дизайн и порядок следования разделов (плюс присутствуют новые разделы, такие как ngTouch и ngMessages).
На мой взгляд поддерживать переводы для различных версий AngularJS слишком трудозатратно, поэтому предлагаю просто добавить переводы для новых компонентов (таких как ngTouch / ngMessages) в http://angular.ru/api/
Ваше мнение?
Перевод от Владимир Бондаренко:
http://angular.ru/tutorial/step_05#comment-948403624
http://rghost.ru/47152751
Ссылка на страницу:
http://angular.ru/tutorial/step_05
На странице http://angular.ru/tutorial в слове "фрейморками".
На примере руководства разработчика сделать раздел, куда можно будет помещать статьи с живыми примерами. Например, по созданию комбобоксов или древовидных структур (http://jsfiddle.net/brendanowen/uXbn6/8/).
Проблема в том, как добавлять новые статьи по коммиту из веб-интерфейса.
Чего только не пробовал. Работает только <link> для CSSок. @import в CSS не работает, ссылка на внешний файл в <script> не работает, даже ссылка в deps тега <example> не инклудится.
Пример: http://www.angular.ru/cookbook/jqplugins
P.S. Может попробовать залить в движок сайта что-то типа jQuery.getScript(), если сейчас ничего подобного нет?
Надо! :)
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.