You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
vitepress/docs/ko/reference/cli.md

75 lines
3.2 KiB

# 명령 줄 인터페이스 {#command-line-interface}
## `vitepress dev`
지정된 디렉터리를 루트로 하여 VitePress 개발 서버를 시작합니다. 기본값은 현재 디렉터리입니다. 현재 디렉터리에서 실행할 때 `dev` 명령은 생략할 수 있습니다.
### 사용법 {#usage}
```sh
# 현재 디렉토리에서 시작, `dev` 생략
vitepress
# 하위 디렉터리에서 시작
vitepress dev [root]
```
### 옵션 {#options}
| 옵션 | 설명 |
| ---------------- | ----------------------------------------------------------------- |
| `--open [path]` | 시작 시 브라우저 열기 (`boolean \| string`) |
| `--port <port>` | 포트 지정 (`number`) |
| `--base <path>` | Public 기본 경로 (기본값: `/`) (`string`) |
| `--cors` | CORS 활성화 |
| `--strictPort` | 지정된 포트가 이미 사용 중인 경우 종료 (`boolean`) |
| `--force` | 옵티마이저가 캐시를 무시하고 다시 번들링하도록 강제 (`boolean`) |
## `vitepress build`
VitePress 사이트를 프로덕션 빌드합니다.
### 사용법 {#usage-1}
```sh
vitepress build [root]
```
### 옵션 {#options-1}
| 옵션 | 설명 |
| ----------------------------- |---------------------------------------------------------------------------------------------|
| `--mpa` (실험적) | 클라이언트 측 하이드레이션 없이 [MPA 모드](../guide/mpa-mode)로 빌드 (`boolean`) |
| `--base <path>` | Public 기본 경로 (기본값: `/`) (`string`) |
| `--target <target>` | 트랜스파일 대상 (기본값: `"modules"`) (`string`) |
| `--outDir <dir>` | **cwd** 기준 출력 디렉터리 (기본값: `<root>/.vitepress/dist`) (`string`) |
| `--minify [minifier]` | minify 활성화/비활성화 또는 사용할 minify 도구 지정 (기본값: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) |
| `--assetsInlineLimit <number>`| 바이트 단위의 정적 에셋 base64 인라인 임계값 (기본값: `4096`) (`number`) |
## `vitepress preview`
프로덕션 빌드를 로컬에서 미리 보기 합니다.
### 사용법 {#usage-2}
```sh
vitepress preview [root]
```
### 옵션 {#options-2}
| 옵션 | 설명 |
| ---------------- | ----------------------------------------- |
| `--base <path>` | Public 기본 경로 (기본값: `/`) (`string`) |
| `--port <port>` | 포트 지정 (`number`) |
## `vitepress init`
현재 디렉터리에서 [설정 마법사](../guide/getting-started#setup-wizard)를 시작합니다.
### 사용법 {#usage-3}
```sh
vitepress init
```