diff --git a/docs/.vitepress/config/ko.ts b/docs/.vitepress/config/ko.ts index 44f7b446..004cb9ee 100644 --- a/docs/.vitepress/config/ko.ts +++ b/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,7 +105,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] { collapsed: false, items: [ { - text: '마크다운 확장', + text: '마크다운 확장 기능', link: 'markdown' }, { @@ -113,33 +113,33 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] { 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' }, { @@ -147,7 +147,7 @@ function sidebarGuide(): DefaultTheme.SidebarItem[] { 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' } diff --git a/docs/ko/guide/asset-handling.md b/docs/ko/guide/asset-handling.md index 0054397c..5f6a35d1 100644 --- a/docs/ko/guide/asset-handling.md +++ b/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 ``` -이 경우 VitePress에 제공되는 [`withBase` 헬퍼](../reference/runtime-api#withbase)로 경로를 래핑하는 것이 권장됩니다: +이 경우 VitePress에서 제공하는 [`withBase` 헬퍼](../reference/runtime-api#withbase)로 경로를 감싸는 것이 좋습니다: ```vue ``` -[`useData()`](../reference/runtime-api#usedata) 헬퍼는 우리가 필요로 하는 모든 런타임 데이터를 제공하여, 다른 레이아웃을 조건부로 렌더링할 수 있습니다. 우리가 접근할 수 있는 또 다른 데이터는 현재 페이지의 프론트매터입니다. 이를 활용하여 사용자가 각 페이지의 레이아웃을 제어할 수 있도록 합니다. 예를 들어, 사용자는 특별한 홈페이지 레이아웃을 사용해야 한다고 지정할 수 있습니다: +[`useData()`](../reference/runtime-api#usedata) 헬퍼는 다양한 레이아웃을 조건부로 렌더링하는 데 필요한 모든 런타임 데이터를 제공합니다. 접근할 수 있는 다른 데이터 중 하나는 현재 페이지의 전문(front-matter)입니다. 이를 활용하여 각 페이지에 맞게 레이아웃을 제어할 수 있습니다. 예를 들어 특정 페이지에서 홈 페이지 레이아웃을 사용하도록 지정할 수 있습니다: ```md --- @@ -108,7 +108,7 @@ layout: home --- ``` -그리고 우리는 이를 처리하기 위해 테마를 조정할 수 있습니다: +그리고 이를 처리하도록 테마를 조정할 수 있습니다: ```vue{3,12-14} ``` -물론, 레이아웃을 더 많은 컴포넌트로 나눌 수 있습니다: +물론 레이아웃을 더 많은 컴포넌트로 나눌 수 있습니다: ```vue{3-5,12-15} ``` -테마 컴포넌트에서 사용할 수 있는 모든 것에 대한 [런타임 API 참조](../reference/runtime-api)를 참조하세요. 또한, [빌드할 때 데이터 로딩](./data-loading)을 활용하여 데이터 기반 레이아웃을 생성할 수 있습니다 - 예를 들어, 현재 프로젝트 내 모든 블로그 포스트를 나열하는 페이지 등. +테마 컴포넌트에서 사용할 수 있는 모든 항목에 대해서는 [런타임 API 레퍼런스](../reference/runtime-api)를 참고하세요. 또한 [빌드할 때 데이터 로딩하기](./data-loading)를 활용하여 데이터 기반의 레이아웃을 생성할 수 있습니다. 예를 들어 현재 프로젝트의 모든 블로그 게시물을 나열하는 페이지를 만들 수 있습니다. ## 사용자 정의 테마 배포하기 {#distributing-a-custom-theme} -사용자 정의 테마를 배포하는 가장 쉬운 방법은 [GitHub에서 템플릿 저장소로 제공하는 것입니다](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository). +커스텀 테마를 배포하는 가장 쉬운 방법은 [GitHub 템플릿 리포지토리](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-template-repository)로 제공하는 것입니다. -npm 패키지로 테마를 배포하려면 다음 단계를 따르세요: +테마를 npm 패키지로 배포하려면 다음 단계를 따라야 합니다: -1. 패키지 엔트리에서 테마 객체를 기본 내보내기로 내보냅니다. +1. 패키지 엔트리에서 테마 객체를 "export default" 합니다. -2. 적용된다면, 테마 설정 타입 정의를 `ThemeConfig`로 내보냅니다. +2. 해당되는 경우, 테마 구성 타입 정의를 `ThemeConfig`로 "export" 합니다. -3. 테마가 VitePress 설정을 조정해야 하는 경우, 사용자가 확장할 수 있도록 패키지 하위 경로(예: `my-theme/config`)에 해당 설정을 내보냅니다. +3. 테마에서 VitePress 구성을 조정해야 하는 경우, 사용자가 확장할 수 있도록 패키지 하위 경로(예: `my-theme/config`)에 해당 구성을 "export" 합니다. -4. 설정 파일 및 프론트매터를 통한 테마 설정 옵션을 문서화합니다. +4. 테마 구성 옵션을 문서화합니다 (구성 파일과 전문 둘 다). -5. 테마를 소비하는 방법에 대한 명확한 지침을 제공합니다(아래 참조). +5. 테마를 사용하는 방법에 대한 명확한 지침을 제공합니다 (아래 참조). -## 사용자 정의 테마 소비하기 {#consuming-a-custom-theme} +## 커스텀 테마 사용하기 {#consuming-a-custom-theme} -외부 테마를 소비하려면 사용자 정의 테마 엔트리에서 가져와서 다시 내보냅니다: +외부 테마를 사용하려면, 커스텀 테마 엔트리에서 테마를 "import" 후 다시 "export"합니다: ```js // .vitepress/theme/index.js @@ -193,19 +193,19 @@ export default { } ``` -테마가 특별한 VitePress 설정을 요구하는 경우, 자신의 설정에서도 그 설정을 확장해야 합니다: +테마가 특별한 VitePress 구성을 요구하는 경우, 해당 구성을 (외부 커스텀 테마를 사용하는 자신의) 구성 파일에서도 확장해야 합니다: ```ts // .vitepress/config.ts import baseConfig from 'awesome-vitepress-theme/config' export default { - // 필요한 경우 테마 기본 설정 확장 + // 필요한 경우 테마 기본 구성 확장 extends: baseConfig } ``` -마지막으로, 테마가 테마 설정에 대한 타입을 제공하는 경우: +마지막으로 테마가 테마 구성에 대한 타입을 제공하는 경우: ```ts // .vitepress/config.ts diff --git a/docs/ko/guide/data-loading.md b/docs/ko/guide/data-loading.md index fb61c48f..c95b57be 100644 --- a/docs/ko/guide/data-loading.md +++ b/docs/ko/guide/data-loading.md @@ -1,12 +1,12 @@ -# 빌드할 때 데이터 로딩 {#build-time-data-loading} +# 빌드할 때 데이터 로딩하기 {#build-time-data-loading} -VitePress는 **데이터 로더**라고 불리는 기능을 제공하여 임의의 데이터를 로드하고 페이지나 컴포넌트에서 가져올 수 있습니다. 데이터 로딩은 **빌드 시간에만 실행**됩니다: 결과적으로 생성된 데이터는 최종 자바스크립트 번들에 JSON으로 직렬화됩니다. +VitePress는 페이지나 컴포넌트에서 임의의 데이터를 로드하고 이를 가져올 수 있는 **데이터 로더** 기능을 제공합니다. 데이터 로딩은 **빌드할 때에만** 실행되며, 결과적으로 생성된 데이터는 최종 JavaScript 번들에 JSON으로 직렬화됩니다. -데이터 로더는 원격 데이터를 가져오거나 로컬 파일을 기반으로 메타데이터를 생성하는 데 사용할 수 있습니다. 예를 들어, 모든 로컬 API 페이지를 파싱하고 모든 API 항목의 색인을 자동으로 생성하기 위해 데이터 로더를 사용할 수 있습니다. +데이터 로더는 원격 데이터를 가져오거나 로컬 파일을 기반으로 메타데이터를 생성하는 데 사용할 수 있습니다. 예를 들어, 데이터 로더를 사용하여 모든 로컬 API 페이지를 파싱하고 모든 API 항목의 색인을 자동으로 생성할 수 있습니다. ## 기본 사용법 {#basic-usage} -데이터 로더 파일은 `.data.js` 또는 `.data.ts`로 끝나야 합니다. 이 파일은 `load()` 메서드를 가진 객체를 기본 내보내기해야 합니다: +데이터 로더 파일은 반드시 `.data.js` 또는 `.data.ts`로 끝나야 합니다. 이 파일은 `load()` 메서드를 가진 객체를 "export default" 해야 합니다: ```js // example.data.js @@ -19,9 +19,9 @@ export default { } ``` -로더 모듈은 Node.js에서만 평가되므로, 필요에 따라 Node API와 npm 종속성을 가져올 수 있습니다. +로더 모듈은 Node.js에서만 평가되므로, 필요한 경우 Node API와 npm 종속성을 "import" 할 수 있습니다. -이 파일에서 데이터를 `.md` 페이지와 `.vue` 컴포넌트에서 `data`라는 이름으로 내보낼 수 있습니다: +그런 다음 `.md` 페이지와 `.vue` 컴포넌트에서 `data`라는 이름으로 "export" 한 데이터를 이 파일에서 "import" 할 수 있습니다: ```vue