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
2.9 KiB

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