본문으둜 κ±΄λ„ˆλ›°κΈ°
버전: 2.3.1

πŸ“¦ 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μž…λ‹ˆλ‹€.

warning

이 λͺ…령은 λͺ¨λ“  κΈ°λŠ₯을 μ‚¬μš©ν•  수 μžˆλ„λ‘ λŒ€ν™”ν˜• μ‰˜μ—μ„œ μ‚¬μš©ν•˜λŠ” 것을 ꢌμž₯ν•©λ‹ˆλ‹€.

μ˜΅μ…˜β€‹

-t, --typescript​

ν…œν”Œλ¦Ώ μΈμˆ˜κ°€ μΈμ‹λœ 이름일 λ•Œ μ‚¬μš©ν•©λ‹ˆλ‹€. ν˜„μž¬λŠ” classicμ—μ„œλ§Œ νƒ€μž…μŠ€ν¬λ¦½νŠΈ λ³€ν˜•μ„ μ œκ³΅ν•©λ‹ˆλ‹€.

-g, --git-strategy​

ν…œν”Œλ¦Ώ μΈμˆ˜κ°€ κΉƒ μ €μž₯μ†ŒμΌ λ•Œ μ‚¬μš©ν•©λ‹ˆλ‹€. λ‹€μŒ 쀑 ν•˜λ‚˜λ₯Ό μ‚¬μš©ν•  수 μžˆμŠ΅λ‹ˆλ‹€.

  • deep: 전체 κΉƒ 이λ ₯을 λ³΄μ‘΄ν•©λ‹ˆλ‹€.
  • shallow: --depth=1 μ˜΅μ…˜μ„ μ‚¬μš©ν•΄ λ³΅μ œν•©λ‹ˆλ‹€.
  • copy: 얕은 볡제λ₯Ό μˆ˜ν–‰μ‚¬μ§€λ§Œ κΉƒ μ €μž₯μ†ŒλŠ” λ§Œλ“€μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
  • custom: μ‚¬μš©μž 지정 κΉƒ 볡제 λͺ…령을 μž…λ ₯ν•©λ‹ˆλ‹€. μž…λ ₯을 μœ„ν•œ κ°€μ΄λ“œλ₯Ό μ§€μ›ν•©λ‹ˆλ‹€. git clone --depth 10 같은 μ˜΅μ…˜μ„ 지정할 수 있으며 μ €μž₯μ†Œ URLκ³Ό λŒ€μƒ 디렉토리λ₯Ό μΆ”κ°€ν•΄μ€λ‹ˆλ‹€.

-p, --package-manager​

값은 npm, yarn, pnpm 쀑 ν•˜λ‚˜λ₯Ό μ‚¬μš©ν•  수 μžˆμŠ΅λ‹ˆλ‹€. λͺ…μ‹œμ μœΌλ‘œ 값을 μ„€μ •ν•˜μ§€ μ•ŠμœΌλ©΄ λ„νμ‚¬μš°λ£¨μŠ€λŠ” λ‹€μŒ 기쀀에 따라 μ²˜λ¦¬ν•©λ‹ˆλ‹€.

  • CWD에 이미 μžˆλŠ” lockfile(예: κΈ°μ‘΄ ν”„λ‘œμ νŠΈμ—μ„œ μ›Ήμ‚¬μ΄νŠΈλ₯Ό μ„€μ •ν•˜λŠ” 경우)
  • create-docusaurusλ₯Ό ν˜ΈμΆœν•˜κΈ° μœ„ν•œ λͺ…λ Ή(예: npm init, npx, yarn create λ“±)
  • 이전에 μ‚¬μš©ν•œ 적 μ—†λŠ” 경우라면 λŒ€ν™”ν˜• ν”„λ‘¬ν”„νŠΈ

-s, --skip-install​

μ˜΅μ…˜μ„ μ§€μ •ν•˜λ©΄ λ„νμ‚¬μš°λ£¨μŠ€λŠ” μ•± 생성 ν›„ 쒅속성을 μžλ™μœΌλ‘œ μ„€μΉ˜ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€. --package-manager μ˜΅μ…˜μ€ μ‹€μ œλ‘œ 쒅속성을 μ„€μΉ˜ν•  λ•Œμ—λ§Œ μœ μš©ν•©λ‹ˆλ‹€.