docs(ko): re-translation of korean documents (reference/*) (#4120)

vuejs · Aug 9, 2024 · 3c40e9d · 3c40e9d
1 parent df27e44
commit 3c40e9d
Show file tree

Hide file tree

Showing 19 changed files with 562 additions and 549 deletions.
diff --git a/docs/.vitepress/config/ko.ts b/docs/.vitepress/config/ko.ts
@@ -180,24 +180,24 @@ function sidebarReference(): DefaultTheme.SidebarItem[] {
       text: '레퍼런스',
       items: [
         { text: '사이트 구성', link: 'site-config' },
-        { text: '머리말 구성', link: 'frontmatter-config' },
+        { text: '전문(front-matter) 구성', link: 'frontmatter-config' },
         { text: '런타임 API', link: 'runtime-api' },
         { text: 'CLI', link: 'cli' },
         {
           text: '기본 테마',
           base: '/ko/reference/default-theme-',
           items: [
             { text: '개요', link: 'config' },
-            { text: '네비게이션', link: 'nav' },
+            { text: '네비게이션 바', link: 'nav' },
             { text: '사이드바', link: 'sidebar' },
             { text: '홈 페이지', link: 'home-page' },
             { text: '푸터', link: 'footer' },
             { text: '레이아웃', link: 'layout' },
-            { text: '배지', link: 'badge' },
+            { text: '배지(badge)', link: 'badge' },
             { text: '팀 페이지', link: 'team-page' },
-            { text: '이전 / 다음 링크', link: 'prev-next-links' },
+            { text: '이전/다음 링크', link: 'prev-next-links' },
             { text: '편집 링크', link: 'edit-link' },
-            { text: '마지막 업데이트 시간', link: 'last-updated' },
+            { text: '마지막 업데이트 날짜', link: 'last-updated' },
             { text: '검색', link: 'search' },
             { text: '카본 광고', link: 'carbon-ads' }
           ]

diff --git a/docs/ko/guide/markdown.md b/docs/ko/guide/markdown.md
@@ -255,7 +255,7 @@ export default defineConfig({
   }
   ```
 
-  이것은 기본적으로 [`postcss-prefix-selector`](https://github.com/postcss/postcss-load-config)를 사용합니다. 다음과 같이 옵션을 전달할 수 있습니다:
+  이것은 기본적으로 [`postcss-prefix-selector`](https://github.com/RadValentin/postcss-prefix-selector)를 사용합니다. 다음과 같이 옵션을 전달할 수 있습니다:
 
   ```js
   postcssIsolateStyles({

diff --git a/docs/ko/reference/cli.md b/docs/ko/reference/cli.md
@@ -2,72 +2,72 @@
 
 ## `vitepress dev`
 
-지정된 디렉토리를 루트로 사용하여 VitePress 개발 서버 시작. 기본값은 현재 디렉토리입니다. 현재 디렉토리에서 실행할 때는 `dev` 명령을 생략할 수도 있습니다.
+지정된 디렉터리를 루트로 하여 VitePress 개발 서버를 시작합니다. 기본값은 현재 디렉터리입니다. 현재 디렉터리에서 실행할 때 `dev` 명령은 생략할 수 있습니다.
 
-### 사용법
+### 사용법 {#usage}
 
 ```sh
 # 현재 디렉토리에서 시작, `dev` 생략
 vitepress
 
-# 서브 디렉토리에서 시작
+# 하위 디렉터리에서 시작
 vitepress dev [root]
 ```
 
-### 옵션
+### 옵션 {#options}
 
-| 옵션              | 설명                                      |
-|-----------------|-----------------------------------------|
-| `--open [path]` | 시작 시 브라우저 열기 (`boolean \| string`)      |
-| `--port <port>` | 포트 지정 (`number`)                        |
-| `--base <path>` | 공개 기본 경로 (기본값: `/`) (`string`)          |
-| `--cors`        | CORS 활성화                                |
-| `--strictPort`  | 지정된 포트가 이미 사용 중인 경우 종료 (`boolean`)      |
-| `--force`       | 최적화기가 캐시를 무시하고 다시 번들링하도록 강제 (`boolean`) |
+| 옵션             | 설명                                                              |
+| ---------------- | ----------------------------------------------------------------- |
+| `--open [path]`  | 시작 시 브라우저 열기 (`boolean \| string`)                      |
+| `--port <port>`  | 포트 지정 (`number`)                                             |
+| `--base <path>`  | Public 기본 경로 (기본값: `/`) (`string`)                          |
+| `--cors`         | CORS 활성화                                                      |
+| `--strictPort`   | 지정된 포트가 이미 사용 중인 경우 종료 (`boolean`)               |
+| `--force`        | 옵티마이저가 캐시를 무시하고 다시 번들링하도록 강제 (`boolean`)  |
 
 ## `vitepress build`
 
-VitePress 사이트를 프로덕션 용으로 빌드합니다.
+VitePress 사이트를 프로덕션 빌드합니다.
 
-### 사용법
+### 사용법 {#usage-1}
 
 ```sh
 vitepress build [root]
 ```
 
-### 옵션
+### 옵션 {#options-1}
 
-| 옵션                             | 설명                                                                                   |
-|--------------------------------|--------------------------------------------------------------------------------------|
-| `--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`)                                |
+| 옵션                          | 설명                                                                                          |
+| ----------------------------- |---------------------------------------------------------------------------------------------|
+| `--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>` | 공개 기본 경로 (기본값: `/`) (`string`) |
-| `--port <port>` | 포트 지정 (`number`)               |
+| 옵션             | 설명                                      |
+| ---------------- | ----------------------------------------- |
+| `--base <path>`  | Public 기본 경로 (기본값: `/`) (`string`)   |
+| `--port <port>`  | 포트 지정 (`number`)                      |
 
 ## `vitepress init`
 
-현재 디렉토리에서 [설정 마법사](../guide/getting-started#setup-wizard) 시작.
+현재 디렉터리에서 [설정 마법사](../guide/getting-started#setup-wizard)를 시작합니다.
 
-### 사용법
+### 사용법 {#usage-3}
 
 ```sh
 vitepress init

diff --git a/docs/ko/reference/default-theme-badge.md b/docs/ko/reference/default-theme-badge.md
@@ -1,38 +1,38 @@
 # 배지 {#badge}
 
-배지는 헤더에 상태를 추가할 수 있게 해줍니다. 예를 들어, 섹션의 유형이나 지원되는 버전을 명시하는 것이 유용할 수 있습니다.
+배지는 헤더에 상태를 추가할 수 있게 해줍니다. 예를 들어, 섹션의 타입을 지정하거나 지원되는 버전을 표시하는 데 유용할 수 있습니다.
 
 ## 사용법 {#usage}
 
-글로벌하게 사용 가능한 `Badge` 컴포넌트를 사용할 수 있습니다.
+`Badge` 컴포넌트는 전역으로 사용 가능합니다.
 
 ```html
 ### 제목 <Badge type="info" text="default" />
 ### 제목 <Badge type="tip" text="^1.9.0" />
-### 제목 <Badge type="warning" text="beta" />
+### 제목 <Badge type="warning" text="배타" />
 ### 제목 <Badge type="danger" text="주의" />
 ```
 
 위 코드는 다음과 같이 렌더링됩니다:
 
 ### 제목 <Badge type="info" text="default" />
 ### 제목 <Badge type="tip" text="^1.9.0" />
-### 제목 <Badge type="warning" text="beta" />
+### 제목 <Badge type="warning" text="배타" />
 ### 제목 <Badge type="danger" text="주의" />
 
-## 사용자 정의 자식 요소 {#custom-children}
+## 커스텀 하위 노드 {#custom-children}
 
-`<Badge>`는 `children`을 받아들이며, 이는 배지 안에 표시됩니다.
+`<Badge>`는 `children`을 받아서 배지 내부에 표시합니다.
 
 ```html
-### 제목 <Badge type="info">사용자 정의 요소</Badge>
+### 제목 <Badge type="info">커스텀 노드</Badge>
 ```
 
-### 제목 <Badge type="info">사용자 정의 요소</Badge>
+### 제목 <Badge type="info">커스텀 노드</Badge>
 
-## 타입 색상 사용자 정의 {#customize-type-color}
+## 타입 색상 커스터마이징 {#customize-type-color}
 
-css 변수를 오버라이딩함으로써 배지의 스타일을 사용자 정의할 수 있습니다. 다음은 기본값입니다:
+배지의 스타일은 CSS 변수를 재정의하여 커스터마이징 할 수 있습니다. 다음은 기본값입니다:
 
 ```css
 :root {
@@ -56,14 +56,14 @@ css 변수를 오버라이딩함으로써 배지의 스타일을 사용자 정
 
 ## `<Badge>`
 
-`<Badge>` 컴포넌트는 다음의 prop들을 받습니다:
+`<Badge>` 컴포넌트는 다음과 같은 프로퍼티를 사용합니다:
 
 ```ts
 interface Props {
-  // `<slot>`이 전달되면, 이 값은 무시됩니다.
+  // `<slot>`이 전달되면, 이 값은 무시됨.
   text?: string
 
-  // 기본값은 `tip`입니다.
+  // 기본값: `tip`.
   type?: 'info' | 'tip' | 'warning' | 'danger'
 }
 ```
diff --git a/docs/ko/reference/default-theme-carbon-ads.md b/docs/ko/reference/default-theme-carbon-ads.md
@@ -1,13 +1,13 @@
 # 카본 광고 {#carbon-ads}
 
-VitePress는 [카본 광고](https://www.carbonads.net/)에 대한 내장된 네이티브 지원을 제공합니다. config에서 카본 광고 자격증명을 정의함으로써, VitePress는 페이지에 광고를 표시합니다.
+VitePress는 [카본 광고](https://www.carbonads.net/)에 대한 기본적인 지원을 제공합니다. 구성에서 카본 광고 자격 증명을 정의하면 VitePress는 페이지에 광고를 표시합니다.
 
 ```js
 export default {
   themeConfig: {
     carbonAds: {
-      code: '당신의-카본-코드',
-      placement: '당신의-카본-위치'
+      code: 'your-carbon-code',
+      placement: 'your-carbon-placement'
     }
   }
 }
@@ -19,4 +19,4 @@ export default {
 `//cdn.carbonads.com/carbon.js?serve=${code}&placement=${placement}`
 ```
 
-카본 광고 설정에 대해 자세히 알아보려면, [카본 광고 웹사이트](https://www.carbonads.net/)를 방문해 주십시오.
+카본 광고 구성에 대해 더 알고 싶다면 [카본 광고 웹사이트](https://www.carbonads.net/)를 방문하세요.