From 3634613aa567c868fd4dbad0686f085cfe78a3dc Mon Sep 17 00:00:00 2001 From: Uco Date: Wed, 20 Feb 2019 19:06:48 +0900 Subject: [PATCH 01/13] fisrt translation - only E -> K --- content/docs/getting-started.md | 113 +++++++++++++++----------------- 1 file changed, 54 insertions(+), 59 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 5625bb3cd..f3be5755b 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -1,6 +1,6 @@ --- id: getting-started -title: Getting Started +title: 시작하기 permalink: docs/getting-started.html next: add-react-to-a-website.html redirect_from: @@ -18,109 +18,104 @@ redirect_from: - "docs/environments.html" --- -This page is an overview of the React documentation and related resources. +이 페이지는 React 문서와 연관된 리소스의 개요입니다. -**React** is a JavaScript library for building user interfaces. Learn what React is all about on [our homepage](/) or [in the tutorial](/tutorial/tutorial.html). +**React** 는 사용자 인터페이스를 만들기 위한 JavaScript 라이브러리입니다. [홈페이지](/)나 [튜토리얼](/tutorial/tutorial.html)에서 React에 대한 모든 것을 알아보세요. --- -- [Try React](#try-react) -- [Learn React](#learn-react) -- [Staying Informed](#staying-informed) -- [Versioned Documentation](#versioned-documentation) -- [Something Missing?](#something-missing) +- [React 사용하기](#try-react) +- [React 배우기](#learn-react) +- [지속적으로 정보 얻기](#staying-informed) +- [문서 업데이트](#versioned-documentation) +- [누락된 항목이 있다면?](#something-missing) -## Try React {#try-react} +## React 사용하기 {#try-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 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. -### Online Playgrounds {#online-playgrounds} +### 온라인 플레이그라운드 {#online-playgrounds} +React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플라이그라운드를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. -If you're interested in playing around with React, you can use an online code playground. Try a Hello World template on [CodePen](codepen://hello-world) or [CodeSandbox](https://codesandbox.io/s/new). +가지고 있는 텍스트 에디터를 사용하려면, [이 HTML 파일을 다운로드](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)하고 편집한 다음 브라우저의 로컬 파일 시스템에서 열 수도 있습니다. 런타임 코드 변환이 느리므로 간단한 데모에만 이 코드를 사용하는 것이 좋습니다. -If you prefer to use your own text editor, you can also [download this HTML file](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), edit it, and open it from the local filesystem in your browser. It does a slow runtime code transformation, so we'd only recommend using this for simple demos. +### 웹사이트에 React를 추가하기 {#add-react-to-a-website} +[1분 안에 HTML 페이지에 React를 추가할 수 있습니다.](/docs/add-react-to-a-website.html) 그리고 점차적으로 React의 비중을 늘리거나 몇 개의 동적 위젯에 포함할 수 있습니다. -### Add React to a Website {#add-react-to-a-website} +### 새 React 앱 만들기 {#create-a-new-react-app} +React 프로젝트를 시작할 때는 [스크립트 태그를 사용한 간단한 HTML 페이지](/docs/create-a-new-react-app.html)가 여전히 최선의 선택일 수 있습니다. 설치하는 데 1분밖에 걸리지 않습니다! -You can [add React to an HTML page in one minute](/docs/add-react-to-a-website.html). You can then either gradually expand its presence, or keep it contained to a few dynamic widgets. +애플리케이션이 커지면 보다 통합된 설정을 고려하는 것이 좋습니다. 대규모 애플리케이션에 권장되는 [여러 개의 JavaScript 툴체인](/docs/create-a-new-react-app.html)이 있습니다. 각 구성 요소는 많은 설정 없이 작동할 수 있고 풍부한 React 에코시스템을 최대한 활용할 수 있습니다. -### Create a New React App {#create-a-new-react-app} +## React 배우기 {#learn-react} -When starting a React project, [a simple HTML page with script tags](/docs/add-react-to-a-website.html) might still be the best option. It only takes a minute to set up! +사람들은 다양한 배경과 다른 학습 스타일을 가지고 React에 입문합니다. 보다 이론적인 접근 방식을 선호하든 실용적인 접근 방식을 선호하든 이 섹션은 도움이 되기를 바랍니다. -As your application grows, you might want to consider a more integrated setup. There are [several JavaScript toolchains](/docs/create-a-new-react-app.html) we recommend for larger applications. Each of them can work with little to no configuration and lets you take full advantage of the rich React ecosystem. +* **직접 구현해보면서 학습하는 것**을 원하시는 경우, [실용적인 튜토리얼](/tutorial/tutorial.html)부터 시작하세요. +* **개념을 차근차근 익히며 학습하는 것**을 원하시는 경우, [주요 개념 가이드](/docs/hello-world.html)부터 시작하세요. -## Learn React {#learn-react} +다른 낯선 기술과 마찬가지로 React는 학습 곡선을 가지고 있습니다. 연습과 약간의 인내심을 가지고, React에 대한 요령을 익힐 것입니다. -People come to React from different backgrounds and with different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you'll find this section helpful. +### 첫번째 예제 {#first-examples} -* If you prefer to **learn by doing**, start with our [practical tutorial](/tutorial/tutorial.html). -* If you prefer to **learn concepts step by step**, start with our [guide to main concepts](/docs/hello-world.html). +[React 홈페이지](/)에는 실시간 편집기가 있는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. -Like any unfamiliar technology, React does have a learning curve. With practice and some patience, you *will* get the hang of it. +### 입문자를 위한 React {#react-for-beginners} -### First Examples {#first-examples} +React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그 다음 이 문서를 다시 봐주세요! -The [React homepage](/) contains a few small React examples with a live editor. Even if you don't know anything about React yet, try changing their code and see how it affects the result. +### 디자이너를 위한 React {#react-for-designers} -### React for Beginners {#react-for-beginners} +디자인을 위해서 왔다면 [이 리소스](http://reactfordesigners.com/)가 시작하기 좋습니다. -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! +### JavaScript 리소스 {#javascript-resources} -### React for Designers {#react-for-designers} +React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. -If you're coming from a design background, [these resources](http://reactfordesigners.com/) are a great place to get started. +지식 수준을 확인하려면 [이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽어보는 것을 추천합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. -### JavaScript Resources {#javascript-resources} - -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. +> 팁 +> +>JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](http://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. -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. ->Tip -> ->Whenever you get confused by something in JavaScript, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript) and [javascript.info](http://javascript.info/) are great websites to check. There are also [community support forums](/community/support.html) where you can ask for help. +### 실용적인 튜토리얼 {#practical-tutorial} -### Practical Tutorial {#practical-tutorial} +**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 튜토리얼](/tutorial/tutorial.html)을 살펴보세요. 본 튜토리얼에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 기회를 주세요. 튜토리얼에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. -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. -### Step-by-Step Guide {#step-by-step-guide} +### 단계별 가이드 {#step-by-step-guide} -If you prefer to **learn concepts step by step,** our [guide to main concepts](/docs/hello-world.html) is the best place to start. Every next chapter in it builds on the knowledge introduced in the previous chapters so you won't miss anything as you go along. +**개념을 단계별로 배우려면** [주요 개념 가이드](/docs/hello-world.html)를 시작하는 것이 가장 좋습니다. 모든 다음 장은 앞 장에 소개된 지식을 바탕으로 하기 때문에 이를 따라갈 때 어떤 것도 놓치지 않습니다. -### Thinking in React {#thinking-in-react} +### React에 대해 생각해 보기 {#thinking-in-react} -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 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 신용합니다. 이것은 아마 가장 오래된 React 설명서지만 여전히 의미가 있습니다. -### Recommended Courses {#recommended-courses} +### 권장 과정 {#recommended-courses} -Sometimes people find third-party books and video courses more helpful than the official documentation. We maintain [a list of commonly recommended resources](/community/courses.html), some of which are free. +사람들은 때때로 공식 문서보다 타사 책과 비디오 강좌가 더 도움이 된다고 생각합니다. 우리는 [일반적으로 권장되는 리소스 목록](/커뮤니티/코트.html)을 유지하며, 이 중 일부는 무료입니다. ### Advanced Concepts {#advanced-concepts} -Once you're comfortable with the [main concepts](#main-concepts) and played with React a little bit, you might be interested in more advanced topics. This section will introduce you to the powerful, but less commonly used React features like [context](/docs/context.html) and [refs](/docs/refs-and-the-dom.html). +[주요 개념](#main-concepts)에 익숙해지고 React를 조금 더 많이 다루게 되면 보다 고급 주제에 관심이 있을 수 있습니다. 이 섹션에서는 [context](/docs/context.html) 및 [refs](/docs/refs-and-dom.html)와 같이 강력하지만 일반적으로 사용되지 않는 React 기능을 소개합니다. -### API Reference {#api-reference} +### API 참조 {#api-reference} -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()`가 어떻게 작동하는지와 다른 생명주기 메소드가 유용한 지에 대한 세부 정보를 제공합니다. -### Glossary and FAQ {#glossary-and-faq} +### 용어 사전과 FAQ {#glossary-and-faq} -The [glossary](/docs/glossary.html) contains an overview of the most common terms you'll see in the React documentation. There is also a FAQ section dedicated to short questions and answers about common topics, including [making AJAX requests](/docs/faq-ajax.html), [component state](/docs/faq-state.html), and [file structure](/docs/faq-structure.html). +[용어 사전](/docs/glossary.html)에는 React 문서에 나타나는 가장 일반적인 용어의 개요가 포함되어 있습니다. 또한 [AJAX 요청 만들기](/docs/faq-ajax.html), [컴포넌트 상태](/docs/faq-state.html), [파일 구조](/docs/faq-structure.html) 등 일반적인 주제에 대한 짧은 질문과 답변을 전문으로 하는 FAQ 섹션도 있습니다. ## Staying Informed {#staying-informed} +[React 블로그](/blog/)는 React 팀의 업데이트에 대한 공식 소스입니다. 릴리즈 노트 또는 사용 자제 공지를 포함한 중요한 내용이 먼저 게시됩니다. -The [React blog](/blog/) is the official source for the updates from the React team. Anything important, including release notes or deprecation notices, will be posted there first. - -You can also follow the [@reactjs account](https://twitter.com/reactjs) on Twitter, but you won't miss anything essential if you only read the blog. - -Not every React release deserves its own blog post, but you can find a detailed changelog for every release [in the `CHANGELOG.md` file in the React repository](https://github.com/facebook/react/blob/master/CHANGELOG.md), as well as on the [Releases](https://github.com/facebook/react) page. - -## Versioned Documentation {#versioned-documentation} +모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리스에 대한 자세한 변경 기록을 확인할 수 있습니다. -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. -## Something Missing? {#something-missing} +## 문서 업데이트 {#versioned-documentation} +이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. -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! +## 누락된 항목이 있다면? {#something-missing} +이 문서에서 빠진 부분이나 혼동되는 부분을 찾으시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs account](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! From ae5548960351c140bc4397645fb002c4aab8040c Mon Sep 17 00:00:00 2001 From: Uco Date: Wed, 20 Feb 2019 19:42:49 +0900 Subject: [PATCH 02/13] modify typing error --- content/docs/getting-started.md | 35 ++++++++++++++++++--------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index f3be5755b..e58ab507a 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -20,7 +20,7 @@ redirect_from: 이 페이지는 React 문서와 연관된 리소스의 개요입니다. -**React** 는 사용자 인터페이스를 만들기 위한 JavaScript 라이브러리입니다. [홈페이지](/)나 [튜토리얼](/tutorial/tutorial.html)에서 React에 대한 모든 것을 알아보세요. +**React** 는 사용자 인터페이스를 만들기 위한 JavaScript 라이브러리입니다. [홈페이지](/)나 [자습서](/tutorial/tutorial.html)에서 React에 대한 모든 것을 알아보세요. --- @@ -30,12 +30,12 @@ redirect_from: - [문서 업데이트](#versioned-documentation) - [누락된 항목이 있다면?](#something-missing) -## React 사용하기 {#try-react} +## React 시도해보기 {#try-react} -React는 처음부터 점진적인 채택을 위해 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 해보거나, 간단한 HTML 페이지에 약간의 쌍방향성을 추가하거나, 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. +React는 처음부터 점진적인 채택을 위해 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 해보거나 간단한 HTML 페이지에 약간의 쌍방향성을 추가하거나 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. ### 온라인 플레이그라운드 {#online-playgrounds} -React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플라이그라운드를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. +React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플레이그라운드를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. 가지고 있는 텍스트 에디터를 사용하려면, [이 HTML 파일을 다운로드](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)하고 편집한 다음 브라우저의 로컬 파일 시스템에서 열 수도 있습니다. 런타임 코드 변환이 느리므로 간단한 데모에만 이 코드를 사용하는 것이 좋습니다. @@ -51,18 +51,18 @@ React 프로젝트를 시작할 때는 [스크립트 태그를 사용한 간단 사람들은 다양한 배경과 다른 학습 스타일을 가지고 React에 입문합니다. 보다 이론적인 접근 방식을 선호하든 실용적인 접근 방식을 선호하든 이 섹션은 도움이 되기를 바랍니다. -* **직접 구현해보면서 학습하는 것**을 원하시는 경우, [실용적인 튜토리얼](/tutorial/tutorial.html)부터 시작하세요. +* **직접 구현해보면서 학습하는 것**을 원하시는 경우, [실용적인 자습서](/tutorial/tutorial.html)부터 시작하세요. * **개념을 차근차근 익히며 학습하는 것**을 원하시는 경우, [주요 개념 가이드](/docs/hello-world.html)부터 시작하세요. 다른 낯선 기술과 마찬가지로 React는 학습 곡선을 가지고 있습니다. 연습과 약간의 인내심을 가지고, React에 대한 요령을 익힐 것입니다. -### 첫번째 예제 {#first-examples} +### 첫 번째 예제 {#first-examples} [React 홈페이지](/)에는 실시간 편집기가 있는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. ### 입문자를 위한 React {#react-for-beginners} -React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그 다음 이 문서를 다시 봐주세요! +React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그 다음에 이 문서를 다시 봐주세요! ### 디자이너를 위한 React {#react-for-designers} @@ -72,16 +72,16 @@ React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각 React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. -지식 수준을 확인하려면 [이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽어보는 것을 추천합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. +지식수준을 확인하려면 [이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽어보는 것을 추천합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. > 팁 > >JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](http://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. -### 실용적인 튜토리얼 {#practical-tutorial} +### 실용적인 자습서 {#practical-tutorial} -**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 튜토리얼](/tutorial/tutorial.html)을 살펴보세요. 본 튜토리얼에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 기회를 주세요. 튜토리얼에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. +**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 자습서](/tutorial/tutorial.html)을 살펴보세요. 본 자습서에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 기회를 주세요. 자습서에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. ### 단계별 가이드 {#step-by-step-guide} @@ -90,13 +90,13 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. ### React에 대해 생각해 보기 {#thinking-in-react} -React를 마지막으로 "클릭"하는 순간 많은 React 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 신용합니다. 이것은 아마 가장 오래된 React 설명서지만 여전히 의미가 있습니다. +React를 마지막으로 "클릭"하는 순간 많은 React 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 신용합니다. 이것은 아마 가장 오래된 React 설명서지만 여전히 유용합니다. ### 권장 과정 {#recommended-courses} -사람들은 때때로 공식 문서보다 타사 책과 비디오 강좌가 더 도움이 된다고 생각합니다. 우리는 [일반적으로 권장되는 리소스 목록](/커뮤니티/코트.html)을 유지하며, 이 중 일부는 무료입니다. +사람들은 때때로 공식 문서보다 타사 책과 비디오 강좌가 더 도움이 된다고 생각합니다. 우리는 [일반적으로 권장되는 리소스 목록](/community/courses.html)을 유지하며, 이 중 일부는 무료입니다. -### Advanced Concepts {#advanced-concepts} +### 고급 개념 {#advanced-concepts} [주요 개념](#main-concepts)에 익숙해지고 React를 조금 더 많이 다루게 되면 보다 고급 주제에 관심이 있을 수 있습니다. 이 섹션에서는 [context](/docs/context.html) 및 [refs](/docs/refs-and-dom.html)와 같이 강력하지만 일반적으로 사용되지 않는 React 기능을 소개합니다. @@ -108,14 +108,17 @@ React를 마지막으로 "클릭"하는 순간 많은 React 사용자는 [React [용어 사전](/docs/glossary.html)에는 React 문서에 나타나는 가장 일반적인 용어의 개요가 포함되어 있습니다. 또한 [AJAX 요청 만들기](/docs/faq-ajax.html), [컴포넌트 상태](/docs/faq-state.html), [파일 구조](/docs/faq-structure.html) 등 일반적인 주제에 대한 짧은 질문과 답변을 전문으로 하는 FAQ 섹션도 있습니다. -## Staying Informed {#staying-informed} +## 지속적인 정보 얻기 {#staying-informed} + [React 블로그](/blog/)는 React 팀의 업데이트에 대한 공식 소스입니다. 릴리즈 노트 또는 사용 자제 공지를 포함한 중요한 내용이 먼저 게시됩니다. -모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리스에 대한 자세한 변경 기록을 확인할 수 있습니다. +모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. ## 문서 업데이트 {#versioned-documentation} + 이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. ## 누락된 항목이 있다면? {#something-missing} -이 문서에서 빠진 부분이나 혼동되는 부분을 찾으시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs account](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! + +이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs account](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! From 7611f7c167e8909cfa5e0c3900208ecdb8d281e4 Mon Sep 17 00:00:00 2001 From: Uco Date: Wed, 20 Feb 2019 20:03:35 +0900 Subject: [PATCH 03/13] change awkward expression --- content/docs/getting-started.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index e58ab507a..a34d2057d 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -24,7 +24,7 @@ redirect_from: --- -- [React 사용하기](#try-react) +- [React 시도해보기](#try-react) - [React 배우기](#learn-react) - [지속적으로 정보 얻기](#staying-informed) - [문서 업데이트](#versioned-documentation) @@ -81,7 +81,7 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. ### 실용적인 자습서 {#practical-tutorial} -**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 자습서](/tutorial/tutorial.html)을 살펴보세요. 본 자습서에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 기회를 주세요. 자습서에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. +**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 자습서](/tutorial/tutorial.html)을 살펴보세요. 본 자습서에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 조금만 기다려 보세요. 자습서에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. ### 단계별 가이드 {#step-by-step-guide} @@ -90,7 +90,7 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. ### React에 대해 생각해 보기 {#thinking-in-react} -React를 마지막으로 "클릭"하는 순간 많은 React 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 신용합니다. 이것은 아마 가장 오래된 React 설명서지만 여전히 유용합니다. +많은 React 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 신용합니다. 이것은 아마 가장 오래된 React 문서이지만 여전히 유용합니다. ### 권장 과정 {#recommended-courses} From 1454a7b50fed84917ef63056a643909d3598ed11 Mon Sep 17 00:00:00 2001 From: Uco Date: Wed, 20 Feb 2019 20:06:10 +0900 Subject: [PATCH 04/13] change awkward expression 2 --- content/docs/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index a34d2057d..0f9697c63 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -27,7 +27,7 @@ redirect_from: - [React 시도해보기](#try-react) - [React 배우기](#learn-react) - [지속적으로 정보 얻기](#staying-informed) -- [문서 업데이트](#versioned-documentation) +- [문서 버전](#versioned-documentation) - [누락된 항목이 있다면?](#something-missing) ## React 시도해보기 {#try-react} @@ -115,7 +115,7 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. -## 문서 업데이트 {#versioned-documentation} +## 문서 버전 {#versioned-documentation} 이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. From 8f629e7a09d49b07258396bef1fc63de73c2ffc1 Mon Sep 17 00:00:00 2001 From: Uco Date: Fri, 22 Feb 2019 08:48:41 +0900 Subject: [PATCH 05/13] apply feedback --- content/docs/getting-started.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 0f9697c63..93768c4ec 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -20,7 +20,7 @@ redirect_from: 이 페이지는 React 문서와 연관된 리소스의 개요입니다. -**React** 는 사용자 인터페이스를 만들기 위한 JavaScript 라이브러리입니다. [홈페이지](/)나 [자습서](/tutorial/tutorial.html)에서 React에 대한 모든 것을 알아보세요. +**React**는 사용자 인터페이스를 만들기 위한 JavaScript 라이브러리입니다. [홈페이지](/)나 [자습서](/tutorial/tutorial.html)에서 React에 대한 모든 것을 알아보세요. --- @@ -28,21 +28,24 @@ redirect_from: - [React 배우기](#learn-react) - [지속적으로 정보 얻기](#staying-informed) - [문서 버전](#versioned-documentation) -- [누락된 항목이 있다면?](#something-missing) +- [빠진 항목이 있다면?](#something-missing) ## React 시도해보기 {#try-react} React는 처음부터 점진적인 채택을 위해 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 해보거나 간단한 HTML 페이지에 약간의 쌍방향성을 추가하거나 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. ### 온라인 플레이그라운드 {#online-playgrounds} + React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플레이그라운드를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. 가지고 있는 텍스트 에디터를 사용하려면, [이 HTML 파일을 다운로드](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)하고 편집한 다음 브라우저의 로컬 파일 시스템에서 열 수도 있습니다. 런타임 코드 변환이 느리므로 간단한 데모에만 이 코드를 사용하는 것이 좋습니다. ### 웹사이트에 React를 추가하기 {#add-react-to-a-website} -[1분 안에 HTML 페이지에 React를 추가할 수 있습니다.](/docs/add-react-to-a-website.html) 그리고 점차적으로 React의 비중을 늘리거나 몇 개의 동적 위젯에 포함할 수 있습니다. + +[1분 안에 HTML 페이지에 React를 추가할 수 있습니다.](/docs/add-react-to-a-website.html) 그리고 조금씩 React의 비중을 늘리거나 몇 개의 동적 위젯에 포함할 수 있습니다. ### 새 React 앱 만들기 {#create-a-new-react-app} + React 프로젝트를 시작할 때는 [스크립트 태그를 사용한 간단한 HTML 페이지](/docs/create-a-new-react-app.html)가 여전히 최선의 선택일 수 있습니다. 설치하는 데 1분밖에 걸리지 않습니다! 애플리케이션이 커지면 보다 통합된 설정을 고려하는 것이 좋습니다. 대규모 애플리케이션에 권장되는 [여러 개의 JavaScript 툴체인](/docs/create-a-new-react-app.html)이 있습니다. 각 구성 요소는 많은 설정 없이 작동할 수 있고 풍부한 React 에코시스템을 최대한 활용할 수 있습니다. @@ -62,7 +65,7 @@ React 프로젝트를 시작할 때는 [스크립트 태그를 사용한 간단 ### 입문자를 위한 React {#react-for-beginners} -React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그 다음에 이 문서를 다시 봐주세요! +React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그다음에 이 문서를 다시 봐주세요! ### 디자이너를 위한 React {#react-for-designers} @@ -119,6 +122,6 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. -## 누락된 항목이 있다면? {#something-missing} +## 빠진 항목이 있다면? {#something-missing} 이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs account](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! From 181bd4b6449efa303d6bb8893bb903fff530061f Mon Sep 17 00:00:00 2001 From: Uco Date: Fri, 22 Feb 2019 12:17:52 +0900 Subject: [PATCH 06/13] adjust integrity MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit remove empty line 84, 89 add line 116~117 translate account -> 계정 --- content/docs/getting-started.md | 6 +- test.md | 126 ++++++++++++++++++++++++++++++++ 2 files changed, 129 insertions(+), 3 deletions(-) create mode 100644 test.md diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 93768c4ec..bc730cf3f 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -81,12 +81,10 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. > >JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](http://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. - ### 실용적인 자습서 {#practical-tutorial} **직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 자습서](/tutorial/tutorial.html)을 살펴보세요. 본 자습서에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 조금만 기다려 보세요. 자습서에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. - ### 단계별 가이드 {#step-by-step-guide} **개념을 단계별로 배우려면** [주요 개념 가이드](/docs/hello-world.html)를 시작하는 것이 가장 좋습니다. 모든 다음 장은 앞 장에 소개된 지식을 바탕으로 하기 때문에 이를 따라갈 때 어떤 것도 놓치지 않습니다. @@ -115,6 +113,8 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. [React 블로그](/blog/)는 React 팀의 업데이트에 대한 공식 소스입니다. 릴리즈 노트 또는 사용 자제 공지를 포함한 중요한 내용이 먼저 게시됩니다. +트위터의 [@reactjs 계정](https://twitter.com/reactjs)을 팔로우할 수도 있지만, 블로그만 읽어도 필수적인 것은 놓치지 않을 수 있습니다. + 모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. @@ -124,4 +124,4 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. ## 빠진 항목이 있다면? {#something-missing} -이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs account](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! +이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! diff --git a/test.md b/test.md new file mode 100644 index 000000000..5625bb3cd --- /dev/null +++ b/test.md @@ -0,0 +1,126 @@ +--- +id: getting-started +title: Getting Started +permalink: docs/getting-started.html +next: add-react-to-a-website.html +redirect_from: + - "docs/" + - "docs/index.html" + - "docs/getting-started-ko-KR.html" + - "docs/getting-started-zh-CN.html" + - "docs/installation.html" + - "download.html" + - "downloads.html" + - "docs/try-react.html" + - "docs/tooling-integration.html" + - "docs/package-management.html" + - "docs/language-tooling.html" + - "docs/environments.html" +--- + +This page is an overview of the React documentation and related resources. + +**React** is a JavaScript library for building user interfaces. Learn what React is all about on [our homepage](/) or [in the tutorial](/tutorial/tutorial.html). + +--- + +- [Try React](#try-react) +- [Learn React](#learn-react) +- [Staying Informed](#staying-informed) +- [Versioned Documentation](#versioned-documentation) +- [Something Missing?](#something-missing) + +## Try React {#try-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. + +### Online Playgrounds {#online-playgrounds} + +If you're interested in playing around with React, you can use an online code playground. Try a Hello World template on [CodePen](codepen://hello-world) or [CodeSandbox](https://codesandbox.io/s/new). + +If you prefer to use your own text editor, you can also [download this HTML file](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), edit it, and open it from the local filesystem in your browser. It does a slow runtime code transformation, so we'd only recommend using this for simple demos. + +### Add React to a Website {#add-react-to-a-website} + +You can [add React to an HTML page in one minute](/docs/add-react-to-a-website.html). You can then either gradually expand its presence, or keep it contained to a few dynamic widgets. + +### Create a New React App {#create-a-new-react-app} + +When starting a React project, [a simple HTML page with script tags](/docs/add-react-to-a-website.html) might still be the best option. It only takes a minute to set up! + +As your application grows, you might want to consider a more integrated setup. There are [several JavaScript toolchains](/docs/create-a-new-react-app.html) we recommend for larger applications. Each of them can work with little to no configuration and lets you take full advantage of the rich React ecosystem. + +## Learn React {#learn-react} + +People come to React from different backgrounds and with different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you'll find this section helpful. + +* If you prefer to **learn by doing**, start with our [practical tutorial](/tutorial/tutorial.html). +* If you prefer to **learn concepts step by step**, start with our [guide to main concepts](/docs/hello-world.html). + +Like any unfamiliar technology, React does have a learning curve. With practice and some patience, you *will* get the hang of it. + +### First Examples {#first-examples} + +The [React homepage](/) contains a few small React examples with a live editor. Even if you don't know anything about React yet, try changing their code and see how it affects the result. + +### React for Beginners {#react-for-beginners} + +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 for Designers {#react-for-designers} + +If you're coming from a design background, [these resources](http://reactfordesigners.com/) are a great place to get started. + +### JavaScript Resources {#javascript-resources} + +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. + +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. + +>Tip +> +>Whenever you get confused by something in JavaScript, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript) and [javascript.info](http://javascript.info/) are great websites to check. There are also [community support forums](/community/support.html) where you can ask for help. + +### Practical Tutorial {#practical-tutorial} + +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. + +### Step-by-Step Guide {#step-by-step-guide} + +If you prefer to **learn concepts step by step,** our [guide to main concepts](/docs/hello-world.html) is the best place to start. Every next chapter in it builds on the knowledge introduced in the previous chapters so you won't miss anything as you go along. + +### Thinking in React {#thinking-in-react} + +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. + +### Recommended Courses {#recommended-courses} + +Sometimes people find third-party books and video courses more helpful than the official documentation. We maintain [a list of commonly recommended resources](/community/courses.html), some of which are free. + +### Advanced Concepts {#advanced-concepts} + +Once you're comfortable with the [main concepts](#main-concepts) and played with React a little bit, you might be interested in more advanced topics. This section will introduce you to the powerful, but less commonly used React features like [context](/docs/context.html) and [refs](/docs/refs-and-the-dom.html). + +### API Reference {#api-reference} + +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. + +### Glossary and FAQ {#glossary-and-faq} + +The [glossary](/docs/glossary.html) contains an overview of the most common terms you'll see in the React documentation. There is also a FAQ section dedicated to short questions and answers about common topics, including [making AJAX requests](/docs/faq-ajax.html), [component state](/docs/faq-state.html), and [file structure](/docs/faq-structure.html). + +## Staying Informed {#staying-informed} + +The [React blog](/blog/) is the official source for the updates from the React team. Anything important, including release notes or deprecation notices, will be posted there first. + +You can also follow the [@reactjs account](https://twitter.com/reactjs) on Twitter, but you won't miss anything essential if you only read the blog. + +Not every React release deserves its own blog post, but you can find a detailed changelog for every release [in the `CHANGELOG.md` file in the React repository](https://github.com/facebook/react/blob/master/CHANGELOG.md), as well as on the [Releases](https://github.com/facebook/react) page. + +## Versioned Documentation {#versioned-documentation} + +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. + +## Something Missing? {#something-missing} + +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! From 2cac0f073bb0c024c3393a9965c036ca40b4622d Mon Sep 17 00:00:00 2001 From: Uco Date: Fri, 22 Feb 2019 12:23:12 +0900 Subject: [PATCH 07/13] delete empty line --- content/docs/getting-started.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index bc730cf3f..6f42d1452 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -117,7 +117,6 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. - ## 문서 버전 {#versioned-documentation} 이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. From 61485ccb1b0179ff0423c3ff1a452a9c13f01954 Mon Sep 17 00:00:00 2001 From: Uco Date: Fri, 22 Feb 2019 12:23:56 +0900 Subject: [PATCH 08/13] Delete test.md --- test.md | 126 -------------------------------------------------------- 1 file changed, 126 deletions(-) delete mode 100644 test.md diff --git a/test.md b/test.md deleted file mode 100644 index 5625bb3cd..000000000 --- a/test.md +++ /dev/null @@ -1,126 +0,0 @@ ---- -id: getting-started -title: Getting Started -permalink: docs/getting-started.html -next: add-react-to-a-website.html -redirect_from: - - "docs/" - - "docs/index.html" - - "docs/getting-started-ko-KR.html" - - "docs/getting-started-zh-CN.html" - - "docs/installation.html" - - "download.html" - - "downloads.html" - - "docs/try-react.html" - - "docs/tooling-integration.html" - - "docs/package-management.html" - - "docs/language-tooling.html" - - "docs/environments.html" ---- - -This page is an overview of the React documentation and related resources. - -**React** is a JavaScript library for building user interfaces. Learn what React is all about on [our homepage](/) or [in the tutorial](/tutorial/tutorial.html). - ---- - -- [Try React](#try-react) -- [Learn React](#learn-react) -- [Staying Informed](#staying-informed) -- [Versioned Documentation](#versioned-documentation) -- [Something Missing?](#something-missing) - -## Try React {#try-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. - -### Online Playgrounds {#online-playgrounds} - -If you're interested in playing around with React, you can use an online code playground. Try a Hello World template on [CodePen](codepen://hello-world) or [CodeSandbox](https://codesandbox.io/s/new). - -If you prefer to use your own text editor, you can also [download this HTML file](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html), edit it, and open it from the local filesystem in your browser. It does a slow runtime code transformation, so we'd only recommend using this for simple demos. - -### Add React to a Website {#add-react-to-a-website} - -You can [add React to an HTML page in one minute](/docs/add-react-to-a-website.html). You can then either gradually expand its presence, or keep it contained to a few dynamic widgets. - -### Create a New React App {#create-a-new-react-app} - -When starting a React project, [a simple HTML page with script tags](/docs/add-react-to-a-website.html) might still be the best option. It only takes a minute to set up! - -As your application grows, you might want to consider a more integrated setup. There are [several JavaScript toolchains](/docs/create-a-new-react-app.html) we recommend for larger applications. Each of them can work with little to no configuration and lets you take full advantage of the rich React ecosystem. - -## Learn React {#learn-react} - -People come to React from different backgrounds and with different learning styles. Whether you prefer a more theoretical or a practical approach, we hope you'll find this section helpful. - -* If you prefer to **learn by doing**, start with our [practical tutorial](/tutorial/tutorial.html). -* If you prefer to **learn concepts step by step**, start with our [guide to main concepts](/docs/hello-world.html). - -Like any unfamiliar technology, React does have a learning curve. With practice and some patience, you *will* get the hang of it. - -### First Examples {#first-examples} - -The [React homepage](/) contains a few small React examples with a live editor. Even if you don't know anything about React yet, try changing their code and see how it affects the result. - -### React for Beginners {#react-for-beginners} - -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 for Designers {#react-for-designers} - -If you're coming from a design background, [these resources](http://reactfordesigners.com/) are a great place to get started. - -### JavaScript Resources {#javascript-resources} - -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. - -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. - ->Tip -> ->Whenever you get confused by something in JavaScript, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript) and [javascript.info](http://javascript.info/) are great websites to check. There are also [community support forums](/community/support.html) where you can ask for help. - -### Practical Tutorial {#practical-tutorial} - -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. - -### Step-by-Step Guide {#step-by-step-guide} - -If you prefer to **learn concepts step by step,** our [guide to main concepts](/docs/hello-world.html) is the best place to start. Every next chapter in it builds on the knowledge introduced in the previous chapters so you won't miss anything as you go along. - -### Thinking in React {#thinking-in-react} - -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. - -### Recommended Courses {#recommended-courses} - -Sometimes people find third-party books and video courses more helpful than the official documentation. We maintain [a list of commonly recommended resources](/community/courses.html), some of which are free. - -### Advanced Concepts {#advanced-concepts} - -Once you're comfortable with the [main concepts](#main-concepts) and played with React a little bit, you might be interested in more advanced topics. This section will introduce you to the powerful, but less commonly used React features like [context](/docs/context.html) and [refs](/docs/refs-and-the-dom.html). - -### API Reference {#api-reference} - -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. - -### Glossary and FAQ {#glossary-and-faq} - -The [glossary](/docs/glossary.html) contains an overview of the most common terms you'll see in the React documentation. There is also a FAQ section dedicated to short questions and answers about common topics, including [making AJAX requests](/docs/faq-ajax.html), [component state](/docs/faq-state.html), and [file structure](/docs/faq-structure.html). - -## Staying Informed {#staying-informed} - -The [React blog](/blog/) is the official source for the updates from the React team. Anything important, including release notes or deprecation notices, will be posted there first. - -You can also follow the [@reactjs account](https://twitter.com/reactjs) on Twitter, but you won't miss anything essential if you only read the blog. - -Not every React release deserves its own blog post, but you can find a detailed changelog for every release [in the `CHANGELOG.md` file in the React repository](https://github.com/facebook/react/blob/master/CHANGELOG.md), as well as on the [Releases](https://github.com/facebook/react) page. - -## Versioned Documentation {#versioned-documentation} - -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. - -## Something Missing? {#something-missing} - -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! From 1289a17efe23553fc37b9c6cc790ee5ff1730e04 Mon Sep 17 00:00:00 2001 From: Uco Date: Fri, 22 Feb 2019 12:44:00 +0900 Subject: [PATCH 09/13] delete unnecessary blank --- content/docs/getting-started.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 6f42d1452..a504a26a9 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -61,7 +61,7 @@ React 프로젝트를 시작할 때는 [스크립트 태그를 사용한 간단 ### 첫 번째 예제 {#first-examples} -[React 홈페이지](/)에는 실시간 편집기가 있는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. +[React 홈페이지](/)에는 실시간 편집기가 있는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. ### 입문자를 위한 React {#react-for-beginners} @@ -123,4 +123,4 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. ## 빠진 항목이 있다면? {#something-missing} -이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [ 문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! +이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! From 7560cdd681c156c0044a431b7d7c18d54ddb19fc Mon Sep 17 00:00:00 2001 From: Uco Date: Tue, 26 Feb 2019 20:44:46 +0900 Subject: [PATCH 10/13] apply feedback --- content/docs/getting-started.md | 38 ++++++++++++++++----------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index a504a26a9..1e0a86b24 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -18,7 +18,7 @@ redirect_from: - "docs/environments.html" --- -이 페이지는 React 문서와 연관된 리소스의 개요입니다. +이 페이지는 React 문서 및 관련된 리소스의 개요입니다. **React**는 사용자 인터페이스를 만들기 위한 JavaScript 라이브러리입니다. [홈페이지](/)나 [자습서](/tutorial/tutorial.html)에서 React에 대한 모든 것을 알아보세요. @@ -26,19 +26,19 @@ redirect_from: - [React 시도해보기](#try-react) - [React 배우기](#learn-react) -- [지속적으로 정보 얻기](#staying-informed) -- [문서 버전](#versioned-documentation) +- [최신 React 소식](#staying-informed) +- [버전 관리된 문서](#versioned-documentation) - [빠진 항목이 있다면?](#something-missing) ## React 시도해보기 {#try-react} -React는 처음부터 점진적인 채택을 위해 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 해보거나 간단한 HTML 페이지에 약간의 쌍방향성을 추가하거나 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. +React는 처음부터 점진적으로 적용할 수 있도록 설계되었으며 **필요한 만큼 React를 사용할 수 있습니다.** React를 맛보기로 접해보거나 간단한 HTML 페이지에 약간의 대화형 기능(interactivity)을 추가하거나 복잡한 React 기반의 앱을 시작하고자 하는 경우, 이 섹션의 링크를 통해 시작할 수 있습니다. ### 온라인 플레이그라운드 {#online-playgrounds} -React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플레이그라운드를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. +React를 사용하는데 관심이 있다면, 온라인 코드 편집기를 사용할 수 있습니다. [CodePen](codepen://hello-world) 이나 [CodeSandbox](https://codesandbox.io/s/new)에서 Hello World 템플릿을 사용해 보세요. -가지고 있는 텍스트 에디터를 사용하려면, [이 HTML 파일을 다운로드](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)하고 편집한 다음 브라우저의 로컬 파일 시스템에서 열 수도 있습니다. 런타임 코드 변환이 느리므로 간단한 데모에만 이 코드를 사용하는 것이 좋습니다. +여러분이 사용하고 있는 코드 편집기를 사용하길 원한다면, [이 HTML 파일을 다운로드](https://raw.githubusercontent.com/reactjs/reactjs.org/master/static/html/single-file-example.html)하고 편집한 다음 브라우저의 로컬 파일 시스템에서 열 수도 있습니다. 런타임 코드 변환이 느리므로 간단한 데모에만 이 코드를 사용하는 것이 좋습니다. ### 웹사이트에 React를 추가하기 {#add-react-to-a-website} @@ -46,40 +46,40 @@ React를 가지고 노는 데에 관심이 있다면, 온라인 코드 플레이 ### 새 React 앱 만들기 {#create-a-new-react-app} -React 프로젝트를 시작할 때는 [스크립트 태그를 사용한 간단한 HTML 페이지](/docs/create-a-new-react-app.html)가 여전히 최선의 선택일 수 있습니다. 설치하는 데 1분밖에 걸리지 않습니다! +React 프로젝트를 시작한다면 [스크립트 태그를 사용한 간단한 HTML 페이지](/docs/create-a-new-react-app.html)를 만드는 것이 최고의 방법일 것입니다. 설치하는 데 1분밖에 걸리지 않습니다! -애플리케이션이 커지면 보다 통합된 설정을 고려하는 것이 좋습니다. 대규모 애플리케이션에 권장되는 [여러 개의 JavaScript 툴체인](/docs/create-a-new-react-app.html)이 있습니다. 각 구성 요소는 많은 설정 없이 작동할 수 있고 풍부한 React 에코시스템을 최대한 활용할 수 있습니다. +그러나 애플리케이션이 커진다면 보다 통합된 설정을 고려하는 것이 좋습니다. 대규모 애플리케이션에 권장되는 [여러 개의 JavaScript 툴체인들](/docs/create-a-new-react-app.html)이 있습니다. 각 툴체인은 많은 설정 없이 작동할 수 있고 풍부한 React 에코시스템을 최대한 활용할 수 있습니다. ## React 배우기 {#learn-react} -사람들은 다양한 배경과 다른 학습 스타일을 가지고 React에 입문합니다. 보다 이론적인 접근 방식을 선호하든 실용적인 접근 방식을 선호하든 이 섹션은 도움이 되기를 바랍니다. +사람들은 다양한 배경과 다른 학습 스타일을 가지고 React에 입문합니다. 이론적인 접근 방식을 선호하는 사람들과 실용적인 접근 방식을 선호하는 사람들 모두에게 이 섹션이 도움되길 바랍니다. * **직접 구현해보면서 학습하는 것**을 원하시는 경우, [실용적인 자습서](/tutorial/tutorial.html)부터 시작하세요. * **개념을 차근차근 익히며 학습하는 것**을 원하시는 경우, [주요 개념 가이드](/docs/hello-world.html)부터 시작하세요. -다른 낯선 기술과 마찬가지로 React는 학습 곡선을 가지고 있습니다. 연습과 약간의 인내심을 가지고, React에 대한 요령을 익힐 것입니다. +다른 낯선 기술과 마찬가지로 React는 러닝 커브(learning curve)가 있습니다. 약간의 인내심을 가지고 연습하면, React에 대한 요령을 익힐 수 있습니다. ### 첫 번째 예제 {#first-examples} -[React 홈페이지](/)에는 실시간 편집기가 있는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. +[React 홈페이지](/)에는 라이브 편집기와 함께 제공되는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. ### 입문자를 위한 React {#react-for-beginners} -React 문서가 편한 속도보다 더 빠른 속도로 진행된다고 생각되면 [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 확인해 주세요. 가장 중요한 React 개념을 자세하고 입문자가 익히기 쉽게 소개합니다. 그다음에 이 문서를 다시 봐주세요! +React 문서가 어렵게 느껴진다면, [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 먼저 보고 오시는 것이 좋습니다. 그것은 가장 중요한 React 개념들을 자세하고 입문자도 쉽게 이해할 수 있도록 소개합니다. 그다음에 이 문서를 다시 봐주세요! ### 디자이너를 위한 React {#react-for-designers} -디자인을 위해서 왔다면 [이 리소스](http://reactfordesigners.com/)가 시작하기 좋습니다. +디자인 분야에서 일하고 있다면 [이 리소스](https://reactfordesigners.com/)가 시작하기 좋습니다. ### JavaScript 리소스 {#javascript-resources} -React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. +React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 쓰여져 있습니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. -지식수준을 확인하려면 [이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽어보는 것을 추천합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. +[이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽고 Javascript 수준을 확인하는 것을 권장합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. -> 팁 +>팁 > ->JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](http://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. +>JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](https://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. ### 실용적인 자습서 {#practical-tutorial} @@ -109,7 +109,7 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. [용어 사전](/docs/glossary.html)에는 React 문서에 나타나는 가장 일반적인 용어의 개요가 포함되어 있습니다. 또한 [AJAX 요청 만들기](/docs/faq-ajax.html), [컴포넌트 상태](/docs/faq-state.html), [파일 구조](/docs/faq-structure.html) 등 일반적인 주제에 대한 짧은 질문과 답변을 전문으로 하는 FAQ 섹션도 있습니다. -## 지속적인 정보 얻기 {#staying-informed} +## 최신 React 소식 {#staying-informed} [React 블로그](/blog/)는 React 팀의 업데이트에 대한 공식 소스입니다. 릴리즈 노트 또는 사용 자제 공지를 포함한 중요한 내용이 먼저 게시됩니다. @@ -117,7 +117,7 @@ React 문서는 JavaScript 프로그래밍이 익숙하다고 가정합니다. 모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. -## 문서 버전 {#versioned-documentation} +## 버전 관리된 문서 {#versioned-documentation} 이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. From 73312eda59ba40ab8f5e84c09c41556c93f3279f Mon Sep 17 00:00:00 2001 From: Uco Date: Wed, 27 Feb 2019 14:28:04 +0900 Subject: [PATCH 11/13] apply feedback --- content/docs/getting-started.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 1fab29b74..74b41869a 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -65,7 +65,7 @@ React 프로젝트를 시작한다면 [스크립트 태그를 사용한 간단 ### 입문자를 위한 React {#react-for-beginners} -React 문서가 어렵게 느껴진다면, [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 먼저 보고 오시는 것이 좋습니다. 그것은 가장 중요한 React 개념들을 자세하고 입문자도 쉽게 이해할 수 있도록 소개합니다. 그다음에 이 문서를 다시 봐주세요! +React 문서가 어렵게 느껴진다면, [Tania Rascia가 쓴 React 개요](https://www.taniarascia.com/getting-started-with-react/)를 먼저 보고 오시는 것이 좋습니다. 위 글은 가장 중요한 React 개념들을 자세하고 입문자도 쉽게 이해할 수 있도록 소개합니다. 그다음에 이 문서를 다시 봐주세요! ### 디자이너를 위한 React {#react-for-designers} @@ -75,7 +75,7 @@ React 문서가 어렵게 느껴진다면, [Tania Rascia가 쓴 React 개요](ht React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 쓰여져 있습니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. -[이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽고 Javascript 수준을 확인하는 것을 권장합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. +[이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽고 여러분의 Javascript 수준을 확인하는 것을 권장합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. >팁 > @@ -83,15 +83,15 @@ React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 ### 실용적인 자습서 {#practical-tutorial} -**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 자습서](/tutorial/tutorial.html)을 살펴보세요. 본 자습서에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임을 만드는 것이 아니기 때문에 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 조금만 기다려 보세요. 자습서에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. +**직접 구현해보면서 학습하는 것**을 원하시면, [실용적인 자습서](/tutorial/tutorial.html)을 살펴보세요. 본 자습서에서는 React로 tic-tac-toe 게임을 만들어 봅니다. 게임 제작에는 관심이 없어서 이 자습서를 건너뛰고 싶은 마음이 들지도 모릅니다. 하지만 조금만 기다려 보세요. 자습서에서 학습하는 기술은 *대부분의* React 앱을 구축하는 데 있어 기본이며, 이를 완전히 익히면 훨씬 더 깊은 이해할 수 있습니다. ### 단계별 가이드 {#step-by-step-guide} -**개념을 단계별로 배우려면** [주요 개념 가이드](/docs/hello-world.html)를 시작하는 것이 가장 좋습니다. 모든 다음 장은 앞 장에 소개된 지식을 바탕으로 하기 때문에 이를 따라갈 때 어떤 것도 놓치지 않습니다. +**개념을 단계별로 배우려면** [주요 개념 가이드](/docs/hello-world.html)를 시작하는 것이 가장 좋습니다. 모든 다음 장은 앞 장에 소개된 지식을 바탕으로 하기 때문에, 천천히 따라가기만 한다면 개념을 놓치지 않고 습득할 수 있습니다. ### React에 대해 생각해 보기 {#thinking-in-react} -많은 React 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 신용합니다. 이것은 아마 가장 오래된 React 문서이지만 여전히 유용합니다. +많은 React 사용자는 [React에 대해 생각해보기](/docs/thinking-in-react.html)를 읽는 것을 React를 마지막으로 이해하는 것으로 생각합니다. 이것은 아마 가장 오래된 React 문서이지만 여전히 유용합니다. ### 권장 과정 {#recommended-courses} @@ -99,11 +99,11 @@ React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 ### 고급 개념 {#advanced-concepts} -[주요 개념](#main-concepts)에 익숙해지고 React를 조금 더 많이 다루게 되면 보다 고급 주제에 관심이 있을 수 있습니다. 이 섹션에서는 [context](/docs/context.html) 및 [refs](/docs/refs-and-dom.html)와 같이 강력하지만 일반적으로 사용되지 않는 React 기능을 소개합니다. +[주요 개념](#main-concepts)에 익숙해지고 React를 더 많이 다루게 되면 보다 고급 주제에 관심을 가지게 될 것입니다. 이 섹션에서는 [context](/docs/context.html) 및 [refs](/docs/refs-and-dom.html)와 같이 강력하지만 일반적으로 사용되지는 않는 React 기능을 소개합니다. ### API 참조 {#api-reference} -이 문서 섹션은 특정 React API에 대한 자세한 내용을 알아보려는 경우에 유용합니다. 예를 들어, [`React.Component` API 참조](/docs/react-component.html)는 `setState()`가 어떻게 작동하는지와 다른 생명주기 메소드가 유용한 지에 대한 세부 정보를 제공합니다. +이 문서 섹션은 특정 React API를 자세히 알아보고 싶을 때 유용합니다. 예를 들어, [`React.Component` API 참조](/docs/react-component.html)에서는 `setState()`의 작동 방식과 각 상황에 알맞는 생명주기 메서드를 알 수 있습니다. ### 용어 사전과 FAQ {#glossary-and-faq} @@ -113,13 +113,13 @@ React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 [React 블로그](/blog/)는 React 팀의 업데이트에 대한 공식 소스입니다. 릴리즈 노트 또는 사용 자제 공지를 포함한 중요한 내용이 먼저 게시됩니다. -트위터의 [@reactjs 계정](https://twitter.com/reactjs)을 팔로우할 수도 있지만, 블로그만 읽어도 필수적인 것은 놓치지 않을 수 있습니다. +트위터의 [@reactjs 계정](https://twitter.com/reactjs)을 팔로우할 수도 있지만, 블로그만 읽어도 꼭 알아야 하는 정보는 놓치지 않을 수 있습니다. 모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. ## 버전 관리된 문서 {#versioned-documentation} -이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16 이후 문서의 이전 버전을 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. +이 문서는 항상 안정된 최신 버전의 React를 반영합니다. React 16부터는 이전 버전의 문서를 [별도의 페이지](/versions)에서 찾을 수 있습니다. 이전 버전의 문서는 릴리즈 시점에 스냅샷으로 작성되며 지속적으로 업데이트되지 않는다는 점에 유의하세요. ## 빠진 항목이 있다면? {#something-missing} From d06c9d7c96009919a76756a8b02c603d868ecabb Mon Sep 17 00:00:00 2001 From: Uco Date: Wed, 6 Mar 2019 17:29:17 +0900 Subject: [PATCH 12/13] change awkward expression (We love hearing from you!) --- content/docs/getting-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index 74b41869a..c64503090 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -123,4 +123,4 @@ React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 ## 빠진 항목이 있다면? {#something-missing} -이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 저희는 당신의 소식을 좋아합니다! +이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 여러분의 참여를 기다립니다! \ No newline at end of file From 551c3f8bc7dc67b85096623b7d12835e1d13cc98 Mon Sep 17 00:00:00 2001 From: Taehwan Noh Date: Thu, 7 Mar 2019 00:49:59 +0900 Subject: [PATCH 13/13] Fix some text and replace mdn link to korean document --- content/docs/getting-started.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/getting-started.md b/content/docs/getting-started.md index c64503090..1c1b12188 100644 --- a/content/docs/getting-started.md +++ b/content/docs/getting-started.md @@ -59,9 +59,9 @@ React 프로젝트를 시작한다면 [스크립트 태그를 사용한 간단 다른 낯선 기술과 마찬가지로 React는 러닝 커브(learning curve)가 있습니다. 약간의 인내심을 가지고 연습하면, React에 대한 요령을 익힐 수 있습니다. -### 첫 번째 예제 {#first-examples} +### 첫 번째 예시 {#first-examples} -[React 홈페이지](/)에는 라이브 편집기와 함께 제공되는 몇 가지 React 예제가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. +[React 홈페이지](/)에는 라이브 편집기와 함께 제공되는 몇 가지 React 예시가 있습니다. React에 대해 전혀 모르더라도 코드를 변경하면서 그것이 결과에 어떤 영향을 미치는지 보실 수 있습니다. ### 입문자를 위한 React {#react-for-beginners} @@ -75,11 +75,11 @@ React 문서가 어렵게 느껴진다면, [Tania Rascia가 쓴 React 개요](ht React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 쓰여져 있습니다. 전문가일 필요는 없지만, React와 JavaScript를 동시에 배우기는 어렵습니다. -[이 JavaScript 개요](https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript)를 읽고 여러분의 Javascript 수준을 확인하는 것을 권장합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. +[이 JavaScript 개요](https://developer.mozilla.org/ko/docs/A_re-introduction_to_JavaScript)를 읽고 여러분의 Javascript 수준을 확인하는 것을 권장합니다. 30분에서 1시간 정도 걸리겠지만 React를 익히는 데에 더 자신감이 생길 것입니다. >팁 > ->JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/en-US/docs/Web/JavaScript)과 [javascript.info](https://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. +>JavaScript 내용이 혼동될 때마다, [MDN](https://developer.mozilla.org/ko/docs/Web/JavaScript)과 [javascript.info](https://javascript.info/)는 참고하기 좋은 웹사이트입니다. 또한, 문의를 할 수 있는 [커뮤니티 지원 포럼](/community/support.html)도 있습니다. ### 실용적인 자습서 {#practical-tutorial} @@ -87,7 +87,7 @@ React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 ### 단계별 가이드 {#step-by-step-guide} -**개념을 단계별로 배우려면** [주요 개념 가이드](/docs/hello-world.html)를 시작하는 것이 가장 좋습니다. 모든 다음 장은 앞 장에 소개된 지식을 바탕으로 하기 때문에, 천천히 따라가기만 한다면 개념을 놓치지 않고 습득할 수 있습니다. +**개념을 단계별로 배우려면** [주요 개념 가이드](/docs/hello-world.html)를 시작하는 것이 가장 좋습니다. 모든 다음 장은 앞 장에 소개된 지식을 바탕으로 하기 때문에, 천천히 따라가기만 한다면 개념을 놓치지 않고 습득할 수 있습니다. ### React에 대해 생각해 보기 {#thinking-in-react} @@ -115,7 +115,7 @@ React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 트위터의 [@reactjs 계정](https://twitter.com/reactjs)을 팔로우할 수도 있지만, 블로그만 읽어도 꼭 알아야 하는 정보는 놓치지 않을 수 있습니다. -모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 'CHANGELOG.md' 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. +모든 React 릴리즈가 자체 블로그 게시물을 사용할 만한 것은 아니지만 [릴리즈](https://github.com/facebook/react) 페이지와 React의 `CHANGELOG.md` 파일에서 모든 릴리즈에 대한 자세한 변경 기록을 확인할 수 있습니다. ## 버전 관리된 문서 {#versioned-documentation} @@ -123,4 +123,4 @@ React 문서는 Javascript 프로그래밍에 익숙한 사람을 대상으로 ## 빠진 항목이 있다면? {#something-missing} -이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 여러분의 참여를 기다립니다! \ No newline at end of file +이 문서에서 빠진 부분이나 혼동되는 부분을 발견하시면, 개선을 위한 제안과 함께 [문서의 레퍼지토리](https://github.com/reactjs/reactjs.org/issues/new)에 이슈를 올려주시거나, [@reactjs 계정](https://twitter.com/reactjs)에 tweet 해주세요. 여러분의 참여를 기다립니다!