Skip to content

Commit 732e2bb

Browse files
committed
translate "docs" menu as Korean
1 parent 2d0fb3a commit 732e2bb

File tree

4 files changed

+328
-0
lines changed

4 files changed

+328
-0
lines changed

locale/ko/docs/es6.md

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
---
2+
title: ECMAScript 2015(ES6)와 그 다음
3+
layout: docs.hbs
4+
---
5+
<!--
6+
# ECMAScript 2015 (ES6) and beyond
7+
8+
Node.js is built against modern versions of [V8](https://developers.google.com/v8/). By keeping up-to-date with the latest releases of this engine, we ensure new features from the [JavaScript ECMA-262 specification](http://www.ecma-international.org/publications/standards/Ecma-262.htm) are brought to Node.js developers in a timely manner, as well as continued performance and stability improvements.
9+
10+
All ECMAScript 2015 (ES6) features are split into three groups for **shipping**, **staged**, and **in progress** features:
11+
12+
* All **shipping** features, which V8 considers stable, are turned **on by default on Node.js** and do **NOT** require any kind of runtime flag.
13+
* **Staged** features, which are almost-completed features that are not considered stable by the V8 team, require a runtime flag: `--harmony`.
14+
* **In progress** features can be activated individually by their respective harmony flag, although this is highly discouraged unless for testing purposes. Note: these flags are exposed by V8 and will potentially change without any deprecation notice.
15+
-->
16+
# ECMAScript 2015(ES6)와 그 다음
17+
18+
Node.js는 [V8](https://developers.google.com/v8/)의 최신 버전으로 만들었습니다.
19+
V8을 최신 릴리스로 유지하기 때문에 Node.js 개발자에게
20+
[JavaScript ECMA-262 명세](http://www.ecma-international.org/publications/standards/Ecma-262.htm)
21+
새로운 기능을 제때에 지원하면서 성능과 안정성 개선도 할 수 있습니다.
22+
23+
모든 ECMAScript 2015(ES6) 기능은 **shipping**, **staged**, **in progress** 기능의
24+
세 가지 그룹으로 나뉩니다.
25+
26+
* 모든 **shipping** 기능은 V8이 안정적이라고 간주한 것으로
27+
**Node.js에서는 기본적으로 켜져 있으므로** 런타임 플래그가 전혀 **필요 없습니다**.
28+
* **Staged** 기능은 거의 완성되었지만, V8 팀이 안정적이라고 간주하지 않은 기능으로
29+
`--harmony` 런타임 플래그가 필요합니다.
30+
* **In progress** 기능은 각 하모니 플래그로 개별적으로 활성화할 수 있습니다. 테스트 목적이
31+
아니라면 활성화하지 않기를 강력하게 권장한다. Note: 이 플래그는 V8에서 제공한 것으로
32+
폐기 공지 없이 변경될 수 있습니다.
33+
34+
<!--
35+
## Which features ship with which Node.js version by default?
36+
37+
The website [node.green](http://node.green) provides an excellent overview over supported ECMAScript features in various versions of Node.js, based on kangax's compat-table.
38+
-->
39+
## Node.js 버전에 어떤 기능이 기본적으로 포함되나요?
40+
41+
[node.green](http://node.green) 웹사이트에서 Node.js의 다양한 버전에서 지원하는
42+
ECMAScript 기능을 쉽게 파악할 수 있습니다. 이는 kangax의 호환성 표를 기반으로 만들어졌습니다.
43+
44+
<!--
45+
## Which features are in progress?
46+
47+
New features are constantly being added to the V8 engine. Generally speaking, expect them to land on a future Node.js release, although timing is unknown.
48+
49+
You may list all the *in progress* features available on each Node.js release by grepping through the `--v8-options` argument. Please note that these are incomplete and possibly broken features of V8, so use them at your own risk:
50+
51+
```bash
52+
node --v8-options | grep "in progress"
53+
```
54+
-->
55+
## 어떤 기능이 진행 중입니까?
56+
57+
V8 엔진에 계속해서 새로운 기능이 들어가고 있습니다. 대략 말하자면 시기는 알 수 없어도
58+
미래의 Node.js 릴리스에는 이 기능들이 들어온다고 할 수 있습니다.
59+
60+
`--v8-options` 인자로 각 Node.js 릴리스에서 모든 *in progress* 기능의 리스트를 볼 수
61+
있습니다. 이 기능들은 완성되지 않았고 V8에서 제대로 돌아가지 않을 수도 있으므로 이 기능을 사용할 때는
62+
위험을 고려해야 함을 명심하세요.
63+
64+
```bash
65+
node --v8-options | grep "in progress"
66+
```
67+
68+
<!--
69+
## I have my infrastructure set up to leverage the --harmony flag. Should I remove it?
70+
71+
The current behaviour of the `--harmony` flag on Node.js is to enable **staged** features only. After all, it is now a synonym of `--es_staging`. As mentioned above, these are completed features that have not been considered stable yet. If you want to play safe, especially on production environments, consider removing this runtime flag until it ships by default on V8 and, consequently, on Node.js. If you keep this enabled, you should be prepared for further Node.js upgrades to break your code if V8 changes their semantics to more closely follow the standard.
72+
-->
73+
## --harmony 플래그를 사용하는 환경이 있습니다. 이를 제거해야 하나요?
74+
75+
Node.js에서 `--harmony` 플래그의 현재 동작은 **staged** 기능만 활성화하는 것입니다. 결국,
76+
이는 `--es_staging`와 같은 의미입니다. 앞에서 말했듯이 이 기능은 완성되었지만, 아직 안정적이라고
77+
간주하지 않은 것입니다. 프로덕션 환경 등에서 안전하게 운영하고 싶다면 V8과 Node.js에서 기본적으로
78+
제공할 때까지 이 런타임 플래그를 제거하는 것을 고려해 보세요. 이 기능을 활성화한다면 차후 Node.js를
79+
업그레이드 할 때 V8이 이 기능의 의미를 표준에 더 가깝게 변경한 경우 코드가 깨질 수 있으므로
80+
대비해야 합니다.
81+
82+
<!--
83+
## How do I find which version of V8 ships with a particular version of Node.js?
84+
85+
Node.js provides a simple way to list all dependencies and respective versions that ship with a specific binary through the `process` global object. In case of the V8 engine, type the following in your terminal to retrieve its version:
86+
87+
```bash
88+
node -p process.versions.v8
89+
```
90+
-->
91+
## Node.js의 특정 버전에 포함된 V8의 버전을 어떻게 알 수 있나요?
92+
93+
Node.js에서는 `process` 전역 객체를 통해 특정 바이너리에 포함된 모든 의존성과 각 버전의 목록을
94+
쉽게 볼 수 있습니다. V8 엔진의 경우 터미널에서 다음 명령어를 실행하면 V8 버전을 볼 수 있습니다.
95+
96+
```bash
97+
node -p process.versions.v8
98+
```

locale/ko/docs/faq.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: FAQ
3+
layout: docs.hbs
4+
---
5+
<!--
6+
# FAQ
7+
8+
## How can I contribute?
9+
10+
Everyone can help. Node.js adheres to a [code of conduct](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-of-conduct), and contributions, releases, and contributorship are under an [open governance](https://github.com/nodejs/node/blob/master/GOVERNANCE.md#readme) model.
11+
12+
To get started, there are open [discussions on GitHub](https://github.com/nodejs/node/issues), and we'd love to hear your feedback. Becoming involved in discussions is a good way to get a feel of where you can help out further. If there is something there you feel you can tackle, please [make a pull request](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-contributions).
13+
-->
14+
# FAQ
15+
16+
## 어떻게 기여하나요?
17+
18+
누구나 참여할 수 있습니다. Node.js는
19+
[행동 강령](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-of-conduct)
20+
지키고 [오픈 거버넌스](https://github.com/nodejs/node/blob/master/GOVERNANCE.md#readme)
21+
모델 하에 기여, 릴리스, 기여자를 운영합니다.
22+
23+
[GitHub에 공개적으로 논의](https://github.com/nodejs/node/issues)를 하고 있고 우리는
24+
피드백을 듣기 원합니다. 논의에 참여하는 것은 무엇을 도울 수 있는지 찾는 좋은 방법입니다. 기여할 수 있는
25+
부분은 찾았다면
26+
[풀 리퀘스트를 올려주세요](https://github.com/nodejs/node/blob/master/CONTRIBUTING.md#code-contributions).
27+
28+
<!--
29+
## Where do discussions take place?
30+
31+
There is an #node.js channel on Freenode IRC. We keep logs of the channel [here](http://logs.libuv.org/node.js/latest).
32+
-->
33+
## 논의는 어디서 이뤄지나요?
34+
35+
Freenode IRC에 #node.js 채널이 있습니다. 채널의 대화 로그를
36+
[여기](http://logs.libuv.org/node.js/latest)에 저장해 두고 있습니다.
37+
38+
<!--
39+
## What is open source governance?
40+
41+
Open source governance advocates the application of the philosophies of the open source and open content movements in order to enable any interested party to add to the creation of the end product, as with a wiki document. Legislation is democratically opened to the general citizenry, employing their collective wisdom to benefit the decision-making process and improve democracy. [[source]](https://en.wikipedia.org/wiki/Open-source_governance)
42+
-->
43+
## 오픈 소스 거버넌스가 무엇인가요?
44+
45+
오픈 소스 거버넌스는 위키 문서처럼 관심 있는 사람이라면 누구나 최종 제품에 창작물을 추가할 수 있도록
46+
오픈 소스와 오픈 콘텐츠 운동의 철학을 지지합니다. 규칙은 모든 사람에게 민주적으로 열려있고 이들의
47+
집단 지성을 모아서 의사결정 과정을 돕고 민주주의를 개선합니다.
48+
[[출처]](https://en.wikipedia.org/wiki/Open-source_governance)

locale/ko/docs/index.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: 문서
3+
layout: docs.hbs
4+
labels:
5+
lts: LTS
6+
---
7+
8+
<!--
9+
# About Docs
10+
11+
There are three types of documentation available on this website:
12+
13+
* API reference documentation
14+
* ES6 features
15+
* Frequently asked questions
16+
-->
17+
# 문서에 관해서
18+
19+
이 웹사이트에는 세 가지 종류의 문서가 있다.
20+
21+
* API 레퍼런스 문서
22+
* ES6 기능
23+
* 자주 묻는 질문
24+
25+
<!--
26+
### API Reference Documentation
27+
28+
The [API reference documentation](/api/) provides detailed information about a function or object in Node.js. This documentation indicates what arguments a method accepts, the return value of that method, and what errors may be related to that method. It also indicates which methods are available for different versions of Node.js.
29+
30+
This documentation describes the built-in modules provided by Node.js. It does not document modules provided by the community.
31+
-->
32+
### API 레퍼런스 문서
33+
34+
[API 레퍼런스 문서](/api/)에는 Node.js의 함수나 객체에 대한 자세한 정보가 있다.
35+
이 문서에서 메서드가 어떤 인자를 받고 어떤 값을 반환하는지 해당 메서드와 관련된 에러에는 어떤 것이
36+
있는지를 알려준다. 다양한 Node.js에서 어떤 메서드를 사용할 수 있는지도 알려준다.
37+
38+
<!--
39+
<div class="highlight-box">
40+
<h4>Looking for API docs of previous releases?</h4>
41+
42+
<ul>
43+
<li><a href="https://nodejs.org/docs/latest-v5.x/api/">Node.js 5.x</a></li>
44+
<li><a href="https://nodejs.org/docs/latest-v0.12.x/api/">Node.js 0.12.x</a></li>
45+
<li><a href="https://nodejs.org/docs/latest-v0.10.x/api/">Node.js 0.10.x</a></li>
46+
<li><a href="https://nodejs.org/docs/">all versions</a></li>
47+
</ul>
48+
</div>
49+
-->
50+
<div class="highlight-box">
51+
<h4>이전 버전에 대한 API 문서가 필요한가요?</h4>
52+
53+
<ul>
54+
<li><a href="https://nodejs.org/docs/latest-v5.x/api/">Node.js 5.x</a></li>
55+
<li><a href="https://nodejs.org/docs/latest-v0.12.x/api/">Node.js 0.12.x</a></li>
56+
<li><a href="https://nodejs.org/docs/latest-v0.10.x/api/">Node.js 0.10.x</a></li>
57+
<li><a href="https://nodejs.org/docs/">모든 버전</a></li>
58+
</ul>
59+
</div>
60+
61+
<!--
62+
### ES6 Features
63+
64+
The [ES6 section](/en/docs/es6/) describes the three ES6 feature groups, and details which features are enabled by default in Node.js, alongside explanatory links. It also shows how to find which version of V8 shipped with a particular Node.js release.
65+
-->
66+
### ES6 기능
67+
68+
[ES6 부분](/ko/docs/es6/)에서는 세 가지 ES6 기능 그룹을 설명하고 Node.js에서 어떤 기능이
69+
기본적으로 활성화되어있는지 설명하면서 추가 링크를 제공합니다. 특정 Node.js 릴리스 버전에
70+
어떤 V8 버전이 포함되었는지 찾는 방법도 알려줍니다.
71+
72+
<!--
73+
### Frequently Asked Questions
74+
75+
The [FAQ](/en/docs/faq/) covers how everyone can contribute to Node.js, our code of conduct and governance model, how to get in touch on GitHub and IRC, and how to help out with triaging issues.
76+
-->
77+
### 자주 묻는 질문
78+
79+
[FAQ](/ko/docs/faq/)에서는 Node.js에 기여하는 방법, 행동강령과 거버넌스 모델,
80+
GitHub과 IRC에서 연락을 취하는 방법, 선별된 이슈로 돕는 방법 등을 다룬다.
Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
2+
title: Dependencies
3+
layout: docs.hbs
4+
---
5+
6+
# Dependencies
7+
8+
There are several dependencies that Node.js relies on to work the way it does.
9+
10+
- [Libraries](#Libraries)
11+
- [V8](#V8)
12+
- [libuv](#libuv)
13+
- [http-parser](#http-parser)
14+
- [c-ares](#c-ares)
15+
- [OpenSSL](#OpenSSL)
16+
- [zlib](#zlib)
17+
- [Tools](#Tools)
18+
- [npm](#npm)
19+
- [gyp](#gyp)
20+
- [gtest](#gtest)
21+
22+
## Libraries
23+
24+
### V8
25+
26+
The V8 library provides Node.js with a JavaScript engine, which Node.js
27+
controls via the V8 C++ API. V8 is maintained by Google, for use in Chrome.
28+
29+
- [Documentation](https://v8docs.nodesource.com/)
30+
31+
### libuv
32+
33+
Another important dependency is libuv, a C library that is used to abstract
34+
non-blocking I/O operations to a consistent interface across all supported
35+
platforms. It provides mechanisms to handle file system, DNS, network, child
36+
processes, pipes, signal handling, polling and streaming. It also includes a
37+
thread pool for offloading work for some things that can't be done
38+
asynchronously at the operating system level.
39+
40+
- [Documentation](http://docs.libuv.org/)
41+
42+
### http-parser
43+
44+
HTTP parsing is handled by a lightweight C library called http-parser. It is
45+
designed to not make any syscalls or allocations, so it has a very small
46+
per-request memory footprint.
47+
48+
- [Documentation](https://github.com/joyent/http-parser/)
49+
50+
### c-ares
51+
52+
For some asynchronous DNS requests, Node.js uses a C library called c-ares.
53+
It is exposed through the DNS module in JavaScript as the resolve() family of
54+
functions. The lookup() function, which is what the rest of core uses, makes
55+
use of threaded getaddrinfo(3) calls in libuv. The reason for this is that
56+
c-ares supports /etc/hosts, /etc/resolv.conf and /etc/svc.conf, but not things
57+
like mDNS.
58+
59+
- [Documentation](http://c-ares.haxx.se/docs.html)
60+
61+
### OpenSSL
62+
63+
OpenSSL is used extensively in both the `tls` and `crypto` modules. It provides
64+
battle-tested implementations of many cryptographic functions that the modern
65+
web relies on for security.
66+
67+
- [Documentation](https://www.openssl.org/docs/)
68+
69+
### zlib
70+
71+
For fast compression and decompression, Node.js relies on the industry-standard
72+
zlib library, also known for its use in gzip and libpng. Node.js uses zlib to
73+
create sync, async and streaming compression and decompression interfaces.
74+
75+
- [Documentation](http://www.zlib.net/manual.html)
76+
77+
## Tools
78+
79+
### npm
80+
81+
Node.js is all about modularity, and with that comes the need for a quality
82+
package manager; for this purpose, npm was made. With npm comes the largest
83+
selection of community-created packages of any programming ecosystem,
84+
which makes building Node.js apps quick and easy.
85+
86+
- [Documentation](https://docs.npmjs.com/)
87+
88+
### gyp
89+
90+
The build system is handled by gyp, a python-based project generator copied
91+
from V8. It can generate project files for use with build systems across many
92+
platforms. Node.js requires a build system because large parts of it — and its
93+
dependencies — are written in languages that require compilation.
94+
95+
- [Documentation](https://chromium.googlesource.com/external/gyp/+/master/docs/UserDocumentation.md)
96+
97+
### gtest
98+
99+
Native code can be tested using gtest, which is taken from Chromium. It allows
100+
testing C/C++ without needing an existing node executable to bootstrap from.
101+
102+
- [Documentation](https://code.google.com/p/googletest/wiki/V1_7_Documentation)

0 commit comments

Comments
 (0)