Translate "docs" menu as Korean #904

outsideris · 2016-09-18T09:47:14Z

Please review this @nodejs/nodejs-ko

outsideris · 2016-09-18T09:47:46Z

저희 저장소가 아니라 메뉴별로 하다보니 PR에 내용이 꽤 많습니다. 시간나실 때 천천히 봐주세요.

marocchino

locale/ko/docs/meta/topics/dependencies.md is not translated. consider remove this file.

I'm done.

marocchino · 2016-09-22T09:16:38Z

locale/ko/docs/es6.md

+* All **shipping** features, which V8 considers stable, are turned **on by default on Node.js** and do **NOT** require any kind of runtime flag.
+* **Staged** features, which are almost-completed features that are not considered stable by the V8 team, require a runtime flag: `--harmony`.
+* **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.
+-->


It will be safer add blank line around comment blocks. (unless you checked all pages.)
Some parser dose not handle this blocks properly.

I agree with you even though I checked all pages.

marocchino · 2016-09-22T09:18:12Z

locale/ko/docs/es6.md

+* **Staged** 기능은 거의 완성되었지만, V8 팀이 안정적이라고 간주하지 않은 기능으로
+  `--harmony` 런타임 플래그가 필요합니다.
+* **In progress** 기능은 각 하모니 플래그로 개별적으로 활성화할 수 있습니다. 테스트 목적이
+  아니라면 활성화하지 않기를 강력하게 권장한다. Note: 이 플래그는 V8에서 제공한 것으로


(for consistency)
권장한다 -> 권장합니다

marocchino · 2016-09-22T09:21:46Z

locale/ko/docs/es6.md

+-->
+## Node.js 버전에 어떤 기능이 기본적으로 포함되나요?
+
+[node.green](http://node.green) 웹사이트에서 Node.js의 다양한 버전에서 지원하는


This sentence has two 에서. I think it is confuse to someone.
How about this:

kangax의 호환성 표를 기반으로 만들어진 node.green 웹사이트에서 어떤 Node.js가 어떤 ECMAScript 기능을 지원하는지 쉽게..

이쪽 저장소지만 한글로 쓰셔도 될꺼라고 생각합니다. 한국어 리뷰라서요...(왠지 힘드시지 않을까 싶어서.)

..음.. 그럴까요?;

marocchino · 2016-09-22T09:22:47Z

locale/ko/docs/es6.md

+
+`--v8-options` 인자로 각 Node.js 릴리스에서 모든 *in progress* 기능의 리스트를 볼 수
+있습니다. 이 기능들은 완성되지 않았고 V8에서 제대로 돌아가지 않을 수도 있으므로 이 기능을 사용할 때는
+위험을 고려해야 함을 명심하세요.


위험을 고려해야 -> 위험을 감수해야

marocchino · 2016-09-22T09:27:41Z

locale/ko/docs/faq.md

+<!--
+## What is open source governance?
+
+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)


Is the democracy noun here? -3-
Weird.

의미는 "더 민주적으로 된다"정도로 이해했는데 좀더 좋은 문장이 있을까요?

네 의미상 부사일거라 생각했는데, democracy는 명사밖에 없네요. 이상하긴한데 변역은 틀리지 않은것 같습니다.

marocchino · 2016-09-22T21:59:28Z

locale/ko/docs/guides/working-with-different-filesystems.md

+비교하는지 볼 수 있다면 파일시스템을 탐구해야 합니다.) 예를 들어 대소문자 비구별은 단순한
+`toLowerCase()` 비교보다 훨씬 복잡합니다. 사실 `toUpperCase()`가 `toLowerCase()`보다
+보통 더 좋습니다.(`toLowerCase()`가 특정 외국어 문자를 다르게 다루기 때문입니다.) 하지만 모든
+파일시스템은 자신만의 대소문자 비교 테이블을 가지고 있으므로 더 좋은 방법을 쓰더라도 파일시스템을


더 좋은 방법을 쓰더라도 파일시스템을 탐구해야 합니다. -> 파일시스템을 탐구하는 것이 좋습니다.

marocchino · 2016-09-22T22:00:28Z

locale/ko/docs/index.md

+-->
+# 문서에 관해서
+
+이 웹사이트에는 세 가지 종류의 문서가 있다.


있다 -> 있습니다

marocchino · 2016-09-22T22:00:47Z

locale/ko/docs/index.md

