Skip to content
Русская документация по Angulajs
Branch: master
Clone or download
Latest commit e072d3c Jun 23, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
css refactor(directives): connect new compiler Jan 25, 2012
docs Merge pull request #133 from xPutnikx/patch-2 Jun 22, 2016
example docs(examples): set ng-app to "personalLog" (example/personalLog) Apr 11, 2013
home Update homepage.js May 3, 2013
i18n fix(i18n): escape all chars above \u007f in locale files Apr 17, 2013
images chore(Grunt): switch from Rake to Grunt Mar 6, 2013
lib Stub version definition Mar 8, 2014
logs Merge branch 'master' of https://git.cloudbees.com/angularjs/doc Apr 22, 2013
scripts Initial checkin Apr 22, 2013
src Merge pull request #162 from mrol/patch-1 Feb 20, 2015
test fix path for jsonp test Jul 7, 2014
.env fix(init-app.sh): Оставляю symlink в development-е May 13, 2013
.gitignore fix(init-app.sh): Оставляю symlink в development-е May 13, 2013
.travis.yml fix npm May 11, 2014
CHANGELOG.md docs(changelog): fix the 1.0.6 header Apr 4, 2013
CONTRIBUTING.md docs(CONTRIBUTING.md): add contrib info file for GitHub Nov 25, 2012
Gruntfile.js fix(travis): Travis VM error (refs #18) May 10, 2013
Guardfile fix(Guardfile): Подправил guardfile May 15, 2013
LICENSE chore(license): update to google Apr 20, 2012
Procfile chore(init-app.sh): Move on heroku May 1, 2013
README.md fix: link for travis Aug 19, 2014
README.mdown Изменил README Apr 23, 2013
angularFiles.js feat(ngIf): add directive to remove and recreate DOM elements Apr 19, 2013
changelog.js chore(changelog.js): improve the changelog script Jan 23, 2013
changelog.spec.js chore(changelog.js): improve the changelog script Jan 23, 2013
changelog.tmp.md chore(release scripts): auto release scripts Mar 29, 2012
check-size.sh chore(Grunt): switch from Rake to Grunt Mar 6, 2013
gdocs.js chore(formating): clean code to be function() { Oct 11, 2011
gen_docs.sh chore(docs): get correct location for jasmine-node Sep 6, 2012
init-app.sh Exit immediately if a command exits with a non-zero status Mar 8, 2014
init-repo.sh docs(tutorial): testacular renamed to karma Apr 15, 2013
karma-e2e.conf.js fix(.travis.yml): removed trash May 6, 2013
karma-jqlite.conf.js chore: use Karma Apr 1, 2013
karma-jquery.conf.js chore: use Karma Apr 1, 2013
karma-modules.conf.js chore: use Karma Apr 1, 2013
package.json update nodejs engine Mar 7, 2014
release-commit.sh chore(release scripts): auto release scripts Mar 29, 2012
start-iteration.sh chore(release scripts): auto release scripts Mar 29, 2012
validate-commit-msg.js fix(git-validator): support fixup and better errors Jan 18, 2013
validate-commit-msg.spec.js fix(git-validator): support fixup and better errors Jan 18, 2013
version.js chore(release scripts): auto release scripts Mar 29, 2012
version.yaml chore(release): start 1.1.5 triangle-squarification iteration Apr 11, 2013
watchr-docs.rb chore(watchr): watchr scripts should output logs to terminal Oct 31, 2011

README.md

AngularJS Build Status

AngularJS позволяет вам писать web приложение на стороне клиента, так как если бы у вас был умный браузер. Эта технология позволяет использовать старый добрый HTML (или HAML, Jade и иже с ними!) в качестве шаблона и расширять его синтаксис, что позволяет вам описывать компоненты приложения кратко и ясно. Так же AngularJS автоматически синхронизирует данные внутри UI(представления) с объектами в JavaScript(моделью) используя двунаправленную привязку данных. Что бы помочь вам лучше структурировать ваше приложение и сделать его простым для написания тестов, AngularJS учит браузер как делать внедрение зависимостей(dependency injection) и инверсию управления(inversion of control). Ах да, AngularJS так же помогает взаимодействовать с сервером, укрощая асинхронные вызовы с promises и deferreds, и делает клиентскую навигацию и deeplinking с hashbang уралми(urls) или HTML5 pushState пустяковым делом. И самое лучшее: Вы будете получать удовольствие от разработки!

Ссылки

Русский перевод документации:

Официальный сайт:

Дополнительный материал:

Участие в проекте

Перевод

Если вы хотите помочь с переводом то можете использовать кнопку Улучшить перевод на сайте или перейти на Gitube в папку docs/content выбрать раздел и файл, например tutorial/index.ngdoc. После того как открылся файл нажмите 'Edit', все теперь можно добавлять или улучшать перевод! Формат ngdoc - это расширенный markdown.

Все что требует перевода нужно переводить (осталось немного) ;)

Уже имеющийся перевод так же местами требует правки. Не забывайте поглядывать в руководство по переводу, которое так же можно править и предлагать свое толкование тем или иным понятиям.

Улучшение проекта

Если у вас есть идеи как можно улучшить проект не стесняйтесь делайте pull-request'ы, пишите в issue или на почту!

Соглашения по оформлению commit'ов и pull-request'ов

Есть некоторые соглашения по оформлению commit'ов и pull-request'ов, взятые из официального репозитория.

Сообщение должно выглядеть следующим образом

<тип>(<Что меняли>): <сообщение>

В оригинале типов восемь, для перевода добавили девятый тип translate:

  • feat (улучшение)
  • fix (исправление)
  • docs (документация)
  • style (оформление)
  • refactor (рефакторинг)
  • test (тестирование)
  • chore (рутина)
  • revert (откат изменений)
  • translate (перевод)

Пример сообщения:

translate(guide:bootstrap): Добавил перевод

Сборка документации

Сейчас еще не определились с хостингом. На данный момент используем связку travis + heroku, до этого использовали cloudbees(сейчас там сборка приостановлена но hook'и остались). Сборка начинается после добавления изменений в основной репозиторий и занимает порядка 4 - 5 минут. Любые советы, предложения приветствуются. Основная задача запускать автоматически сборку документации на сайте после изменения основного репозитория на github'е.

Если статус Build Status зеленый (passing), то последняя сборка на travis прошла успешно.

Локальная сборка документации

Необходимо склонировать себе проект и запустить сборку. Для этого необходимо сделать следующие команды:

# клонируем проект
git clone https://github.com/maksimr/angular-doc.git
# переходим в него
cd angular-doc
# устанавливаем npm пакеты
npm install
# запускаем сборку документации
grunt heroku
# запускаем сборку проекта и сервер
./init-app.sh

Благодарности

You can’t perform that action at this time.