@@ -19,50 +19,49 @@ AngularJS는 {@link http://github.com/angular/angular.js/blob/master/LICENSE MIT
19
19
20
20
<a name="H1_2"></a>
21
21
# 소스코드에 기여하기
22
- 저희는 당신이 소스코드에 기여하고, AngularJS를 보다 발전될 수 있도록 만들어주길 너무나도 바랍니다. 당신이 따라주길 바라는 안내서는 다음과 같습니다.
22
+ 저희는 당신이 소스코드에 기여하고, AngularJS를 좀 더 발전 될 수 있도록 만들어주길 간절히 바랍니다. 참고하여 따라주길 바라는 안내서는 다음과 같습니다.
23
23
24
- * 당신이 프로젝트에 기여하고자 하는 주요변화요소는 저희 노력을 조절하고, 중복작업을 예방하고, 당신의 작업이 성공적으로 적용될 수 있도록 도울 수 있기 때문에
25
- {@link https://groups.google.com/forum/?hl=en#!forum/angular mailing list}를 통하여 사전에 상의해주십시오 .
24
+ * 당신이 프로젝트에 기여하고자 하는 부분이 주요요소라면 {@link https://groups.google.com/forum/?hl=en#!forum/angular mailing list}를
25
+ 통하여 사전에 상의해주십시오. 저희 진행사항을 조절하면서 중복작업을 예방하고, 당신의 작업이 성공적으로 적용될 수 있도록 도울 수 있기 때문입니다 .
26
26
27
- * 버그 수정과 작은 변경요소는 작업하고, <a href="#H1_5">pull request</a>로서 Github에 제출할 수 있습니다.
27
+
28
+ * 버그 수정과 작은 변경요소는 작업하고, <a href="#H1_5">풀 요청(pull request)</a>를 통해서 Github에 제출할 수 있습니다.
28
29
29
30
30
31
31
32
<a name="H1_3"></a>
32
33
# 코드 기준 적용하기
33
34
34
- 소스코드를 전반적으로 일관성있게 하려면, 우리가 그렇게 임하듯이 다음과 같은 규칙을 명심하십시오 .
35
+ 전반적으로 소스코드를 일관성있게 하려면, 우리가 그렇게 하듯이 다음과 같은 규칙을 명심해야 합니다. .
35
36
36
- * 모든 기능 또는 버그 수정은 한명 또는 그 이상의 사람에게 테스트 되어야 합니다 <a href="#unit-tests">specs</a>.
37
+ * 모든 기능 또는 버그 수정은 한명 또는 그 이상의 사람에게 테스트 되어야 합니다 <a href="#unit-tests">스펙( specs) </a>.
37
38
38
- * 모든 공개 API 메소드는 ngdoc과 확정버젼의 jsdoc과 함께 서면화 되어야합니다 (jsdoc은 마크다운과 `@ngdoc` 태그를 통한 템플릿화를 위한 지원으로 저희
39
- 가 추가했었습니다). 어떻게 저희가 API들을 서면화 하는지 보시려면, 현존하는 ngdocs를 확인하십시오.
39
+ * 모든 공개용 API 메소드는 ngdoc과 확정버젼의 jsdoc과 함께 문서화 되어야합니다 (jsdoc은 마크다운과 `@ngdoc` 태그를 통한 템플릿화를 위한 지원으로 저희
40
+ 가 추가했었습니다). 어떻게 저희가 API들을 문서화를 하는지 보시려면, 현존하는 ngdocs를 확인하십시오.
40
41
41
- * 아래에 나열된 예회사항과 함께 저희는 {@link http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml Google's
42
+ * 아래에 나열된 예외사항과 함께 저희는 {@link http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml Google's
42
43
JavaScript Style Guide}에 담겨있는 규칙을 따릅니다.
43
44
44
- * 네임스페이스(namespaces)사용하지 않기: 대신, 저희는 익명클로저(anonymous closure)에서의 전체 `angular` code base전체를 감쌉니다 그리고
45
- 암암리보다는 명쾌하게 API를 export 합니다.
46
- //무슨.. 말이죠? 마지막 그리고 부터??
47
- * Do not use namespaces: Instead, we wrap the entire `angular` code base in an anonymous closure
48
- and export our API explicitly rather than implicitly.
45
+ * 네임스페이스(namespaces)사용하지마십시오: 대신, 저희는 익명클로저(anonymous closure)에서 전체 `angular` code base 전체를 감싸고 내부적이기
46
+ 보다는 외부적으로 API를 export 합니다.
49
47
50
- * 모든 코드는 100자에 감쌉니다.
48
+ * 모든 코드는 100내로 감쌉니다.
51
49
52
- * 복잡한 상속구조를 대신하여 , 저희는 간단한 오브젝트를 선호합니다. 우리는 정말 필요할 경우에는 원형적인 상속을 사용합니다.
50
+ * 복잡한 상속구조를 대신으로 , 저희는 간단한 오브젝트를 선호합니다. 우리는 정말 필요할 경우에는 원형적인 상속을 사용합니다.
53
51
54
- * 저희는 함수와 클로져를 사랑하고 가능하다면 언제든지 오브젝트보다 선호합니다.
52
+ * 저희는 함수와 클로져를 사랑하고, 가능하다면 오브젝트사용보다 선호합니다.
55
53
56
- * 보다 축소화될 수 있는 간결한 코드를 작성하기 위해서는 내부적으로 저희는 외부적인 API로 연결되는 가명을 사용합니다. 어떤의미인지 이해하기 위해서 우리의
57
- 현존하는 코드를 확인하십시오.
54
+ * 보다 축소화될 수 있는 간결한 코드를 작성하기 위해서는 저희는 내부적으로 외부로 들어나는 API로 연결되는 가명을 사용합니다. 어떤의미인지 이해하기 위해서
55
+ 우리의 현존하는 코드를 확인하십시오.
58
56
59
- * AngularJS 전반적으로 사용되는 내부 API가 아니라면 개인적인 API에 타입주석을 적는데 목매이지 않습니다. 가장 좋은 안내는 쉽게 이해하도록 하는 것입니다.
57
+ * AngularJS 전반적으로 사용되는 API는 내부적으로 사용되는게 아니라면 API에 개인적인 타입주석을 적는데 목매이지 마십시오. 가장 좋은 안내는 쉽게
58
+ 이해하도록 하는 것입니다.
60
59
61
60
62
61
<a name="H1_4"></a>
63
62
# 체크아웃과 Angular빌드하기
64
63
65
- AngularJS 소스코드는 {@link http://github.com Github}에 호스팅 되어있고, 우리는 또한 코드기여를 허용하는데도 사용하고 있습니다.
64
+ AngularJS 소스코드는 {@link http://github.com Github}에 호스팅 되어있고, 코드기여가 가능토록 공용으로 사용하고 있습니다.
66
65
AngularJS 레파지토리는 **<https://github.com/angular/angular.js>**에서 찾으실 수 있습니다.
67
66
68
67
AngularJS 체크아웃과 빌드를 위해서는 몇가지 절차가 필요합니다:
@@ -73,24 +72,24 @@ AngularJS를 빌드하기 전에, 반듯이 당신의 컴퓨터에 다음과 같
73
72
74
73
* Git: {@link http://help.github.com/mac-git-installation Github Guide to Installing Git}는 Git정보에 대한 정말 좋은 소스입니다.
75
74
76
- * {@link http://nodejs.org Node.js}: 우리는 서면화작업을 위해서, 웹서버 개발을 동작시키고, 테스트를 실행하고, 빌드 위해서 Node를 사용합니다.
77
- Node는 소스에서도 설치가 가능하고, 이미 준비된 번들로 설치도 가능합니다.
75
+ * {@link http://nodejs.org Node.js}: 우리는 문서화작업을 위해서, 웹서버 개발을 동작시키고, 테스트를 실행하고, 빌드 위해서 Node를 사용합니다.
76
+ Node는 소스에서도 설치가 가능하고, 이미 준비된 번들로도 설치가 가능합니다.
78
77
79
- 한번 설치를 하면, Angular레퍼지토리의 로컬 복사로 체크아웃을 하면 설치가 가능한 몇가지 npms(노드 패키지)가 필요할 것입니다. 다음을 통해서 체크아웃이
80
- 가능합니다:
78
+ 설치를 하고나면, Angular레포지토리의 로컬 복사를 통해서 체크아웃을 하면 설치할 수 있는 몇가지 npms(노드 패키지)가 필요할 것입니다. 다음을 통해서
79
+ 체크아웃이 가능합니다:
81
80
82
81
* `cd angular.js`
83
82
* `npm install`
84
83
85
- * {@link http://gruntjs.com Grunt}: 빌드 시스템으로 우리는 Grunt를 사용합니다. 다음으로 글로벌한 grunt 커멘드라인 툴을 설치하세요 :
84
+ * {@link http://gruntjs.com Grunt}: 우리는 빌드 시스템으로 Grunt를 사용합니다. 다음으로 글로벌한 grunt 커멘드라인 툴을 설치하십시오. :
86
85
87
86
* `sudo npm install -g grunt-cli`
88
87
89
88
90
89
## Github 계정 만들고, Angular 포크하기
91
90
92
- Github 계정을 만들기 위해서 다음 {@link https://github.com/signup/free here}을 따라하세요 .
93
- 순서대로, {@link http://help.github.com/forking fork} 와 {@link https://github.com/angular/angular.js main angular
91
+ Github 계정을 만들기 위해서 다음 {@link https://github.com/signup/free here}을 따라하십시오 .
92
+ 순서대로, {@link http://help.github.com/forking fork} 와 {@link https://github.com/angular/angular.js main angular
94
93
repository}를 계속 진행하십시오.
95
94
96
95
@@ -99,180 +98,171 @@ repository}를 계속 진행하십시오.
99
98
100
99
AngularJS를 빌드하기 위해서, 소스코드를 체크아웃하고, 축소판과 미축소판 AngularJS 파일을 만들기 위해서 Grunt를 사용하십시오.
101
100
102
- 1. 당신의 Github를 복제하기 위해서 다음을 실행하세요 :
101
+ 1. 당신의 Github를 복제하기 위해서 실행하십시오 :
103
102
104
103
git clone
[email protected] :<github username>/angular.js.git
105
104
106
- 2. AngularJS 디렉토리로 이동하기 위해서 다음을 실행하세요 :
105
+ 2. AngularJS 디렉토리로 이동하기 위해서 실행하십시오 :
107
106
108
107
cd angular.js
109
108
110
- 3. 메인 AngularJS 레포지토리를 당신의 레포지토리로의 원격 업스트립으로 추가하려면 다음을 실행하세요 :
109
+ 3. 메인 AngularJS 레포지토리를 당신의 레포지토리로의 원격 업스트립(upstream)으로 추가하려면 실행하십시오 :
111
110
112
111
git remote add upstream https://github.com/angular/angular.js.git
113
112
114
113
4. node.js dependency를 추가하기 위해서
115
114
116
115
npm install
117
116
118
- 5. AngularJS 빌드하기 위해서 다음을 실행하세요 :
117
+ 5. AngularJS 빌드하기 위해서 실행하십시오 :
119
118
120
119
grunt package
121
120
122
- 주의:
123
- NOTE: If you're using Windows you must run your command line with administrative privileges (right click, run as
124
- Administrator).
125
-
121
+ 주의: 윈도우 사용자의 경우, 커멘드라인을 관리자권한으로 실행하십시오. (오른쪽마우스 클릭, 관리자권한으로 실행)
126
122
127
- The build output can be located under the `build` directory. It consists of the following files and
128
- directories:
123
+ `build` 디렉토리에 빌드 결과물이 위치하게 됩니다. 이 폴더는 다음과 같은 디렉토리와 파일로 구성됩니다.
129
124
130
- * `angular-<version>.zip` — This is the complete zip file, which contains all of the release build
131
- artifacts.
125
+ * `angular-<version>.zip` — 이 파일은 빌드결과물의 모든 것들을 포함하는 완벽한 zip 파일입니다.
132
126
133
- * `angular.js` — The non-minified `angular` script .
127
+ * `angular.js` — 축소화 되지 않은 `angular` 스크립트 .
134
128
135
- * `angular.min.js` — The minified `angular` script .
129
+ * `angular.min.js` — 축소화된 `angular` 스크립트 .
136
130
137
- * `angular-scenario.js` — The `angular` End2End test runner .
131
+ * `angular-scenario.js` — `angular` End2End 테스트 실행자 .
138
132
139
- * `docs/` — A directory that contains all of the files needed to run `docs.angularjs.org` .
133
+ * `docs/` — `docs.angularjs.org`를 실행하기 위한 모든 필요 파일을 담고 있는 디렉토리 .
140
134
141
- * `docs/index.html` — The main page for the documentation .
135
+ * `docs/index.html` — 문서화를 위한 메인 페이지 .
142
136
143
- * `docs/docs-scenario.html` — The End2End test runner for the documentation application .
137
+ * `docs/docs-scenario.html` — 문서화 어플리케이션을 위한 End2End 테스트 실행자 .
144
138
145
139
146
140
<a name="webserver"></a>
147
- ## Running a Local Development Web Server
141
+ ## 로컬 개발 웹 서버 돌리기
148
142
149
- To debug code and run end-to-end tests, it is often useful to have a local HTTP server. For this purpose, we have
150
- made available a local web server based on Node.js .
143
+ 코드를 디버그하고, 단과단( end-to-end) 테스트를 실행하기 위해서, 로컬 HTTP서버를 사용하는 것이 종종 유용합니다. 이런 목적에서, 우리는 Node.js를
144
+ 기반으로 한 로컵웹서버가 가능하게 했습니다 .
151
145
152
- 1. To start the web server, run :
146
+ 1. 웹서버를 실행하기 위해서, 실행하십시오 :
153
147
154
148
grunt webserver
155
149
156
- 2. To access the local server, go to this website:
150
+ 2. 로컬서버에 접속하려면, 이 웹사이트로 가십시오.
157
151
158
152
http://localhost:8000/
159
153
160
- By default, it serves the contents of the AngularJS project directory .
154
+ 기본값으로, AngularJS 프로젝트 디렉토리의 내용을 제공합니다 .
161
155
162
156
163
157
<a name="unit-tests"></a>
164
- ## Running the Unit Test Suite
158
+ ## Unit Test Suite 실행하기
165
159
166
- Our unit and integration tests are written with Jasmine and executed with Testacular. To run all of the
167
- tests once on Chrome run:
160
+ 우리의 유닛과 통합 테스트는 Jasmine으로 쓰였으며, Testacular를 사용하여 실행됩니다. Chrome에서 한번에 모든 테스트를 실항해라면, 실행하십시오:
168
161
169
162
grunt test:unit
170
163
171
- To run the tests on other browsers (Chrome, ChromeCanary, Firefox, Opera and Safari are pre-configured) use :
164
+ 이런 테스트를 다른 브라우저에서 실행하시려면 (Chrome, ChromeCanary, Firefox, Opera and Safari는 이미 설정되어있음) 다음을 실행하십시오 :
172
165
173
166
grunt test:unit --browsers Opera,Firefox
174
167
175
- Note there should be _no spaces between browsers_ . `Opera, Firefox` is INVALID .
168
+ 브라우저사이에 공간이 없어야 한다는 점을 기억하세요 . `Opera, Firefox`는 유효하지 않습니다 .
176
169
177
- During development it's however more productive to continuously run unit tests every time the source or test files
178
- change. To execute tests in this mode run:
170
+ 하지만, 개발도중에는 소스 또는 테스트파일이 변경될 때마다 유닛테스트를 지속적으로 시행하는 것이 좀 더 생산성 있습니다. 이런 모드에서 테스트를 시행하려면:
179
171
180
- 1. To start the Testacular server, capture Chrome browser and run unit tests, run :
172
+ 1. Testacular서버를 가동하려면, 크롬 브라우저를 잡고, 유닛테스트를 실행하십시오 :
181
173
182
174
grunt autotest:jqlite
183
175
184
- 2. To capture more browsers, open this url in the desired browser (url might be different if you have multiple instance
185
- of Testacular running, read Testacular's console output for the correct url):
176
+ 2. 다른 브라우저를 잡으려면, 원하는 브라우저에서 다음 url을 여세요( 만약 다중 인스턴스로 Testacular을 실행한다면, url은 달라질 수 있습니다,
177
+ 정확한 url을 위해 Testacular의 콘솔 결과( output)을 확인하십시오.
186
178
187
179
http://localhost:9876/
188
180
189
- 3. To re-run tests just change any source or test file .
181
+ 3. 테스트를 재 실행하기 위해서는 어떤 소스든 아니면, 테스트 파일이든 그저 변경하시면 됩니다 .
190
182
191
183
192
- To learn more about all of the preconfigured Grunt tasks run :
184
+ 이미 정의된 Grunt task에 대해 배우기 위해서는 실행하십시오 :
193
185
194
186
grunt --help
195
187
196
188
197
- ## Running the end-to-end Test Suite
189
+ ## 단과단( end-to-end) Test Suite 실행하기
198
190
199
- To run the E2E test suite:
200
191
201
- 1. Start the local web server if it's not running already.
192
+ 단과단(E2E) test suite를 실행하기 위해서
193
+
194
+ 1. 이미 실행되고 있지 않다면, 로컬 웹 서버를 시작하십시오.
202
195
203
196
grunt webserver
204
197
205
- 2. In a browser, go to :
198
+ 2. 브라우저에서 다음으로 이동하십시오 :
206
199
207
200
http://localhost:8000/build/docs/docs-scenario.html
208
201
209
- or in terminal run :
202
+ 또는 터미널에서 실행하십시오 :
210
203
211
204
grunt test:end2end
212
205
213
- For convenience you can also simply run :
206
+ 편의를 위해서 간단하게 다음과 같이 실행할 수도 있습니다 :
214
207
215
208
grunt test:e2e
216
209
217
- This will start the webserver for you and run the tests .
210
+ 그럼 웹서버를 시작할 것이고, 테스트를 실행할 겁니다 .
218
211
219
212
220
213
221
214
<a name="H1_5"></a>
222
- # Submitting Your Changes
215
+ # 변경부분 제출하기
223
216
224
- To create and submit a change :
217
+ 변경하고, 제출하기 위해서 :
225
218
226
219
1. <a name="CLA"></a>
227
- Please sign our Contributor License Agreement (CLA) before sending pull requests. For any code changes to be
228
- accepted, the CLA must be signed. It's a quick process, we promise!
220
+ 풀 신청을 보내기전에 Contributor License Agreement (CLA)를 동의해주세요. 어떤 변경된 코드에 대해서 받아들여지려면 반듯이 CLA에 동의하셔야 합니다.
221
+ 우리가 보장하건데 금방 끝납니다.
229
222
230
- For individuals we have a [simple click-through form](http://code.google.com/legal/individual-cla-v1.0.html). For
231
- corporations we'll need you to
232
- [print, sign and one of scan+email, fax or mail the form](http://code.google.com/legal/corporate-cla-v1.0.html).
223
+ 개인개발자들을 위해서 우리는 [간단 클릭폼](http://code.google.com/legal/individual-cla-v1.0.html) 을 보유하고 있습니다. 사업자를의 경우,
224
+ [프린트, 싸인, 그리고 이메일 또는 스캔중에 하나를 팩스발송 또는 이메일로 보내주십시오](http://code.google.com/legal/corporate-cla-v1.0.html).
233
225
234
226
235
- 2. Create a new branch off the master for your changes:
227
+ 2. 변경을 위해서 마스터로부터 새로운 브랜치를 만드십시오.
236
228
237
229
git branch my-fix-branch
238
230
239
- 3. Check out the branch:
231
+ 3. 브랜치를 체크아웃( Check out)을 하십시오.
240
232
241
233
git checkout my-fix-branch
242
234
243
- 4. Create your patch, make sure to have plenty of tests (that pass) .
235
+ 4. 패치를 만드시고, 많은 테스트(패스를 한)를 만들어야 합니다 .
244
236
245
- 5. Commit your changes and create a descriptive commit message (the commit message is used to generate release notes,
246
- please check out our
247
- [commit message conventions](https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#)
248
- and our commit message presubmit hook `validate-commit-msg.js`):
237
+ 5. 변경을 커밋하시고, 설명적인 커밋 메세지를 만드세요( 커밋 메세ㅈ는 배포 노트 제작에 사용됩니다. 저희의 [커밋 메세지 규약]
238
+ (https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#)과 커밋 메세지 선접수된 고리
239
+ `validate-commit-msg.js`를 확인해주십시오.
249
240
250
241
git commit -a
251
242
252
- 6. Push your branch to Github:
243
+ 6. Github 에 당신의 브랜치를 푸시(push)하십시오..
253
244
254
245
git push origin my-fix-branch
255
246
256
- 7. In Github, send a pull request to `angular:master`.
257
-
247
+ 7. Github에서 `angular:master`로 풀(pull) 요청(request)을 보내십시오.
258
248
259
- 8. When the patch is reviewed and merged, delete your branch and pull yours — and other — changes
260
- from the main (upstream) repository:
249
+ 8. 패치가 검토되고, 머지(merge)되면, 당신의 브랜치를 지우고, 당신이 만든 것과 다른 사람이 만든 변경사항을 메인(upstream)레포지토리에서 풀(pull)
250
+ 받으십시오.
261
251
262
- 1. To delete the branch in Github, run :
252
+ 1. Github에서 브랜치를 삭제하려면, 실행하십시오 :
263
253
264
254
git push origin :my-fix-branch
265
255
266
- 2. To check out the master branch, run :
256
+ 2. 마스터브랜치를 체크아웃( check out)하려면, 실행하십시오 :
267
257
268
258
git checkout master
269
259
270
- 3. To delete a local branch, run :
260
+ 3. 로컬 브랜치를 삭제하기 위해서, 실행하십시오 :
271
261
272
262
git branch -D my-fix-branch
273
263
274
- 4. To update your master with the latest upstream version, run :
264
+ 4. 최신 upstream버전으로 당신의 마스터를 업데이트하려면, 실행하십시오 :
275
265
276
266
git pull --ff upstream master
277
267
278
- That's it! Thank you for your contribution !
268
+ 바로 이겁니다! 당신의 기여에 감사드립니다 !
0 commit comments