|
|
|
|
# 명령 줄 인터페이스 {#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
|
|
|
|
|
```
|