+-->
+### API 레퍼런스 문서
+
+[API 레퍼런스 문서](/api/)에는 Node.js의 함수나 객체에 대한 자세한 정보가 있다.


있다 -> 있습니다

marocchino · 2016-09-22T22:01:00Z

locale/ko/docs/index.md

+
+[API 레퍼런스 문서](/api/)에는 Node.js의 함수나 객체에 대한 자세한 정보가 있다.
+이 문서에서 메서드가 어떤 인자를 받고 어떤 값을 반환하는지 해당 메서드와 관련된 에러에는 어떤 것이
+있는지를 알려준다. 다양한 Node.js에서 어떤 메서드를 사용할 수 있는지도 알려준다.


알려준다 -> 알려줍니다

marocchino · 2016-09-22T22:01:34Z

locale/ko/docs/index.md

+### 자주 묻는 질문
+
+[FAQ](/ko/docs/faq/)에서는 Node.js에 기여하는 방법, 행동강령과 거버넌스 모델,
+GitHub과 IRC에서 연락을 취하는 방법, 선별된 이슈로 돕는 방법 등을 다룬다.


다룬다 -> 다룹니다

outsideris · 2016-09-23T06:22:43Z

locale/ko/docs/meta/topics/dependencies.md

@@ -0,0 +1,102 @@
+---


아 이 파일은 포함된지 모르고 있었네요. 확인하고 빼던지 추가로 번역하든지 하겠습니다.

taggon · 2016-09-23T07:25:47Z

locale/ko/docs/es6.md

+* **Staged** 기능은 거의 완성되었지만, V8 팀이 안정적이라고 간주하지 않은 기능으로
+  `--harmony` 런타임 플래그가 필요합니다.
+* **In progress** 기능은 각 하모니 플래그로 개별적으로 활성화할 수 있습니다. 테스트 목적이
+  아니라면 활성화하지 않기를 강력하게 권장한다. Note: 이 플래그는 V8에서 제공한 것으로


권장한다 > 권장합니다.
Note: > 주의:

taggon · 2016-09-23T07:28:00Z

locale/ko/docs/es6.md

+-->
+## 어떤 기능이 진행 중입니까?
+
+V8 엔진에 계속해서 새로운 기능이 들어가고 있습니다. 대략 말하자면 시기는 알 수 없어도


들어가고 > 추가되고
로 변경하는 편이 더 자연스럽게 들릴 듯 합니다.

taggon · 2016-09-23T07:31:13Z

locale/ko/docs/es6.md

+## 어떤 기능이 진행 중입니까?
+
+V8 엔진에 계속해서 새로운 기능이 들어가고 있습니다. 대략 말하자면 시기는 알 수 없어도
+미래의 Node.js 릴리스에는 이 기능들이 들어온다고 할 수 있습니다.


정확한 시기는 알 수 없겠지만 앞으로 릴리스 할 Node.js에는 V8에 추가된 새 기능이 대체로 포함될 것입니다.

taggon · 2016-09-23T07:36:37Z

locale/ko/docs/faq.md

