Skip to content

reactjs/ko.react.dev

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ko.react.dev

React Korea ๋””์Šค์ฝ”๋“œ ์ฑ„๋„

ํ•œ๊ตญ์–ด ๋ฒˆ์—ญ ์ •๋ณด

๊ฐ€์ด๋“œ

๋ฒˆ์—ญ ํ˜น์€ ๊ธฐ์—ฌ๋ฅผ ์ง„ํ–‰ํ•  ๋•Œ, ์•„๋ž˜ ๊ฐ€์ด๋“œ๋ฅผ ๋”ฐ๋ผ์ฃผ์„ธ์š”.

  1. ๊ธฐ์—ฌ ๊ฐ€์ด๋“œ๋ผ์ธContributing ๋ฐ ๊ธฐ์—ฌ์ž ํ–‰๋™ ๊ฐ•๋ น ๊ทœ์•ฝCode of Conduct์„ ๋”ฐ๋ฅด๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
  2. ๊ณตํ†ต ์Šคํƒ€์ผ ๊ฐ€์ด๋“œUniversal Style Guide๋ฅผ ํ™•์ธํ•ด์ฃผ์„ธ์š”.
  3. ๋ฒˆ์—ญ์„ ์œ„ํ•œ ๋ชจ๋ฒ” ์‚ฌ๋ก€Best Practices for Translation๋ฅผ ๋”ฐ๋ผ์ฃผ์„ธ์š”.
  4. ๊ณตํ†ต๋œ ๋‹จ์–ด ๋ฒˆ์—ญ์„ ์œ„ํ•ด ๋ฒˆ์—ญ ์šฉ์–ด ์ •๋ฆฌTranslate Glossary๋ฅผ ์ฐธ๊ณ ํ•ด์ฃผ์„ธ์š”.
  5. ๋Œ์–ด์˜ค๊ธฐ ์š”์ฒญPull Request์‹œ ํ…Œ์ŠคํŠธ๋ฅผ ํ†ต๊ณผํ•˜์ง€ ๋ชปํ•  ๊ฒฝ์šฐ, textlint ๊ฐ€์ด๋“œTextlint Guide๋ฅผ ์ฐธ๊ณ ํ•ด์ฃผ์„ธ์š”.
  6. ๋งˆ์ง€๋ง‰์œผ๋กœ ๋งž์ถค๋ฒ• ๊ฒ€์‚ฌSpelling Check๋ฅผ ์ง„ํ–‰ํ•ด์ฃผ์„ธ์š”.

์ด ์ €์žฅ์†ŒRepository๋Š” ko.react.dev์˜ ์†Œ์Šค ์ฝ”๋“œ์™€ ๊ฐœ๋ฐœ ๋ฌธ์„œ๋ฅผ ํฌํ•จํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.

์‹œ์ž‘ํ•˜๊ธฐ

์‚ฌ์ „ ์ค€๋น„

  1. Git
  2. Node: v16.8.0 ์ด์ƒ์˜ ๋ชจ๋“  ๋ฒ„์ „
  3. Yarn v1([email protected]): Yarn ์„ค์น˜ ์•ˆ๋‚ด ์ฐธ๊ณ 
  4. ํฌํฌForkํ•œ ๊ฐœ์ธ ์ €์žฅ์†Œ
  5. ๋กœ์ปฌ์— ํด๋ก Cloneํ•œ ko.react.dev ์ €์žฅ์†Œ

์„ค์น˜

  1. cd ko.react.dev๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ํ”„๋กœ์ ํŠธ ๊ฒฝ๋กœ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.
  2. yarn ๋ช…๋ น์–ด๋ฅผ ์‹คํ–‰ํ•˜์—ฌ npm ์˜์กด์„ฑ ๋ชจ๋“ˆ๋“ค์„ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.

๊ฐœ๋ฐœ ์„œ๋ฒ„ ์‹คํ–‰ํ•˜๊ธฐ

  1. yarn dev ๋ช…๋ น์–ด๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๊ฐœ๋ฐœ ์„œ๋ฒ„๋ฅผ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. (powered by Next.js.)
  2. open http://localhost:3000 ๋ช…๋ น์–ด๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์„ ํ˜ธํ•˜๋Š” ๋ธŒ๋ผ์šฐ์ €๋กœ ์ ‘์†ํ•˜์„ธ์š”.

