You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: a1/i18n/ko-KR.md
+15-18Lines changed: 15 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
6
6
## Purpose
7
7
*팀환경을 위한 방향을 제시하는 Angular 스타일 가이드 by [@john_papa](//twitter.com/john_papa)*
8
8
9
-
만약 Angular [Angular](//angularjs.org) 어플리케이션의 문법, 컨벤션, 구조화를 위한 스타일 가이드를 찾고 있다면 제대로 오셨습니다. 여기 제시된 스타일들은 제 팀 단위 개발 경험, 프레젠테이션, [Pluralsight training courses](http://pluralsight.com/training/Authors/Details/john-papa)를 토대로 만들어졌습니다.
9
+
만약 [Angular](//angularjs.org) 어플리케이션의 문법, 컨벤션, 구조화를 위한 스타일 가이드를 찾고 있다면 제대로 오셨습니다. 여기 제시된 스타일들은 제 팀 단위 개발 경험, 프레젠테이션, [Pluralsight training courses](http://pluralsight.com/training/Authors/Details/john-papa)를 토대로 만들어졌습니다.
10
10
11
11
이 스타일 가이드의 목적은 Angular 어플리케이션을 만드는 길잡이 역할을 하기 위함이며 더 나아가 왜 내가 이런 것들을 선택했는지 보여주기 위함입니다.
12
12
>만약 이 가이드가 마음에 든다면 Pluralsight 에 올려놓은 저의 강의를 참고하시기 바랍니다. [Angular Patterns: Clean Code](http://jpapa.me/ngclean)
@@ -206,7 +206,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
206
206
]);
207
207
```
208
208
209
-
대신 간단한 세터 구무을 사용하고, 체인으로 나머지 부분을 처리하세요.
209
+
대신 간단한 세터 구문을 사용하고, 체인으로 나머지 부분을 처리하세요.
210
210
211
211
```javascript
212
212
/* recommended */
@@ -330,7 +330,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
330
330
### controllerAs Controller Syntax
331
331
###### [Style [Y031](#style-y031)]
332
332
333
-
-`전형적인 컨트롤러 `$scope` 구문 대신 `controllerAs` 구문을 사용하세요.
333
+
- 전형적인 컨트롤러 `$scope` 구문 대신 `controllerAs` 구문을 사용하세요.
334
334
335
335
-`controllerAs` 구문은 `$scope` 에 바인딩 하기위해 컨트롤러 안에서 `this`를 사용합니다.
336
336
@@ -1141,7 +1141,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
1141
1141
### Manipulate DOM in a Directive
1142
1142
###### [Style [Y072](#style-y072)]
1143
1143
1144
-
- DOM을 직접 다루게 되었다면, 디렉티브를 사용하세요. 만약 CSS나 [animation services](https://docs.angularjs.org/api/ngAnimate), Angular templating, [`ngShow`](https://docs.angularjs.org/api/ng/directive/ngShow) or [`ngHide`](https://docs.angularjs.org/api/ng/directive/ngHide) 등의 방식을 사용할 수 있다면 이를 사용하세요. 예를 들, 만약 디렉티브의 기능이 간단히 보여줌, 숨김 기능만 있다면 ngHide/ngShow를 사용하세요.
1144
+
- DOM을 직접 다루게 되었다면, 디렉티브를 사용하세요. 만약 CSS나 [animation services](https://docs.angularjs.org/api/ngAnimate), Angular templating, [`ngShow`](https://docs.angularjs.org/api/ng/directive/ngShow) or [`ngHide`](https://docs.angularjs.org/api/ng/directive/ngHide) 등의 방식을 사용할 수 있다면 이를 사용하세요. 예를 들어, 만약 디렉티브의 기능이 간단히 보여줌, 숨김 기능만 있다면 ngHide/ngShow를 사용하세요.
1145
1145
1146
1146
*이유*: DOM을 다루는 코드는 테스트, 수정이 어렵고 대부분 더 나은 구현 방법이 존재합니다. (e.g. CSS, 애니매이션, 템플릿)
1147
1147
@@ -1667,7 +1667,6 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
1667
1667
}
1668
1668
```
1669
1669
1670
-
When the above code is run through ng-annotate it will produce the following output with the `$inject` annotation and become minification-safe.
1671
1670
위의 코드가 포함된 코드가 ng-annotate를 거치게 되면 `$inject` 부분을 생성하게 되어 최소화 안전 코드가 됩니다.
1672
1671
1673
1672
```javascript
@@ -1797,7 +1796,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
1797
1796
1798
1797
*이유*: 예를 들어 XHR 호출이나 프라미스 실패 시, 좀 더 일관적인 방식으로 코드에서 발생한 예외를 잡아줍니다.
1799
1798
1800
-
주의: 예외 캐쳐는 당신이 예상했던 호출에서 특정 예외가 발생했을 때 그것을 잡아내고 대처하는데 좋습ㄴ디ㅏ. 예를 들어 원격 웹 서비스에 접속해서 데이터를 가져오는 XHR 호출을 만들 때 그 서비스로 부터 예외를 받아서 특정한 방식으로 대처할 수 있습니다.
1799
+
주의: 예외 캐쳐는 당신이 예상했던 호출에서 특정 예외가 발생했을 때 그것을 잡아내고 대처하는데 좋습니다. 예를 들어 원격 웹 서비스에 접속해서 데이터를 가져오는 XHR 호출을 만들 때 그 서비스로 부터 예외를 받아서 특정한 방식으로 대처할 수 있습니다.
1801
1800
1802
1801
```javascript
1803
1802
/* recommended */
@@ -2059,7 +2058,6 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
2059
2058
### Directive Component Names
2060
2059
###### [Style [Y126](#style-y126)]
2061
2060
2062
-
- Use consistent names for all directives using camel-case. Use a short prefix to describe the area that the directives belong (some example are company prefix or project prefix).
2063
2061
- 캐멀 캐이스를 이용해서 디렉티브 이름을 일관적으로 지어주세요. 짧은 접두어를 사용하여 이 디렉티브가 어떤 프로젝트 혹은 회사에 소속되어 있는지 알려주세요.
2064
2062
2065
2063
*이유*: 일관된 방식으로 컴포넌트를 찾아내고 참조할 수 있도록 합니다.
@@ -2114,10 +2112,10 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
2114
2112
2115
2113
만약 다음 가이드라인에 적합하지 않는 부분이 있다고 느껴지면, 위로 돌아가서 LIFT 가이드라인을 다시 살펴보세요.
2116
2114
2117
-
1.`L`코드를 쉽게 찾아낼 수 있음
2118
-
2.`I`첫눈에 구분할 수 있음
2119
-
3.`F`단순한 구조를 유지할 수 있음
2120
-
4.`T`반복작업을 피할 수 있음
2115
+
1.`L`코드를 쉽게 찾아낼 수 있음 (Locate)
2116
+
2.`I`첫눈에 구분할 수 있음 (Identify)
2117
+
3.`F`단순한 구조를 유지할 수 있음 (Flat)
2118
+
4.`T`반복작업을 피할 수 있음 (T-DRY)
2121
2119
2122
2120
### Locate
2123
2121
###### [Style [Y141](#style-y141)]
@@ -2311,7 +2309,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
2311
2309
2312
2310
- 레이아웃 같은 기능 구역을 나타내는 모듈들, 재사용 가능하고 공유가 가능한 서비스, 대시보드, 특화된 기능들을 모듈로 만드세요 (예를 들어 고객, 어드민, 판매).
2313
2311
2314
-
*이유*:자극 자족적인 모듈들은 어플리케이션에 아주 작은 충돌 혹은 아무 충돌 없이 추가될 수 있습니다.
2312
+
*이유*:자급자족적인 모듈들은 어플리케이션에 아주 작은 충돌 혹은 아무 충돌 없이 추가될 수 있습니다.
2315
2313
2316
2314
*이유*: 스프린트나 이터레이션은 기능 구역에 집중될 수 있고 마지막 부분에 켜질 수 있습니다.
2317
2315
@@ -2425,7 +2423,6 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
2425
2423
### Write Tests with Stories
2426
2424
###### [Style [Y190](#style-y190)]
2427
2425
2428
-
- Write a set of tests for every story. Startwith an empty test and fill them in as you write the code for the story.
2429
2426
- 모든 각각의 스토리를 위해서 테스트 세트를 작성하세요. 빈 테스트로 시작을 하고 스토리에 맞추어 코드를 작성하면서 채워나가세요.
2430
2427
2431
2428
*이유*: 테스트 설명을 작성함으로 스스로의 스토리가 어떻게 작동해야 하고 어떻게 작동하지 말아야 하는지 투명하게 정의할 수 있습니다. 그리고 성공을 어떻게 측정해야 하는지도 포함됩니다.
@@ -2572,7 +2569,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
2572
2569
2573
2570
*이유*: 단위 테스트는 소스 코드의 특정 컴포넌트와 파일들과 직접적인 상호작용을 합니다.
2574
2571
2575
-
*이유*: 항상 눈에 보여지게 됨으로 최신으로 유지하기가 쉽습ㄴ디ㅏ. TDD 또는 개발중 테스트 또는 개발 후 테스트 중 어떤 것을 사용하든 테스트 스팩은 나란히 보여지고 눈에서 멀어지기 어렵고 마음에서도 멀어지기 어렵습니다. 그러니 코드를 테스팅하는 코드도 유지보수하기 쉬워집니다.
2572
+
*이유*: 항상 눈에 보여지게 됨으로 최신으로 유지하기가 쉽습니다. TDD 또는 개발중 테스트 또는 개발 후 테스트 중 어떤 것을 사용하든 테스트 스팩은 나란히 보여지고 눈에서 멀어지기 어렵고 마음에서도 멀어지기 어렵습니다. 그러니 코드를 테스팅하는 코드도 유지보수하기 쉬워집니다.
2576
2573
2577
2574
*이유*: 소스코드를 수정하게 될 때 테스트도 동시에 수정하기가 매우 쉽습니다. 한폴더에 있고 보여지니까요.
2578
2575
@@ -2871,7 +2868,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
2871
2868
2872
2869
###### [Style [Y241](#style-y241)]
2873
2870
2874
-
- 변하지 않고 다른 서비스로부터 오지 않는 값들은 불변 상수를 이용하세요. 다양한 어플리케이션에서 재사용될 수 있는 모듈 내에서 사용되는 불변상 수들은 모듈의 이름을 딴 상수 파일을 만들어서 넣어두세요. 이 작업이 필요하기 전까지는 불변 상수는 메인 모듈의 `constants.js` 파일에 넣어두면 됩니다.
2871
+
- 변하지 않고 다른 서비스로부터 오지 않는 값들은 불변 상수를 이용하세요. 다양한 어플리케이션에서 재사용될 수 있는 모듈 내에서 사용되는 불변 상수들은 모듈의 이름을 딴 상수 파일을 만들어서 넣어두세요. 이 작업이 필요하기 전까지는 불변 상수는 메인 모듈의 `constants.js` 파일에 넣어두면 됩니다.
2875
2872
2876
2873
*이유*: 자주 변하지 않더라도 변할 가능성이 있는 값들은 서비스로부터 받아서 사용해야 소스코드를 변경하지 않아도 되게 됩니다. 예를 들어 데이터를 받아오는 url 값은 상수로 저장해서 사용할 수도 있지만, 더 좋은 곳은 웹서비스로 부터 받아오는 것입니다.
2877
2874
@@ -3175,7 +3172,7 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
3175
3172
**[Back to top](#table-of-contents)**
3176
3173
3177
3174
## Task Automation
3178
-
[Gulp](http://gulpjs.com) 또는 [Grunt](http://gruntjs.com)를 사용하여 자동화 처리를 사용하세요. Gult는 설정보다는 코드 자체에 무게를 더 주는 반면 Grunt는 설정을 더 중요하게 생각합니다. 개인적으로는 읽고 작성하기가 쉬워서 Gulp를 선호합니다. 하지만 둘다 정말 멋집니다.
3175
+
[Gulp](http://gulpjs.com) 또는 [Grunt](http://gruntjs.com)를 사용하여 자동화 처리를 사용하세요. Gulp는 설정보다는 코드 자체에 무게를 더 주는 반면 Grunt는 설정을 더 중요하게 생각합니다. 개인적으로는 읽고 작성하기가 쉬워서 Gulp를 선호합니다. 하지만 둘다 정말 멋집니다.
@@ -3210,13 +3207,13 @@ Angular 팀의 리더인 Igor Minar 에게 특별히 감사합니다. 이 스타
3210
3207
**[Back to top](#table-of-contents)**
3211
3208
3212
3209
## Angular docs
3213
-
나머지 부분, API 참고는 [Angular 문서](//docs.angularjs.org/api)여기로 가시면 됩니다.
3210
+
나머지 부분, API 참고는 [Angular 문서](//docs.angularjs.org/api)로 가시면 됩니다.
3214
3211
3215
3212
## Contributing
3216
3213
3217
3214
수정과 추가를 위해서는 이슈를 먼저 발행하시기 바랍니다. 이 가이드에 질문이 있으면 리파지토리에 이슈를 남겨주세요. 오타를 발견하면 pull request를 만들어주세요. 이렇게 하는 이유는 github의 기능을 최대한 사용해서 이슈와 PR이 어떻게 이루어 졌는지를 알려주기 위함입니다. 이런 정보는 구글로 검색도 가능합니다. 왜냐구요? 이상하게도 당신이 질문이 있다면 다른사람들도 그런 질문을 가지기 때문입니다. 여기서 어떻게 기여할 수 있는지 배울 수 있습니다.
3218
3215
3219
-
*이 저장소에 기여함으로서 당신의 콘텐츠가 이 저장소의 라이센트의 대상이 됨을 동의합니다.*
3216
+
*이 저장소에 기여함으로서 당신의 콘텐츠가 이 저장소의 라이센스의 대상이 됨을 동의합니다.*
0 commit comments