+지키고 [오픈 거버넌스](https://github.com/nodejs/node/blob/master/GOVERNANCE.md#readme)
+모델 하에 기여, 릴리스, 기여자를 운영합니다.
+
+[GitHub에 공개적으로 논의](https://github.com/nodejs/node/issues)를 하고 있고 우리는


말이 조금 어색해서 살짝 의역해보았습니다.

우선은 GitHub에서 공개적으로 이뤄지는 논의에 참여해보는 것도 좋습니다. 우리는 여러분의 피드백을 듣고 싶습니다.

taggon · 2016-09-23T07:41:56Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+이 문서의 목적은 Node.js HTTP 처리 과정을 잘 이해하게 하는 것입니다. 언어나 프로그래밍 환경과
+관계없이 상식선에서 HTTP 요청이 어떻게 동작하는지는 알고 있어야 합니다. Node.js의
+[`EventEmitters`][]와 [`Streams`][]에도 어느 정도 익숙해야 합니다. 만약 익숙하지 않다면
+이에 대한 API 문서를 훑어볼 필요가 있습니다.


익숙하지 않다면 관련 API 문서를 미리 훑어보는 편이 좋습니다.

만약과 ~면은 중복되는 표현이라 하나만 사용했습니다.

it's worth는 반드시 해야한다는 필요보다는 권장 수준으로 보는 게 좋을 것 같습니다.

이 문서를 읽기 전에 먼저 훑어보라는 뜻이라 문장이 자연스럽도록 "미리"를 임의로 추가했습니다만, 불필요하다 생각하면 빼셔도 괜찮습니다.

taggon · 2016-09-23T07:43:07Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+## 서버 생성
+
+모든 node 웹 서버 애플리케이션은 웹 서버 객체를 만들어야 합니다.
+이는 [`createServer`][]를 이용합니다.


이는 > 이 때

taggon · 2016-09-23T07:46:26Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+too, so consult the [API reference][].
+-->
+HTTP 요청이 서버에 오면 node가 트랜잭션을 다루려고 `request`과 `response` 객체로
+요청 핸들러 함수를 호출합니다. 곧 이 객체를 사용해 볼 것입니다.


객체로 함수를 호출한다는 표현이 애매합니다.
객체와 함께 또는 객체를 전달하며라고 바뀌어야 할 것 같습니다.

taggon · 2016-09-23T07:49:24Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+-->
+## 메서드, URL, 헤더
+
+아마 요청을 처리할 때 처음에는 메서드와 URL을 살펴보고자 할 것이므로 이에 적절한 작업을 할 수 있습니다.


요청을 처리할 때, 우선은 메서드와 URL을 확인한 후 이와 관련된 적절한 작업을 실행하려고 할 것입니다.

taggon · 2016-09-23T07:50:50Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+## 메서드, URL, 헤더
+
+아마 요청을 처리할 때 처음에는 메서드와 URL을 살펴보고자 할 것이므로 이에 적절한 작업을 할 수 있습니다.
+Node가 `request` 객체에 유용한 프로퍼티를 넣어두었으므로 비교적 쉽게 이 작업을 할 수 있습니다.


비교적 쉽게 이 작업을 할 수 있습니다. > 이 작업은 비교적 쉽게 할 수 있습니다.

로 바꾸는 편이 더 읽기 나은 것 같습니다.

taggon · 2016-09-23T07:53:16Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+```
+-->
+여기서 `method`는 항상 일반적인 HTTP 메서드/동사가 될 것입니다. `url`은 서버, 프로토콜,
+포트를 제외한 전체 URL입니다. 즉, URL의 세 번째 슬래시부터 모든 것을 담고 있습니다.


url은 전체 URL에서 서버, 프로토콜, 포트를 제외한 것으로, 세 번째 슬래시 이후의 나머지 전부라고 볼 수 있습니다.

outsideris · 2016-09-25T09:42:24Z

I've applied the reviews that you provided. I also translated meta/topics/dependencies.md even if I couldn't find any link to the document.

taggon · 2016-09-25T09:44:42Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+## 응답 바디 전송
+
+`response` 객체가 [`WritableStream`][]이므로 클라이언트에 응답 바디를 작성하는 것은
+일반적인 스트림 메서드를 사용하는 것과 같습니다.


response 객체는 WritableStream이므로 클라이언트로 보내는 응답 바디는 일반적인 스트림 메서드를 사용해서 작성합니다.

taggon · 2016-09-25T09:50:03Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+
+## 에코 서버 예제
+
+단순히 요청으로 받은 데이터를 바로 응답으로 돌려보내는 간단한 에코 서버를 만들기 위해 위의 예제를 간략화해보겠습니다. 앞에서 한 것과 비슷하게 요청 스트림에서 데이터를 가져와서 응답 스트림에 데이터를 작성하는 것이 전부입니다.


위의 예제를 간략하게 바꾸어 간단한 에코 서버를 만들어보겠습니다. 에코 서버는 요청받은 데이터를 그대로 응답으로 돌려보내는 서버입니다. 앞에서 했던 것처럼 요청 스트림에서 데이터를 가져와 응답 스트림에 쓰기만 하면 됩니다.

marocchino · 2016-09-25T23:37:53Z

locale/ko/docs/meta/topics/dependencies.md

+
+Node.js가 의존하고 있는 여러 의존성
+
+- [Libraries](#a-id-libraries-a)


목차와 타이틀이 일치했으면 좋겠습니다.

-- [Libraries](#a-id-libraries-a) +- [라이브러리](#libraries) -## <a id="Libraries">라이브러리</a> +## 라이브러리

오! 저렇게도 앵커가 되나요? 앵커가 안되서 저렇게 했던거거든요. 테스트하고 업데이트하겠습니다.

outsideris · 2016-10-01T13:53:28Z

@nodejs/nodejs-ko Sorry for being late. I changed it as the feedbacks. Please leave +1 or mark as approved if you don't have any concerns.

yous · 2016-10-01T14:06:48Z

locale/ko/docs/es6.md

+## --harmony 플래그를 사용하는 환경이 있습니다. 이를 제거해야 하나요?
+
+Node.js에서 `--harmony` 플래그의 현재 동작은 **staged** 기능만 활성화하는 것입니다. 결국,
+이는 `--es_staging`와 같은 의미입니다. 앞에서 말했듯이 이 기능은 완성되었지만, 아직 안정적이라고


--es_staging와 → --es_staging과

yous · 2016-10-01T14:10:46Z

locale/ko/docs/es6.md

+
+Node.js에서 `--harmony` 플래그의 현재 동작은 **staged** 기능만 활성화하는 것입니다. 결국,
+이는 `--es_staging`와 같은 의미입니다. 앞에서 말했듯이 이 기능은 완성되었지만, 아직 안정적이라고
+간주하지 않은 것입니다. 프로덕션 환경 등에서 안전하게 운영하고 싶다면 V8과 Node.js에서 기본적으로


아직 안정적이라고 간주하지 않은 것입니다

How about '아직 안정적이라고 볼 수는 없습니다'?

yous · 2016-10-01T14:13:20Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+HTTP 요청이 서버에 오면 node가 트랜잭션을 다루려고 `request`과 `response` 객체를 전달하며
+요청 핸들러 함수를 호출합니다. 곧 이 객체를 사용해 볼 것입니다.
+
+요청을 실제로 처리하려면 [`listen`][] 메서드가 `server` 객체에서 호출되어야 합니다.


메서드 → 메소드

Also there are several '메서드's elsewhere.

yous · 2016-10-01T14:17:53Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+클라이언트가 어떻게 헤더를 설정했는지에 관계없이 모든 헤더는 소문자로만 표현된다는 것을 기억해야 합니다.
+이는 어떤 목적이든 헤더를 파싱하는 작업을 간편하게 해줍니다.
+
+일부 헤더를 반복해서 설정한다면 이 값은 헤더에 따라 덮어써 지거나 콤마로 구분된 문자열로 합쳐집니다.


덮어써 지거나 → 덮어씌워지거나

Maybe '쉼표' instead of '콤마'? I'm okay with both.

yous · 2016-10-01T14:19:27Z

locale/ko/docs/guides/anatomy-of-an-http-transaction.md

+```
+
+> **주의:** 이 코드가 약간 장황할 수도 있고 대부분은 실제로 그렇습니다. 다행히 [`npm`][]에
+[`concat-stream`][]나 [`body`][]같은 모듈로 이 로직을 감출 수 있습니다. 이어서 읽기 전에


[body][]같은 → [body][] 같은

yous · 2016-10-01T14:34:49Z

locale/ko/docs/guides/simple-profiling.md

+[benefits of asynchronous programming]: https://nodesource.com/blog/why-asynchronous
+-->
+
+애플리케이션이 이제 초당 20 요청을 처리할 수 있게 되었습니다. 이는 동기 해시 생성을 사용한 것보다


20 요청을 → 20개의 요청을

yous · 2016-10-01T14:36:49Z

locale/ko/docs/guides/working-with-different-filesystems.md

+# 여러 파일 시스템에서 작업하기
+
+Node는 파일 시스템에서 다양한 기능을 제공합니다. 하지만 모든 파일 시스템이 같은 것은 아닙니다.
+여러 파일 시스템에서 동작할 때 코드를 간단하고 안전하게 유지하기 위한 베스트 프렉티스를


베스트 프렉티스를 → 모범 예제를, 좋은 예제를

yous · 2016-10-01T14:40:29Z

locale/ko/docs/index.md

+### API 레퍼런스 문서
+
+[API 레퍼런스 문서](/api/)에는 Node.js의 함수나 객체에 대한 자세한 정보가 있습니다.
+이 문서에서 메서드가 어떤 인자를 받고 어떤 값을 반환하는지 해당 메서드와 관련된 에러에는 어떤 것이


메서드 → 메소드

yous · 2016-10-01T14:41:10Z

locale/ko/docs/meta/topics/dependencies.md

+
+### libuv
+
+또 하나의 중요한 의존성은 libuv입니다. libuv는 C 라이브러리로 넌블락킹 I/O 작업을 지원하는


넌블락킹 → 논블로킹

yous · 2016-10-01T14:41:30Z

locale/ko/docs/meta/topics/dependencies.md

+### http-parser
+
+HTTP 파싱은 http-parser라는 경량 C 라이브러리가 처리합니다. 이는 시스템 호출이나 할당을 하려고
+만들어 진 것이 아니므로 요청당 아주 작은 메모리 공간만 차지합니다.


만들어 진 → 만들어진

outsideris · 2016-10-02T08:32:13Z

I updated it as the reviews.

marocchino · 2016-10-03T11:13:20Z

i18n looks fine to me. 👍

marocchino · 2016-10-03T11:15:03Z

And, 👍 for WG. It will be fine. :3

ghost · 2016-10-03T11:20:41Z

🎉

* upstream/master: outreachy: add myles' project add good first contributions to the outreachy page precede email addresses with mailto (nodejs#935) Translate "docs" menu as Korean (nodejs#904) nodejs-ja: Add about/index.md (nodejs#933) Revert "Blog: fix CVE ID for writeHead() bug / CVE-2016-5326" Blog: fix CVE ID for writeHead() bug / CVE-2016-5326 Add Education initiatives and Outreachy to Foundation section of website (nodejs#929)

outsideris added 2 commits September 18, 2016 18:45

translate "docs" menu as Korean

732e2bb

translate "guides" menu as Korean

9557751

marocchino changed the title ~~Translate "docc" menu as Korean~~ Translate "docs" menu as Korean Sep 22, 2016

marocchino reviewed Sep 22, 2016

View reviewed changes

marocchino added i18n Issues/PRs related to the Website Internationalisation needs WG +1 labels Sep 22, 2016

outsideris commented Sep 23, 2016

View reviewed changes

taggon reviewed Sep 23, 2016

View reviewed changes

taggon reviewed Sep 25, 2016

View reviewed changes

marocchino reviewed Sep 25, 2016

View reviewed changes

outsideris force-pushed the translate-docs-ko branch from ef2c35c to abb43e5 Compare October 1, 2016 13:51

yous reviewed Oct 1, 2016

View reviewed changes

apply reviews to Korean docs

fd086f7

outsideris force-pushed the translate-docs-ko branch from abb43e5 to fd086f7 Compare October 2, 2016 08:31

marocchino removed the needs i18n +1 label Oct 3, 2016

marocchino merged commit 6f24cea into nodejs:master Oct 3, 2016

marocchino removed the needs WG +1 label Oct 3, 2016

yous mentioned this pull request Jul 15, 2019

KO : Update working-with-different-filesystems.md #2339

Merged

yous mentioned this pull request Aug 5, 2019

KO : Update index.md #2359

Merged


		## 에코 서버 예제

		단순히 요청으로 받은 데이터를 바로 응답으로 돌려보내는 간단한 에코 서버를 만들기 위해 위의 예제를 간략화해보겠습니다. 앞에서 한 것과 비슷하게 요청 스트림에서 데이터를 가져와서 응답 스트림에 데이터를 작성하는 것이 전부입니다.


		Node.js가 의존하고 있는 여러 의존성

		- [Libraries](#a-id-libraries-a)


		### libuv

		또 하나의 중요한 의존성은 libuv입니다. libuv는 C 라이브러리로 넌블락킹 I/O 작업을 지원하는

Translate "docs" menu as Korean #904

Translate "docs" menu as Korean #904

Conversation

outsideris commented Sep 18, 2016

outsideris commented Sep 18, 2016

marocchino left a comment

Choose a reason for hiding this comment

marocchino Sep 22, 2016 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

outsideris commented Sep 25, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

outsideris commented Oct 1, 2016

Choose a reason for hiding this comment

Choose a reason for hiding this comment

yous Oct 1, 2016 • edited Loading

Choose a reason for hiding this comment

yous Oct 1, 2016 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

outsideris commented Oct 2, 2016

marocchino commented Oct 3, 2016

marocchino commented Oct 3, 2016

ghost commented Oct 3, 2016

marocchino Sep 22, 2016 •

edited

Loading

yous Oct 1, 2016 •

edited

Loading

yous Oct 1, 2016 •

edited

Loading