๋ฉ”์ธ ์ปจํ…์ธ ๋กœ ์ด๋™
๋ฒ„์ „: ๋ถˆ์•ˆ์ • ๐Ÿšง

๐Ÿ“ฆ create-docusaurus

๋ฐ”๋กœ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ๋„ํ์‚ฌ์šฐ๋ฃจ์Šค ์•ฑ์„ ์ฆ‰์‹œ ์„ค์ •ํ•˜๋Š”๋ฐ ๋„์›€์ด ๋˜๋Š” ์Šค์บํด๋”ฉ ์œ ํ‹ธ์ž…๋‹ˆ๋‹ค.

์‚ฌ์šฉ๋ฒ•โ€‹

npx create-docusaurus@latest [name] [template] [rootDir]

name ์ธ์ˆ˜๋Š” ์‚ฌ์ดํŠธ ๊ฒฝ๋กœ์™€ ์ƒ์„ฑ๋œ ์•ฑ์˜ package.json์— ์žˆ๋Š” name ํ•„๋“œ๋กœ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ์ ˆ๋Œ€ ๊ฒฝ๋กœ ๋˜๋Š” rootDir์— ๋Œ€ํ•œ ์ƒ๋Œ€ ๊ฒฝ๋กœ์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

template ์ธ์ˆ˜๋Š” ๋‹ค์Œ ์ค‘ ํ•˜๋‚˜๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  • classic: classic ํ…œํ”Œ๋ฆฟ ์‚ฌ์šฉ(๊ถŒ์žฅ)
  • facebook: ์ผ๋ถ€ ๋ฉ”ํƒ€(Meta) ๊ด€๋ จ ์„ค์ •์ด ํฌํ•จ๋œ ํŽ˜์ด์Šค๋ถ/๋ฉ”ํƒ€ ํ…œํ”Œ๋ฆฟ ์‚ฌ์šฉ
  • ์›ํ•˜๋Š” ๊ณณ์— ๋ณต์ œํ•  ์ˆ˜ ์žˆ๋Š” ๊นƒ ์ €์žฅ์†Œ URL(https:// ๋˜๋Š” git@์œผ๋กœ ์‹œ์ž‘ํ•˜๋Š”)
  • ์›ํ•˜๋Š” ๊ณณ์— ๋ณต์‚ฌํ•  ํŒŒ์ผ์ด ํฌํ•จ๋œ CWD์— ๋Œ€ํ•œ ๋กœ์ปฌ ํŒŒ์ผ ๊ฒฝ๋กœ

rootDir์€ ์‚ฌ์ดํŠธ ๋””๋ ‰ํ† ๋ฆฌ์— ๋Œ€ํ•œ ์ ˆ๋Œ€ ๊ฒฝ๋กœ๋ฅผ ํ™•์ธํ•˜๋Š” ๋ฐ ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค. ๊ธฐ๋ณธ๊ฐ’์€ CWD์ž…๋‹ˆ๋‹ค.

๊ฒฝ๊ณ 

์ด ๋ช…๋ น์€ ๋ชจ๋“  ๊ธฐ๋Šฅ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ๋Œ€ํ™”ํ˜• ์‰˜์—์„œ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.

์˜ต์…˜โ€‹

-t, --typescriptโ€‹

ํ…œํ”Œ๋ฆฟ ์ธ์ˆ˜๊ฐ€ ์ธ์‹๋œ ์ด๋ฆ„์ผ ๋•Œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ํ˜„์žฌ๋Š” classic์—์„œ๋งŒ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๋ณ€ํ˜•์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

-g, --git-strategyโ€‹

ํ…œํ”Œ๋ฆฟ ์ธ์ˆ˜๊ฐ€ ๊นƒ ์ €์žฅ์†Œ์ผ ๋•Œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ๋‹ค์Œ ์ค‘ ํ•˜๋‚˜๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  • deep: ์ „์ฒด ๊นƒ ์ด๋ ฅ์„ ๋ณด์กดํ•ฉ๋‹ˆ๋‹ค.
  • shallow: --depth=1 ์˜ต์…˜์„ ์‚ฌ์šฉํ•ด ๋ณต์ œํ•ฉ๋‹ˆ๋‹ค.
  • copy: ์–•์€ ๋ณต์ œ๋ฅผ ์ˆ˜ํ–‰์‚ฌ์ง€๋งŒ ๊นƒ ์ €์žฅ์†Œ๋Š” ๋งŒ๋“ค์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  • custom: ์‚ฌ์šฉ์ž ์ง€์ • ๊นƒ ๋ณต์ œ ๋ช…๋ น์„ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค. ์ž…๋ ฅ์„ ์œ„ํ•œ ๊ฐ€์ด๋“œ๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค. git clone --depth 10 ๊ฐ™์€ ์˜ต์…˜์„ ์ง€์ •ํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ ์ €์žฅ์†Œ URL๊ณผ ๋Œ€์ƒ ๋””๋ ‰ํ† ๋ฆฌ๋ฅผ ์ถ”๊ฐ€ํ•ด์ค๋‹ˆ๋‹ค.

-p, --package-managerโ€‹

Value should be one of npm, yarn, pnpm, or bun. ๋ช…์‹œ์ ์œผ๋กœ ๊ฐ’์„ ์„ค์ •ํ•˜์ง€ ์•Š์œผ๋ฉด ๋„ํ์‚ฌ์šฐ๋ฃจ์Šค๋Š” ๋‹ค์Œ ๊ธฐ์ค€์— ๋”ฐ๋ผ ์ฒ˜๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

  • CWD์— ์ด๋ฏธ ์žˆ๋Š” lockfile(์˜ˆ: ๊ธฐ์กด ํ”„๋กœ์ ํŠธ์—์„œ ์›น์‚ฌ์ดํŠธ๋ฅผ ์„ค์ •ํ•˜๋Š” ๊ฒฝ์šฐ)
  • The command used to invoke create-docusaurus (e.g. npm init, npx, yarn create, bunx, etc.)
  • ์ด์ „์— ์‚ฌ์šฉํ•œ ์  ์—†๋Š” ๊ฒฝ์šฐ๋ผ๋ฉด ๋Œ€ํ™”ํ˜• ํ”„๋กฌํ”„ํŠธ

-s, --skip-installโ€‹

์˜ต์…˜์„ ์ง€์ •ํ•˜๋ฉด ๋„ํ์‚ฌ์šฐ๋ฃจ์Šค๋Š” ์•ฑ ์ƒ์„ฑ ํ›„ ์ข…์†์„ฑ์„ ์ž๋™์œผ๋กœ ์„ค์น˜ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. --package-manager ์˜ต์…˜์€ ์‹ค์ œ๋กœ ์ข…์†์„ฑ์„ ์„ค์น˜ํ•  ๋•Œ์—๋งŒ ์œ ์šฉํ•ฉ๋‹ˆ๋‹ค.