docs(ko): re-translation of korean documents (#4111)

docs/.vitepress/config/ko.ts

@@ -18,7 +18,7 @@ export const ko = defineConfig({
 
     editLink: {
       pattern: 'https://github.com/vuejs/vitepress/edit/main/docs/:path',
-      text: 'GitHub에서 이 페이지를 편집하세요'
+      text: '이 페이지 편집 제안하기'
     },
 
     footer: {
@@ -32,7 +32,7 @@ export const ko = defineConfig({
     },
 
     outline: {
-      label: '이 페이지에서'
+      label: '이 페이지 목차'
     },
 
     lastUpdated: {
@@ -105,49 +105,49 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] {
       collapsed: false,
       items: [
         {
-          text: '마크다운 확장',
+          text: '마크다운 확장 기능',
           link: 'markdown'
         },
         {
           text: '에셋 핸들링',
           link: 'asset-handling'
         },
         {
-          text: '프론트마터',
+          text: '전문(Front-matter)',
           link: 'frontmatter'
         },
         {
-          text: '마크다운에서 Vue 사용',
+          text: '마크다운에서 Vue 사용하기',
           link: 'using-vue'
         },
         {
-          text: '국제화',
+          text: 'i18n',
           link: 'i18n'
         }
       ]
     },
     {
-      text: '사용자 정의',
+      text: '커스텀',
       collapsed: false,
       items: [
         {
-          text: '맞춤 테마 사용',
+          text: '커스텀 테마 사용하기',
           link: 'custom-theme'
         },
         {
-          text: '기본 테마 확장',
+          text: '기본 테마 확장하기',
           link: 'extending-default-theme'
         },
         {
-          text: '빌드할 때 데이터 로딩',
+          text: '빌드할 때 데이터 로딩하기',
           link: 'data-loading'
         },
         {
           text: 'SSR 호환성',
           link: 'ssr-compat'
         },
         {
-          text: 'CMS 연결',
+          text: 'CMS 연결하기',
           link: 'cms'
         }
       ]
@@ -167,7 +167,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] {
       ]
     },
     {
-      text: '설정 & API 참조',
+      text: '구성 & API 레퍼런스',
       base: '/ko/reference/',
       link: 'site-config'
     }

docs/ko/guide/asset-handling.md

@@ -1,54 +1,54 @@
-# 자산 처리 {#asset-handling}
+# 에셋 핸들링 {#asset-handling}
 
-## 정적 자산 참조하기 {#referencing-static-assets}
+## 정적 에셋 참조하기 {#referencing-static-assets}
 
-모든 Markdown 파일은 Vue 컴포넌트로 컴파일되며 [Vite](https://vitejs.dev/ko/guide/assets.html)에 의해 처리됩니다. 상대 URL을 사용하여 어떠한 자산도 참조할 수 **있으며 해야 합니다**:
+모든 마크다운 파일은 Vue 컴포넌트로 컴파일되어 [Vite](https://vitejs.dev/guide/assets.html)에 의해 처리됩니다. 모든 에셋은 상대 URL을 사용하여 참조할 수 있으며, **참조해야 합니다**:
 
 ```md
 ![이미지](./image.png)
 ```
 
-Markdown 파일, 테마의 `*.vue` 컴포넌트, 스타일 및 일반 `.css` 파일에서 정적 자산을 참조할 수 있으며, 절대 공개 경로(프로젝트 루트를 기준으로 함) 또는 상대 경로(파일 시스템을 기준으로 함)를 사용할 수 있습니다. 후자는 Vite, Vue CLI 또는 webpack의 `file-loader`를 사용해 본 적이 있다면 익숙한 동작 방식과 유사합니다.
+마크다운 파일에서 정적 에셋을 참조할 수 있으며, 테마 내의 `*.vue` 컴포넌트, 스타일 및 일반 `.css` 파일을 절대 경로(프로젝트 루트를 기준으로) 또는 상대 경로(파일 시스템을 기준으로)를 사용하여 참조할 수 있습니다. 후자는 Vite, Vue CLI 또는 webpack의 `file-loader` 동작과 유사합니다.
 
-일반적인 이미지, 미디어, 폰트 파일 유형은 자동으로 자산으로 감지되어 포함됩니다.
+일반적인 이미지, 미디어 및 글꼴 파일 형식은 자동으로 에셋으로 감지되어 포함됩니다.
 
-::: tip 링크된 파일은 자산으로 취급되지 않음
-Markdown 파일 내의 링크로 참조된 PDF 또는 기타 문서는 자동으로 자산으로 취급되지 않습니다. 링크된 파일을 접근 가능하게 만들기 위해서는 수동으로 해당 파일을 프로젝트의 [`public`](#the-public-directory) 디렉토리에 배치해야 합니다.
+::: tip 링크를 통해 참조된 파일은 에셋으로 처리되지 않습니다
+마크다운 파일 내에서 링크로 참조된 PDF 또는 기타 문서는 자동으로 에셋으로 처리되지 않습니다. 링크된 파일을 접근 가능하게 하려면 프로젝트의 [`public`](#the-public-directory) 디렉토리에 수동으로 배치해야 합니다.
 :::
 
-절대 경로를 포함한 모든 참조된 자산은 생산 빌드에서 해시된 파일 이름으로 출력 디렉토리에 복사됩니다. 참조되지 않은 자산은 복사되지 않습니다. 4kb보다 작은 이미지 자산은 base64 인라인으로 처리됩니다 - 이는 [`vite`](../reference/site-config#vite) 구성 옵션을 통해 설정할 수 있습니다.
+절대 경로를 사용하는 에셋을 포함하여 모든 참조된 에셋은 프로덕션 빌드에서 해시된 파일 이름으로 출력 디렉토리에 복사됩니다. 참조되지 않은 에셋은 복사되지 않습니다. 4kb보다 작은 이미지 에셋은 base64로 인라인됩니다. 이는 [`vite`](../reference/site-config#vite) 구성 옵션을 통해 구성할 수 있습니다.
 
-모든 **정적** 경로 참조, 절대 경로를 포함하여, 작업 디렉토리 구조를 기반으로 해야 합니다.
+모든 **정적** 경로 참조는 절대 경로를 포함하여 작업 디렉토리 구조를 기반으로 해야 합니다.
 
-## Public 디렉토리 {#the-public-directory}
+## Public 디렉터리 {#the-public-directory}
 
-Markdown이나 테마 컴포넌트에서 직접 참조되지 않은 정적 자산을 제공할 필요가 있거나, 특정 파일을 원본 파일명으로 제공하고 싶은 경우가 있을 수 있습니다. 이러한 파일의 예로는 `robots.txt`, 파비콘, PWA 아이콘이 있습니다.
+때때로 마크다운이나 테마 컴포넌트에서 직접 참조되지 않는 정적 에셋을 제공해야 하거나 특정 파일을 원래 파일 이름으로 제공하고 싶을 때가 있습니다. 이러한 파일의 예로는 `robots.txt`, 파비콘, PWA 아이콘 등이 있습니다.
 
-이 파일들은 [소스 디렉토리](./routing#source-directory) 아래의 `public` 디렉토리에 배치할 수 있습니다. 예를 들어, 프로젝트 루트가 `./docs`이고 기본 소스 디렉토리 위치를 사용한다면, public 디렉토리는 `./docs/public`이 됩니다.
+이 파일들은 [소스 디렉토리](./routing#source-directory) 아래의 `public` 디렉토리에 놓을 수 있습니다. 예를 들어 프로젝트 루트가 `./docs`이고 기본 소스 디렉토리 위치를 사용 중인 경우, `public` 디렉토리는 `./docs/public`이 됩니다.
 
-`public`에 배치된 자산은 그대로 출력 디렉토리의 루트로 복사됩니다.
+`public`에 배치된 에셋은 출력 디렉토리의 루트로 그대로 복사됩니다.
 
-`public`에 배치된 파일을 참조할 때는 루트 절대 경로를 사용해야 한다는 점에 유의하세요 - 예를 들어, `public/icon.png`는 소스 코드에서 항상 `/icon.png`로 참조되어야 합니다.
+`public`에 배치된 파일은 루트 절대 경로를 사용하여 참조해야 한다는 점에 유의하세요. 예를 들어, `public/icon.png`는 소스 코드에서 항상 `/icon.png`로 참조되어야 합니다.
 
-## 기본 URL {#base-url}
+## Base URL {#base-url}
 
-사이트가 루트 URL이 아닌 곳에 배포되는 경우, `.vitepress/config.js`에서 `base` 옵션을 설정해야 합니다. 예를 들어, 사이트를 `https://foo.github.io/bar/`에 배포할 계획이라면, `base`는 `'/bar/'`(항상 슬래시로 시작하고 끝나야 함)로 설정해야 합니다.
+사이트가 루트 URL이 아닌 곳에 배포된 경우, `.vitepress/config.js`에서 `base` 옵션을 설정해야 합니다. 예를 들어, 사이트를 `https://foo.github.io/bar/`에 배포하려는 경우 `base`는 `'/bar/'`로 설정해야 합니다(항상 슬래시로 시작하고 끝나야 합니다).
 
-모든 정적 자산 경로는 다양한 `base` 구성 값에 맞게 자동으로 처리됩니다. 예를 들어, 마크다운에서 `public` 아래에 있는 자산에 대한 절대 참조가 있는 경우:
+모든 정적 에셋 경로는 다른 `base` 구성 값에 맞게 자동으로 처리됩니다. 예를 들어, 마크다운에서 `public` 하위의 에셋에 대한 절대 참조가 있는 경우:
 
 ```md
 ![이미지](/image-inside-public.png)
 ```
 
-이 경우 `base` 구성 값을 변경하더라도 업데이트할 필요가 **없습니다**.
+이 경우 `base` 구성 값을 변경할 때 **업데이트할 필요가 없습니다**.
 
-그러나 자산을 동적으로 연결하는 테마 컴포넌트를 작성하는 경우, 예를 들어 테마 구성 값에 기반한 이미지의 `src`가 있는 경우:
+그러나 테마 구성 값을 기반으로 `src`가 설정된 이미지와 같이 동적으로 에셋에 링크하는 테마 컴포넌트를 작성하는 경우:
 
 ```vue
 <img :src="theme.logoPath" />
 ```
 
-이 경우 VitePress에 제공되는 [`withBase` 헬퍼](../reference/runtime-api#withbase)로 경로를 래핑하는 것이 권장됩니다:
+이 경우 VitePress에서 제공하는 [`withBase` 헬퍼](../reference/runtime-api#withbase)로 경로를 감싸는 것이 좋습니다:
 
 ```vue
 <script setup>

docs/ko/guide/cms.md

@@ -4,13 +4,13 @@ outline: deep
 
 # CMS에 연결하기 {#connecting-to-a-cms}
 
-## 일반 워크플로우 {#general-workflow}
+## 일반적인 워크플로우 {#general-workflow}
 
-VitePress를 CMS에 연결하는 것은 주로 [동적 라우트](./routing#dynamic-routes)를 중심으로 진행될 것입니다. 진행하기 전에 이것이 어떻게 작동하는지 이해하는 것이 중요합니다.
+VitePress를 CMS에 연결하는 것은 주로 [동적 라우트](./routing#dynamic-routes)를 중심으로 이루어질 것입니다. 진행하기 전에 작동 방식을 이해해야 합니다.
 
-각 CMS는 다르게 작동하기 때문에, 여기서는 특정 상황에 맞게 조정해야 할 일반적인 워크플로우만 제공할 수 있습니다.
+각 CMS가 다르게 작동하므로, 여기서는 특정 상황에 맞게 조정해야 하는 일반적인 워크플로우만 제공할 수 있습니다.
 
-1. CMS에서 인증이 필요한 경우, API 토큰을 저장할 `.env` 파일을 만들고 다음과 같이 로드하세요:
+1. CMS가 인증을 요구하는 경우, `.env` 파일을 생성하여 API 토큰을 저장하고 다음과 같이 로드하세요:
 
     ```js
     // posts/[id].paths.js
@@ -19,15 +19,15 @@ VitePress를 CMS에 연결하는 것은 주로 [동적 라우트](./routing#dyna
     const env = loadEnv('', process.cwd())
     ```
 
-2. CMS에서 필요한 데이터를 가져와 적절한 경로 데이터로 포맷하세요:
+2. CMS에서 필요한 데이터를 가져와 적절한 경로 데이터로 형식을 지정하세요:
 
     ```js
     export default {
       async paths() {
-        // 필요시 각 CMS 클라이언트 라이브러리 사용
+        // 필요한 경우 해당 CMS 클라이언트 라이브러리 사용
         const data = await (await fetch('https://my-cms-api', {
           headers: {
-            // 필요한 경우 토큰
+            // 필요한 경우 토큰을 사용
           }
         })).json()
 
@@ -41,16 +41,16 @@ VitePress를 CMS에 연결하는 것은 주로 [동적 라우트](./routing#dyna
     }
     ```
 
-3. 페이지에서 콘텐츠를 렌더링하세요:
+3. 페이지의 컨텐츠를 렌더링하세요:
 
     ```md
     # {{ $params.title }}
 
-    - {{ $params.author }}에 의해 {{ $params.date }}에
+    - 작성자: {{ $params.author }}, 작성일: {{ $params.date }}
 
     <!-- @content -->
     ```
 
 ## 통합 가이드 {#integration-guides}
 
-VitePress와 특정 CMS의 통합에 대한 가이드를 작성한 경우, 아래 "이 페이지 편집" 링크를 사용하여 여기에 제출하세요!
+VitePress를 특정 CMS와 통합하는 방법에 대한 가이드를 작성한 경우 아래의 "이 페이지 편집 제안하기" 링크를 클릭하여 여기에 제출하세요!