๊ธฐ์—ฌ ๋ฐฉ๋ฒ•

๊ฐ€์ด๋“œ๋ผ์ธ

์ด ๋ฌธ์„œ๋Š” ๋ชฉ์ ์ด ๋‹ค๋ฅธ ์—ฌ๋Ÿฌ ์„น์…˜์œผ๋กœ ๋‚˜๋‰ฉ๋‹ˆ๋‹ค. ๋ฌธ์žฅ์„ ์ถ”๊ฐ€ํ•  ๊ณ„ํš์ด๋ผ๋ฉด, ์ ์ ˆํ•œ ์„น์…˜์— ๋Œ€ํ•œ ๊ธฐ์—ฌ ๊ฐ€์ด๋“œ๋ผ์ธContributing์„ ์ˆ™์ง€ํ•˜๋Š” ๊ฒƒ์ด ๋„์›€์ด ๋  ๊ฒƒ์ž…๋‹ˆ๋‹ค.

๋ถ„๊ธฐBranch ๋งŒ๋“ค๊ธฐ

  1. ko.react.dev ๋กœ์ปฌ ์ €์žฅ์†Œ์—์„œ git checkout main์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  2. git pull origin main์„ ์‹คํ–‰ํ•˜์—ฌ ์ตœ์‹  ์ฝ”๋“œ๋ฅผ ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  3. git checkout -b the-name-of-my-branch๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ๋ถ„๊ธฐBranch๋ฅผ ๋งŒ๋“ญ๋‹ˆ๋‹ค. (์ด๋•Œ, the-name-of-my-branch๋ฅผ ์ ์ ˆํ•œ ์ด๋ฆ„์œผ๋กœ ๊ต์ฒด.)

์ˆ˜์ •ํ•˜๊ธฐ

  1. "๊ฐœ๋ฐœ ์„œ๋ฒ„ ์‹คํ–‰ํ•˜๊ธฐ" ๋ถ€๋ถ„์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
  2. ํŒŒ์ผ์„ ์ €์žฅํ•˜๊ณ  ๋ธŒ๋ผ์šฐ์ €์—์„œ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
  3. src ์•ˆ์— ์žˆ๋Š” React ์ปดํฌ๋„ŒํŠธ๊ฐ€ ์ˆ˜์ •๋  ๊ฒฝ์šฐ hot-reload๊ฐ€ ์ ์šฉ๋ฉ๋‹ˆ๋‹ค.
  4. content ์•ˆ์— ์žˆ๋Š” ๋งˆํฌ๋‹ค์šด ํŒŒ์ผ์ด ์ˆ˜์ •๋  ๊ฒฝ์šฐ hot-reload๊ฐ€ ์ ์šฉ๋ฉ๋‹ˆ๋‹ค.
  5. ํ”Œ๋Ÿฌ๊ทธ์ธ์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ, .cache ๋””๋ ‰ํ† ๋ฆฌ๋ฅผ ์ œ๊ฑฐํ•œ ํ›„ ์„œ๋ฒ„๋ฅผ ์žฌ์‹œ์ž‘ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์ˆ˜์ •์‚ฌํ•ญ ๊ฒ€์‚ฌํ•˜๊ธฐ

  1. ๊ฐ€๋Šฅํ•˜๋‹ค๋ฉด, ๋ณ€๊ฒฝํ•œ ๋ถ€๋ถ„์— ๋Œ€ํ•ด์„œ ๋งŽ์ด ์‚ฌ์šฉํ•˜๋Š” ๋ธŒ๋ผ์šฐ์ €์˜ ์ตœ์‹  ๋ฒ„์ „์—์„œ ์‹œ๊ฐ์ ์œผ๋กœ ์ œ๋Œ€๋กœ ์ ์šฉ๋˜์—ˆ๋Š”์ง€ ํ™•์ธํ•ด์ฃผ์„ธ์š”. (๋ฐ์Šคํฌํƒ‘๊ณผ ๋ชจ๋ฐ”์ผ ๋ชจ๋‘.)
  2. ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์—์„œ yarn check-all์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. (์ด ๋ช…๋ น์–ด๋Š” Prettier, ESLint, ๊ทธ๋ฆฌ๊ณ  ํƒ€์ž… ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ๋ฅผ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.)

ํ‘ธ์‹œPush ํ•˜๊ธฐ

  1. git add -A && git commit -m "My message"๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ๋ณ€๊ฒฝํ•œ ํŒŒ์ผ๋“ค์„ ์ปค๋ฐ‹commit ํ•ด์ฃผ์„ธ์š”. (์ด๋•Œ, My message ๋ถ€๋ถ„์„ Fix header logo on Android ๊ฐ™์€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€๋กœ ๊ต์ฒด.)
  2. git push my-fork-name the-name-of-my-branch
  3. ko.react.dev ์ €์žฅ์†Œ์—์„œ ์ตœ๊ทผ์— ํ‘ธ์‹œ๋œ ๋ถ„๊ธฐBranch๋ฅผ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  4. ๊นƒํ—ˆ๋ธŒGitHub ์ง€์นจ์„ ๋”ฐ๋ผ์ฃผ์„ธ์š”.
  5. ๊ฐ€๋Šฅํ•˜๋‹ค๋ฉด ์‹œ๊ฐ์ ์œผ๋กœ ๋ณ€ํ™”๋œ ๋ถ€๋ถ„์˜ ์Šคํฌ๋ฆฐ์ƒท์„ ์ฒจ๋ถ€ํ•ด์ฃผ์„ธ์š”. ๋ณ€๊ฒฝ ์‚ฌํ•ญ์ด ๊นƒํ—ˆ๋ธŒGitHub์— ํ‘ธ์‹œPush๋˜๋ฉด ๋ฏธ๋ฆฌ๋ณด๊ธฐ ๋นŒ๋“œ๊ฐ€ ํŠธ๋ฆฌ๊ฑฐ๋ฉ๋‹ˆ๋‹ค.

๋ฌธ์ œ ํ•ด๊ฒฐํ•˜๊ธฐ

yarn cache-reset ๋ช…๋ น์–ด๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋กœ์ปฌ ์บ์‹œ๋ฅผ ์ดˆ๊ธฐํ™”ํ•ฉ๋‹ˆ๋‹ค.

๋ฒˆ์—ญ

react.dev ๋ฒˆ์—ญ์— ํฅ๋ฏธ๊ฐ€ ์žˆ๋‹ค๋ฉด, translations.react.dev์—์„œ ํ˜„์žฌ ๋ฒˆ์—ญ์ด ์–ผ๋งˆ๋‚˜ ์ง„ํ–‰๋˜์—ˆ๋Š”์ง€ ํ™•์ธํ•ด์ฃผ์„ธ์š”.

๋ฒˆ์—ญํ•˜๋ ค๋Š” ์–ธ์–ด๊ฐ€ ์•„์ง ์ง„ํ–‰๋˜์ง€ ์•Š์•˜๋‹ค๋ฉด, ํ•ด๋‹น ์–ธ์–ด์— ๋Œ€ํ•ด ์ƒˆ๋กญ๊ฒŒ ๋งŒ๋“ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. translations.react.dev ์ €์žฅ์†Œ๋ฅผ ์ฐธ๊ณ ํ•ด์ฃผ์„ธ์š”.

์ €์ž‘๊ถŒ

์œ„ ๋‚ด์šฉ์— ๋Œ€ํ•œ ์ €์ž‘๊ถŒ์€ react.dev๊ฐ€ ๊ฐ€์ง€๊ณ  ์žˆ์œผ๋ฉฐ, LICENSE-DOCS.md์—์„œ ๋ณผ ์ˆ˜ ์žˆ๋Š” CC-BY-4.0 ๋ผ์ด์„ผ์Šค๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.

Sponsor this project

 

Contributors 2,290