Skip to content

Commit 0c095a9

Browse files
committed
removed js
1 parent be650be commit 0c095a9

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

i18n/ru-RU.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Руководство по стилям для AngularJS
22

3-
*AngularJS соглашения по стилям для команд разработчиков, предложенные [@john_papa](//twitter.com/john_papa)*
3+
*Angular соглашения по стилям для команд разработчиков, предложенные [@john_papa](//twitter.com/john_papa)*
44

55
*Перевел на русский язык [Василий Мажекин](https://github.com/mazhekin)*
66

@@ -9,12 +9,12 @@
99
Если вам нужны стандарты написания кода, соглашения, и руководства структурирования приложений AngularJS, то вы находитесь в правильном месте. Эти соглашения основаны на моем опыте программирования на [AngularJS](//angularjs.org), на моих презентациях [Pluralsight training courses](http://pluralsight.com/training/Authors/Details/john-papa), а также на совместной работе в командах разработчиков.
1010

1111
Главной целью этого документа является желание предоставить вам наиболее полные инструкции для построения приложений AngularJS. Рекомендуя данные соглашения, я стараюсь акцентировать ваше внимание на цели и причины, зачем их нужно придерживаться.
12-
>Если это руководство вам понравится, то вы можете также оценить мой курс [AngularJS Patterns: Clean Code](http://jpapa.me/ngclean), который размещен на сайте Pluralsight.
12+
>Если это руководство вам понравится, то вы можете также оценить мой курс [Angular Patterns: Clean Code](http://jpapa.me/ngclean), который размещен на сайте Pluralsight.
1313
14-
[![AngularJs Patterns: Clean Code](https://raw.githubusercontent.com/johnpapa/angularjs-styleguide/master/assets/ng-clean-code-banner.png)](http://jpapa.me/ngclean)
14+
[![Angular Patterns: Clean Code](https://raw.githubusercontent.com/johnpapa/angularjs-styleguide/master/assets/ng-clean-code-banner.png)](http://jpapa.me/ngclean)
1515

1616
## Признательность сообществу и коллегам
17-
Никогда не работайте в вакууме. Я считаю AngularJS-сообщество невероятно открытым, которое активно обменивается опытом и заботится об этом. Также как и мой друг Todd Motto (отличный AngularJS эксперт), я работал со многими стилями и соглашениями. Мы с ним сходимся во многом, но иногда и противоречим друг другу. Я предлагаю вам ознакомиться с курсом [Todd's guidelines](https://github.com/toddmotto/angularjs-styleguide) дабы почувствовать разницу подходов.
17+
Никогда не работайте в вакууме. Я считаю AngularJS-сообщество невероятно открытым, которое активно обменивается опытом и заботится об этом. Также как и мой друг Todd Motto (отличный Angular эксперт), я работал со многими стилями и соглашениями. Мы с ним сходимся во многом, но иногда и противоречим друг другу. Я предлагаю вам ознакомиться с курсом [Todd's guidelines](https://github.com/toddmotto/angularjs-styleguide) дабы почувствовать разницу подходов.
1818

1919
Многие из моих стилей взяты в ходе моих программистских сессий с [Ward Bell](http://twitter.com/wardbell). А так как мы не всегда были согласны друг с другом, то мой друг Ward оказал очень сильное влияние на эволюцию и окончательную редакцию этого документа.
2020

@@ -53,7 +53,7 @@
5353
1. [Yeoman Generator](#yeoman-generator)
5454
1. [Routing (Маршрутизация)](#routing)
5555
1. [Task Automation (Автоматизация)](#task-automation)
56-
1. [AngularJS Docs (AngularJS документация)](#angularjs-docs)
56+
1. [Angular Docs (Angular документация)](#angularjs-docs)
5757
1. [Contributing (Сотрудничество)](#contributing)
5858
1. [License](#license)
5959

@@ -116,7 +116,7 @@
116116
### Замыкания JavaScript
117117
###### [Style [Y010](#style-y010)]
118118

119-
- Оборачивайте компоненты AngularJS в Немедленно Исполняемые Функции(IIFE - Immediately Invoked Function Expression).
119+
- Оборачивайте компоненты Angular в Немедленно Исполняемые Функции(IIFE - Immediately Invoked Function Expression).
120120

121121
*Зачем?*: IIFE удаляют переменные из глобальной области видимости. Этот прием не дает существовать переменным и функциям дольше, чем это необходимо в глобальной области видимости. Иначе это может вызвать непредсказуемые коллизии во время исполнения всего приложения.
122122

@@ -683,7 +683,7 @@
683683
684684
- Сервисы создаются с помощью ключевого слова `new`. Используйте `this` для публичных методов и переменных. Так как они очень похожи на фабрики, то используйте фабрики для согласованности.
685685
686-
Замечание: [Все AngularJS сервисы являются синглтонами](https://docs.angularjs.org/guide/services). Это значит, что создается только один экземпляр сервиса на один инжектор.
686+
Замечание: [Все Angular сервисы являются синглтонами](https://docs.angularjs.org/guide/services). Это значит, что создается только один экземпляр сервиса на один инжектор.
687687
688688
```javascript
689689
// service
@@ -727,7 +727,7 @@
727727
728728
- Фабрики это синглтоны, которые возвращают объект, содержащий свойства и методы сервиса.
729729
730-
Замечание: [Все AngularJS сервисы являются синглтонами](https://docs.angularjs.org/guide/services).
730+
Замечание: [Все Angular сервисы являются синглтонами](https://docs.angularjs.org/guide/services).
731731
732732
### Доступные Члены Наверх
733733
###### [Style [Y052](#style-y052)]
@@ -1122,13 +1122,13 @@
11221122
### Ограничивайте Элементы и Атрибуты
11231123
###### [Style [Y074](#style-y074)]
11241124
1125-
- При создании директивы, которая планируется как самостоятельный элемент, применяйте ограничение `E` (разработано, как элемент) или по необходимости ограничение `A` (разработано, как атрибут). В основном, если директива разрабатывается как элемент, ограничения `E` вполне достаточно. Хотя AngularJS позволяет использовать `EA`, но все же лучше определится как реализовывать директиву, либо как самостоятельный отдельный элемент, либо как атрибут для улучшения функциональности существующего DOM-элемента.
1125+
- При создании директивы, которая планируется как самостоятельный элемент, применяйте ограничение `E` (разработано, как элемент) или по необходимости ограничение `A` (разработано, как атрибут). В основном, если директива разрабатывается как элемент, ограничения `E` вполне достаточно. Хотя Angular позволяет использовать `EA`, но все же лучше определится как реализовывать директиву, либо как самостоятельный отдельный элемент, либо как атрибут для улучшения функциональности существующего DOM-элемента.
11261126
11271127
*Почему?*: Это имееет смысл.
11281128
11291129
*Почему?*: Конечно мы можем использовать директиву в атрибуте class, но если директива действует как элемент, то лучше объявлять ее как элемент, ну или по крайней мере как атрибут.
11301130
1131-
Замечание: EA используется по умолчанию для AngularJS 1.3 +
1131+
Замечание: EA используется по умолчанию для Angular 1.3 +
11321132
11331133
```html
11341134
<!-- избегайте этого -->
@@ -1606,7 +1606,7 @@
16061606
}
16071607
```
16081608

1609-
> Замечание: Начиная с AngularJS 1.3 используйте [`ngApp`](https://docs.angularjs.org/api/ng/directive/ngApp) директивный параметр `ngStrictDi`. При наличии инжектора будет создан режим "strict-di", который не даст приложению работать, если обнаружит функции, которые не используют явные аннотации (например, для защиты от минификации). Отладочная информация будет отображаться в консоли, чтобы помочь разработчику выявить код, ломающий приложение.
1609+
> Замечание: Начиная с Angular 1.3 используйте [`ngApp`](https://docs.angularjs.org/api/ng/directive/ngApp) директивный параметр `ngStrictDi`. При наличии инжектора будет создан режим "strict-di", который не даст приложению работать, если обнаружит функции, которые не используют явные аннотации (например, для защиты от минификации). Отладочная информация будет отображаться в консоли, чтобы помочь разработчику выявить код, ломающий приложение.
16101610
`<body ng-app="APP" ng-strict-di>`
16111611

16121612
### Используйте Gulp или Grunt для ng-annotate
@@ -1648,7 +1648,7 @@
16481648

16491649
- Используйте [decorator](https://docs.angularjs.org/api/auto/service/$provide#decorator), во время конфигурации, применяя сервис [`$provide`](https://docs.angularjs.org/api/auto/service/$provide), пользовательские действия будут происходить в сервисе [`$exceptionHandler`](https://docs.angularjs.org/api/ng/service/$exceptionHandler), если произойдут исключения.
16501650

1651-
*Почему?*: Это дает постоянный надежный способ обработки необработанных исключений AngularJS во время разработки и во время выполнения.
1651+
*Почему?*: Это дает постоянный надежный способ обработки необработанных исключений Angular во время разработки и во время выполнения.
16521652

16531653
Замечание: Другим способом является переопределение сервиса, вместо использования декоратора. Это прекрасный способ, но если вы хотите сохранить поведение по умолчанию, и просто дополнить это поведение, то декоратоор крайне рекомендуем.
16541654

@@ -2161,7 +2161,7 @@
21612161
21622162
- Создайте корневой модуль приложения, который будет собирать вместе все модули и функциональности вашего приложения. Назовите этот модуль именем вашего приложения.
21632163
2164-
*Почему?*: AngularJS специально разработан для поддержки модульности и принципов разделения сущностей. А создание корневого модуля приложения, который связывает все ваши остальные модули вместе, предоставляет очень простой способ добавления и удаления модулей из приложения.
2164+
*Почему?*: Angular специально разработан для поддержки модульности и принципов разделения сущностей. А создание корневого модуля приложения, который связывает все ваши остальные модули вместе, предоставляет очень простой способ добавления и удаления модулей из приложения.
21652165
21662166
### Держите Модуль Приложения Тонким
21672167
###### [Style [Y162](#style-y162)]
@@ -2568,7 +2568,7 @@
25682568
### Глобальные Переменные Сторонних Производителей (Vendors)
25692569
###### [Style [Y240](#style-y240)]
25702570
2571-
- Создайте константы AngularJS для глобальных переменных из библиотек сторонних производителей.
2571+
- Создайте константы Angular для глобальных переменных из библиотек сторонних производителей.
25722572
25732573
*Почему?*: Предоставляет способ подключить сторонние библиотеки, которые являются глобальными переменными. Это улучшает тестируемость кода, позволяя вам проще узнать, какие зависимости есть у ваших компонентов. Это также позволит вам, создать фиктивные объекты этих зависимостей, если это нужно.
25742574
@@ -2619,7 +2619,7 @@
26192619
### Sublime Text
26202620
###### [Style [Y250](#style-y250)]
26212621
2622-
- AngularJS сниппеты, которые соблюдают приведенные здесь стили и руководства.
2622+
- Angular сниппеты, которые соблюдают приведенные здесь стили и руководства.
26232623
26242624
- Скачайте [Sublime Angular сниппеты](assets/sublime-angular-snippets.zip?raw=true)
26252625
- Поместите все в вашу папку Packages
@@ -2645,9 +2645,9 @@
26452645
### WebStorm
26462646
###### [Style [Y252](#style-y252)]
26472647
2648-
- AngularJS сниппеты и шаблоны файлов, которые соблюдают приведенные здесь стили и руководства. Вы можете импортировать их в свои настройки WebStorm:
2648+
- Angular сниппеты и шаблоны файлов, которые соблюдают приведенные здесь стили и руководства. Вы можете импортировать их в свои настройки WebStorm:
26492649
2650-
- Скачайте [WebStorm AngularJS шаблоны файлов и сниппетов](../assets/webstorm-angular-file-template.settings.jar?raw=true)
2650+
- Скачайте [WebStorm Angular шаблоны файлов и сниппетов](../assets/webstorm-angular-file-template.settings.jar?raw=true)
26512651
- Откройте WebStorm и перейдите в меню `File`
26522652
- Выберите пункт меню `Import Settings`
26532653
- Выберите файл и нажмите `OK`
@@ -2733,7 +2733,7 @@
27332733
27342734
**[К Содержанию](#table-of-contents)**
27352735
2736-
## AngularJS Docs
2736+
## Angular Docs
27372737
Для дополнительной информации, описания API, смотрите [документацию Angular](//docs.angularjs.org/api).
27382738
27392739
## Contributing

0 commit comments

Comments
 (0)