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

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

๊ฐ€์ด๋“œ

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

  1. ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ณตํ†ต ์Šคํƒ€์ผ ๊ฐ€์ด๋“œ ํ™•์ธ (Check the common style guide) ์„ ๋”ฐ๋ฅด๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
  2. ๋ชจ๋ฒ”์‚ฌ๋ก€ ํ™•์ธ (Check best practices) ์„ ํ™•์ธํ•ด์ฃผ์„ธ์š”.
  3. ๊ณตํ†ต๋œ ๋‹จ์–ด ๋ฒˆ์—ญ์„ ์œ„ํ•ด ์šฉ์–ด ํ™•์ธ (Check the term) ์„ ์ฐธ๊ณ ํ•ด์ฃผ์„ธ์š”.
  4. ๋งˆ์ง€๋ง‰์œผ๋กœ ๋งž์ถค๋ฒ• ๊ฒ€์‚ฌ (Spelling check) ๋ฅผ ์ง„ํ–‰ํ•ด์ฃผ์„ธ์š”.

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

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

์‚ฌ์ „ ์ค€๋น„

  1. Git
  2. Node: 12.0.0 ์ด์ƒ์œผ๋กœ ์‹œ์ž‘ํ•˜๋Š” ๋ชจ๋“  12.x ๋ฒ„์ „
  3. Yarn v1: Yarn website for installation instructions ์ฐธ๊ณ 
  4. ํฌํฌํ•œ ๊ฐœ์ธ ์ €์žฅ์†Œ
  5. ๋กœ์ปฌ์— ํด๋ก (Clone)ํ•œ ko.react.dev repo ๊ฐœ์ธ ์ €์žฅ์†Œ

์„ค์น˜

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

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

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

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

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

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

๋ธŒ๋žœ์น˜(branch) ๋งŒ๋“ค๊ธฐ

  1. ko.react.dev ๋กœ์ปฌ ์ €์žฅ์†Œ์—์„œ git checkout main์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  2. git pull origin main๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ์ตœ์‹  ์›๋ณธ ์ฝ”๋“œ๋ฅผ ๋ณด์žฅํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  3. git checkout -b the-name-of-my-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" (My message ๋ถ€๋ถ„์„ Fix header logo on Android ๊ฐ™์€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€๋กœ ๊ต์ฒด)๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ๋ณ€๊ฒฝํ•œ ํŒŒ์ผ๋“ค์„ commit ํ•ด์ฃผ์„ธ์š”.
  2. git push my-fork-name the-name-of-my-branch
  3. ko.react.dev repo์—์„œ ์ตœ๊ทผ์— ํ‘ธ์‹œ๋œ ๋ธŒ๋žœ์น˜๋ฅผ ๋ณผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  4. Github ์ง€์นจ์„ ๋”ฐ๋ผ์ฃผ์„ธ์š”.
  5. ๊ฐ€๋Šฅํ•˜๋‹ค๋ฉด ์‹œ๊ฐ์ ์œผ๋กœ ๋ณ€ํ™”๋œ ๋ถ€๋ถ„์˜ ์Šคํฌ๋ฆฐ์ƒท์„ ์ฒจ๋ถ€ํ•ด์ฃผ์„ธ์š”. PR์„ ๋งŒ๋“ค๊ณ  ๋‹ค๋ฅธ์‚ฌ๋žŒ๋“ค์ด ์ˆ˜์ •์‚ฌํ•ญ์„ ๋ณผ ์ˆ˜ ์žˆ๊ฒŒ๋˜๋ฉด ์ž๋™์œผ๋กœ ๋นŒ๋“œํ•  ๊ฒƒ์ž…๋‹ˆ๋‹ค.

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

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

๋ฒˆ์—ญ

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

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

์ €์ž‘๊ถŒ

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