Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate Getting Started #39

Closed
wants to merge 0 commits into from
Closed

Conversation

ds-tothemoon
Copy link
Contributor

@ds-tothemoon ds-tothemoon commented Feb 20, 2019

Progress

  • 번역 초안 작성(Draft translation)
  • 공통 스타일 가이드 확인 (Check the common style guide)](link)
  • 용어 확인 (Check the term)](link)
  • 맞춤법 검사 (Spelling check)](http://speller.cs.pusan.ac.kr/)
  • 리뷰 반영 (Resolve reviews)

해당 Pull Request는 #50 에서 다시 시작합니다.

@tesseralis tesseralis mentioned this pull request Feb 20, 2019
98 tasks
Copy link
Member

@gnujoow gnujoow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

제목과 내용 사이에 빈칸이 빠진 곳이 있습니다.

수정부탁드려요.

content/docs/getting-started.md Outdated Show resolved Hide resolved
content/docs/getting-started.md Outdated Show resolved Hide resolved
content/docs/getting-started.md Outdated Show resolved Hide resolved
content/docs/getting-started.md Outdated Show resolved Hide resolved
content/docs/getting-started.md Outdated Show resolved Hide resolved
content/docs/getting-started.md Outdated Show resolved Hide resolved
content/docs/getting-started.md Outdated Show resolved Hide resolved
@netlify
Copy link

netlify bot commented Feb 21, 2019

Deploy preview for ko-reactjs-org ready!

Built with commit aae78ca

https://deploy-preview-39--ko-reactjs-org.netlify.com

test.md Outdated Show resolved Hide resolved
@reactjs reactjs deleted a comment from netlify bot Feb 22, 2019
@taehwanno
Copy link
Member

upstream과 sync되면서 master 브랜치의 모든 링크 주소가 https로 변경되어 직접 충돌 해결했습니다.

Copy link
Member

@gnujoow gnujoow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JavaScript 리소스까지 리뷰를 진행했습니다.

주술관계가 맞지 않고 읽었을 때 어색한 표현들이 종종 있는것 같네요. netify에 배포된 내용이나 view file 탭에 있는 내용을 한번 읽어보시면 좋을것 같아요 👍


If something is missing in the documentation or if you found some part confusing, please [file an issue for the documentation repository](https://github.com/reactjs/reactjs.org/issues/new) with your suggestions for improvement, or tweet at the [@reactjs account](https://twitter.com/reactjs). We love hearing from you!
이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[ 문서의 레퍼지토리] 

불필요한 공백이 있습니다.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

네 수정하였습니다.

@@ -18,109 +18,109 @@ redirect_from:
- "docs/environments.html"
---

This page is an overview of the React documentation and related resources.
이 페이지는 React 문서와 연관된 리소스의 개요입니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이 페이지는 React 문서 및 관련된 리소스의 개요입니다.

로 제안해봅니다. 번역해주신 내용은 페이지가 문서와 관련된 내용만 다루고 있는것으로 혼동될 여지가 있어보입니다.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

아 그렇네요. 감사합니다!

- [React 시도해보기](#try-react)
- [React 배우기](#learn-react)
- [지속적으로 정보 얻기](#staying-informed)
- [문서 버전](#versioned-documentation)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

버전 관리된 문서로 제안합니다. 올려주신 번역은 documentation version으로 잘 못 전달될 수 있습니다.

ref: https://github.com/reactjs/ja.reactjs.org/blob/master/content/docs/getting-started.md

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

넵 알겠습니다.

- [Something Missing?](#something-missing)
- [React 시도해보기](#try-react)
- [React 배우기](#learn-react)
- [지속적으로 정보 얻기](#staying-informed)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

React 소식 받기로 제안해봅니다.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

혹은 최신 React 소식 도 괜찮을 것 같구요...

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

의미상 최신 React 소식이 더 명확하게 이해되어서 최신 React 소식으로 고쳤습니다.


React has been designed from the start for gradual adoption, and **you can use as little or as much React as you need.** Whether you want to get a taste of React, add some interactivity to a simple HTML page, or start a complex React-powered app, the links in this section will help you get started.
React는 처음부터 점진적인 채택을 위해 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 해보거나 간단한 HTML 페이지에 약간의 쌍방향성을 추가하거나 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

React는 처음부터 점진적으로 적용할 수 있도록 설게되었으며 필요한 만큼 React를 사용할 수 있습니다. React를 맛보기로 접해보거나, 간단한 HTML 페이지에 대화형 기능(interactivity)를 추가하거나,  복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다.

채택이라는 단어가 혼선을 가져올 것 같아 점진적으로 적용할 수 있다로 제안해봅니다. interactivity 같은 경우에는 어떻게 번역되어도 어색한 느낌이 드는것 같아 영문 병기를 제안해봅니다.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

점진적인 채택을 위해 -> 점진적으로 적용할 수 있도록 으로 수정하였습니다.
쌍방향성 -> 대화형 기능(interactivity) 으로 수정하였습니다.

저도 이 부분에서 어떻게 해야할 지 고민하였는데, 말씀하신대로 영문 병기 하는 것이 가장 깔끔할 것 같습니다.


If you feel that the React documentation goes at a faster pace than you're comfortable with, check out [this overview of React by Tania Rascia](https://www.taniarascia.com/getting-started-with-react/). It introduces the most important React concepts in a detailed, beginner-friendly way. Once you're done, give the documentation another try!
React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그다음에 이 문서를 다시 봐주세요!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you feel that the React documentation goes at a faster pace than you're comfortable with,

React 문서를 읽는데 조금 어렵다고 생각된다면 으로 의역하는건 어떨까요?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

말씀해주신 피드백을 반영하여서

React 문서가 어렵게 느껴진다면, Tania Rascia가 쓴 React 개요를 먼저 보고 오시는 것이 좋습니다.

로 의역하였습니다.


If you're coming from a design background, [these resources](https://reactfordesigners.com/) are a great place to get started.
디자인을 위해서 왔다면 [이 리소스](https://reactfordesigners.com/)가 시작하기 좋습니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

디자인 분야에서 일하고 있다면 / 디자인 백그라운드를 가지고있다면(?)

If you're coming from a design background 이 목적이 아니라 읽는 사람의 배경을 설명하므로 위 중 하나로 번역하는게 맞다고 생각합니다.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

디자인 분야에서 일하고 있다면 이 조금 더 자연스럽게 읽혀서 수정하였습니다.


The React documentation assumes some familiarity with programming in the JavaScript language. You don't have to be an expert, but it's harder to learn both React and JavaScript at the same time.
React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

React 문서는 ~ 가정합니다. 주술관계가 잘 맞지않아보입니다.

React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 쓰여져있습니다.

위와 같이 제안해봅니다.


>Tip
>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

팁 앞에 불필요한 공백이 있습니다.


We recommend going through [this JavaScript overview](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript) to check your knowledge level. It will take you between 30 minutes and an hour but you will feel more confident learning React.
지식수준을 확인하려면 [이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽어보는 것을 추천합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

JavaScript 개요 문서를 읽고 Javascript 수준을 확인하는것을 권합니다.

로 제안해봅니다.

@taehwanno
Copy link
Member

@MDJuniooor master에 모든 링크가 http -> https로 변경되었습니다. 충돌 해결 부탁드릴게요.


If you prefer to **learn by doing,** check out our [practical tutorial](/tutorial/tutorial.html). In this tutorial, we build a tic-tac-toe game in React. You might be tempted to skip it because you're not building games -- but give it a chance. The techniques you'll learn in the tutorial are fundamental to building *any* React apps, and mastering it will give you a much deeper understanding.
**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 자습서](/tutorial/tutorial.html)을 살펴보세요. 본 자습서에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 조금만 기다려 보세요. 자습서에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다.

원문의 의미를 정확하게 담지 못한 것 같습니다. 아래와 같이 제안해봅니다.

게임 제작에는 관심이 없어서 이 자습서를 건너뛰고 싶은 마음이 들지도 모릅니다.


Many React users credit reading [Thinking in React](/docs/thinking-in-react.html) as the moment React finally "clicked" for them. It's probably the oldest React walkthrough but it's still just as relevant.
많은 React 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 신용합니다. 이것은 아마 가장 오래된 React 문서이지만 여전히 유용합니다.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

credit A as B: B를 A라고 여기다.
click: (불현듯) 분명해지다, 이해가 되다.

라는 뜻입니다.


This documentation section is useful when you want to learn more details about a particular React API. For example, [`React.Component` API reference](/docs/react-component.html) can provide you with details on how `setState()` works, and what different lifecycle methods are useful for.
이 문서 섹션은 특정 React API에 대한 자세한 내용을 알아보려는 경우에 유용합니다. 예를 들어, [`React.Component` API 참조](/docs/react-component.html)`setState()`가 어떻게 작동하는지와 다른 생명주기 메소드가 유용한 지에 대한 세부 정보를 제공합니다.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이 문서 섹션은 특정 React API를 자세히 알아보고 싶을 때 유용합니다. 예를 들어, React.Component API 참조에서는 setState()의 작동 방식과 각 상황에 알맞는 생명주기 메서드를 알 수 있습니다.

는 어떤가요?


This documentation always reflects the latest stable version of React. Since React 16, you can find older versions of the documentation [on a separate page](/versions). Note that documentation for past versions is snapshotted at the time of the release, and isn't being continuously updated.
이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

React 16부터는 이전 버전의 문서를...

@taehwanno
Copy link
Member

@MDJuniooor acd605c 잘못 커밋된 것 같습니다. 기존 변경사항을 revert하고 있는데 확인 부탁드립니다.

@ds-tothemoon
Copy link
Contributor Author

@taehwanno

revert 처리를 하는데 자꾸 에러가 납니다..
해결방법 좀 알려주실 수 있을까요.. ㅠㅠ

@taehwanno
Copy link
Member

taehwanno commented Feb 26, 2019

@MDJuniooor Fork 하신 후 master에 바로 커밋을 하는게 아니라 branch를 따로 생성하시는게 원래 저장소와 sync를 맞출 때 덜 위험해집니다. 제가 생각하기에 가장 안전한 방법으로는 c4f5394 커밋 기준으로 branch를 만들고 Pull Request를 다시 생성하는 방향이 좋을 것 같아요.

$ cd ko.reactjs.org       #  <-- Fork한 저장소를 의미합니다.
$ git checkout master
$ git checkout c4f5394
$ git checkout -b <new-branch-name>
$ git push -u origin <new-branch-name>

위 처럼 순서대로 터미널에서 실행 후 Pull Request를 다시 생성해주세요. 코멘트 남겨주시면 제가 새로운 PR로 연결시키고 현재 PR을 닫도록 하겠습니다.

@taehwanno
Copy link
Member

해당 Pull Request는 #50 에서 다시 시작합니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants