From 7ae7c0743bf6c2b94cdbcaa381482981be56cc65 Mon Sep 17 00:00:00 2001 From: Niceplugin Date: Thu, 8 Aug 2024 23:55:19 +0900 Subject: [PATCH] translate: reference docs --- docs/.vitepress/config/ko.ts | 10 +- docs/ko/reference/cli.md | 64 ++--- docs/ko/reference/default-theme-carbon-ads.md | 8 +- docs/ko/reference/default-theme-config.md | 133 +++++----- docs/ko/reference/default-theme-nav.md | 58 ++--- docs/ko/reference/default-theme-sidebar.md | 38 +-- docs/ko/reference/frontmatter-config.md | 86 +++---- docs/ko/reference/runtime-api.md | 60 ++--- docs/ko/reference/site-config.md | 234 +++++++++--------- 9 files changed, 352 insertions(+), 339 deletions(-) diff --git a/docs/.vitepress/config/ko.ts b/docs/.vitepress/config/ko.ts index 004cb9ee..906669d3 100644 --- a/docs/.vitepress/config/ko.ts +++ b/docs/.vitepress/config/ko.ts @@ -180,7 +180,7 @@ 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' }, { @@ -188,16 +188,16 @@ function sidebarReference(): DefaultTheme.SidebarItem[] { 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/reference/cli.md b/docs/ko/reference/cli.md index 53adc4ff..4a76bd01 100644 --- 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 ` | 포트 지정 (`number`) | -| `--base ` | 공개 기본 경로 (기본값: `/`) (`string`) | -| `--cors` | CORS 활성화 | -| `--strictPort` | 지정된 포트가 이미 사용 중인 경우 종료 (`boolean`) | -| `--force` | 최적화기가 캐시를 무시하고 다시 번들링하도록 강제 (`boolean`) | +| 옵션 | 설명 | +| ---------------- | ----------------------------------------------------------------- | +| `--open [path]` | 시작 시 브라우저 열기 (`boolean \| string`) | +| `--port ` | 포트 지정 (`number`) | +| `--base ` | 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 ` | 공개 기본 경로 (기본값: `/`) (`string`) | -| `--target ` | 트랜스파일 대상 (기본값: `"modules"`) (`string`) | -| `--outDir ` | **cwd**에 상대적인 출력 디렉토리 (기본값: `/.vitepress/dist`) (`string`) | -| `--minify [minifier]` | 미니화 활성화/비활성화하거나 사용할 미니화기를 지정 (기본값: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) | -| `--assetsInlineLimit ` | 바이트 단위로 정적 자산 base64 인라인 임계값 (기본값: `4096`) (`number`) | +| 옵션 | 설명 | +| ----------------------------- |---------------------------------------------------------------------------------------------| +| `--mpa` (실험적) | 클라이언트 측 하이드레이션 없이 [MPA 모드](../guide/mpa-mode)로 빌드 (`boolean`) | +| `--base ` | Public 기본 경로 (기본값: `/`) (`string`) | +| `--target ` | 트랜스파일 대상 (기본값: `"modules"`) (`string`) | +| `--outDir ` | **cwd** 기준 출력 디렉터리 (기본값: `/.vitepress/dist`) (`string`) | +| `--minify [minifier]` | minify 활성화/비활성화 또는 사용할 minify 도구 지정 (기본값: `"esbuild"`) (`boolean \| "terser" \| "esbuild"`) | +| `--assetsInlineLimit `| 바이트 단위의 정적 에셋 base64 인라인 임계값 (기본값: `4096`) (`number`) | ## `vitepress preview` -프로덕션 빌드를 로컬에서 미리 볼 수 있습니다. +프로덕션 빌드를 로컬에서 미리 보기 합니다. -### 사용법 +### 사용법 {#usage-2} ```sh vitepress preview [root] ``` -### 옵션 +### 옵션 {#options-2} -| 옵션 | 설명 | -|-----------------|--------------------------------| -| `--base ` | 공개 기본 경로 (기본값: `/`) (`string`) | -| `--port ` | 포트 지정 (`number`) | +| 옵션 | 설명 | +| ---------------- | ----------------------------------------- | +| `--base ` | Public 기본 경로 (기본값: `/`) (`string`) | +| `--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-carbon-ads.md b/docs/ko/reference/default-theme-carbon-ads.md index 370465a6..6a677289 100644 --- 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/)를 방문하세요. diff --git a/docs/ko/reference/default-theme-config.md b/docs/ko/reference/default-theme-config.md index c57c56ef..b9ae6987 100644 --- a/docs/ko/reference/default-theme-config.md +++ b/docs/ko/reference/default-theme-config.md @@ -1,14 +1,14 @@ -# 기본 테마 설정 {#default-theme-config} +# 기본 테마 구성 {#default-theme-config} -테마 설정을 통해 테마를 사용자 정의할 수 있습니다. 설정 파일의 `themeConfig` 옵션을 통해 테마 설정을 정의할 수 있습니다: +테마 구성은 테마를 커스텀 할 수 있게 해줍니다. 구성 파일에서 `themeConfig` 옵션을 통해 테마 구성을 정의할 수 있습니다: ```ts export default { - lang: 'en-US', + lang: 'ko-KR', title: 'VitePress', - description: 'Vite & Vue로 구동되는 정적 사이트 생성기.', + description: 'Vite 및 Vue로 기반 정적 사이트 생성기.', - // 테마 관련 설정. + // 테마 관련 구성. themeConfig: { logo: '/logo.svg', nav: [...], @@ -17,19 +17,19 @@ export default { } ``` -**이 페이지에 문서화된 옵션은 기본 테마에만 적용됩니다.** 다른 테마는 다른 테마 설정을 기대합니다. 커스텀 테마를 사용할 때, 테마 설정 객체는 테마로 전달되어 테마가 그것에 따라 조건적인 동작을 정의할 수 있습니다. +**이 페이지에 문서화된 옵션은 기본 테마에만 적용됩니다.** 다른 테마는 다른 테마 구성이 필요합니다. 커스텀 테마를 사용하는 경우, 테마 구성 객체는 테마에 전달되어 테마가 이를 기반으로 다르게 동작할 수 있습니다. ## i18nRouting - 타입: `boolean` -예를 들어 `zh`로 로케일을 변경하면 URL이 `/foo` (또는 `/en/foo/`)에서 `/zh/foo`로 변경됩니다. 이 동작을 비활성화하려면 `themeConfig.i18nRouting`을 `false`로 설정하세요. +로케일을 `ko`로 변경하면 URL이 `/foo` (또는 `/en/foo/`)에서 `/ko/foo`로 변경됩니다. 이 동작을 비활성화하려면 `themeConfig.i18nRouting`을 `false`로 설정하세요. ## logo - 타입: `ThemeableImage` -내비게이션 바에 사이트 제목 바로 앞에 표시되는 로고 파일입니다. 경로 문자열을 받거나, 밝은/어두운 모드에 따라 다른 로고를 설정하기 위해 객체를 사용할 수 있습니다. +네비게이션 바에 사이트 제목 바로 앞에 표시할 로고 파일입니다. 경로 문자열 또는 라이트/다크 모드에 대해 다른 로고를 설정할 수 있는 객체를 사용합니다. ```ts export default { @@ -50,7 +50,7 @@ type ThemeableImage = - 타입: `string | false` -내비게이션에서 기본 사이트 제목(`app config`의 `title`)을 대체하기 위해 이 항목을 사용자 정의할 수 있습니다. `false`로 설정하면 내비게이션의 제목이 비활성화됩니다. `logo`가 이미 사이트 제목 텍스트를 포함하고 있을 때 유용합니다. +이 항목을 커스텀하여 네비게이션 바의 기본 사이트 제목(애플리케이션 구성의 `title`)을 대체할 수 있습니다. `false`로 설정하면 네비게이션 바에서 제목이 비활성화됩니다. 이미 사이트 제목 텍스트가 포함된 `logo`가 있을 때 유용합니다. ```ts export default { @@ -64,7 +64,7 @@ export default { - 타입: `NavItem` -내비게이션 메뉴 항목의 설정입니다. 자세한 내용은 [기본 테마: Nav](./default-theme-nav#navigation-links)에서 확인할 수 있습니다. +네비게이션 바 메뉴 아이템의 구성입니다. 자세한 내용은 [기본 테마: 네비게이션 바](./default-theme-nav#navigation-links)를 참고하세요. ```ts export default { @@ -112,7 +112,7 @@ interface NavItemWithChildren { - 타입: `Sidebar` -사이드바 메뉴 항목의 설정입니다. 자세한 내용은 [기본 테마: Sidebar](./default-theme-sidebar)에서 확인할 수 있습니다. +사이드바 메뉴 항목에 대한 구성입니다. 자세한 내용은 [기본 테마: 사이드바](./default-theme-sidebar)에서 확인하세요. ```ts export default { @@ -140,28 +140,41 @@ export interface SidebarMulti { export type SidebarItem = { /** - * 항목의 텍스트 레이블. + * 아이템의 텍스트 레이블 */ text?: string /** - * 항목의 링크. + * 아이템의 링크 */ link?: string /** - * 항목의 자식들. + * 아이템의 하위 항목 */ items?: SidebarItem[] /** - * 명시되지 않은 경우, 그룹은 접을 수 없습니다. + * 명시하지 않은 경우, 그룹을 접을 수 없습니다. * - * `true`이면, 그룹은 접을 수 있고 기본적으로 접혀 있습니다 + * `true`: 그룹은 접을 수 있고 기본적으로 접혀 있습니다. * - * `false`이면, 그룹은 접을 수 있지만 기본적으로 펼쳐져 있습니다 + * `false`: 그룹은 접을 수 있고 기본적으로 펼쳐져 있습니다. */ collapsed?: boolean + + /** + * 하위 아이템에 대한 기본 경로입니다. + */ + base?: string + + /** + * 이전/다음 페이지의 푸터에 나타나는 텍스트를 커스텀 합니다. + */ + docFooterText?: string + + rel?: string + target?: string } ``` @@ -169,37 +182,37 @@ export type SidebarItem = { - 타입: `boolean | 'left'` - 기본값: `true` -- [frontmatter](./frontmatter-config#aside)를 통해 페이지별로 재정의 가능 +- [전문](./frontmatter-config#aside)을 통해 페이지별로 재정의할 수 있습니다. -이 값을 `false`로 설정하면 aside 컨테이너의 렌더링을 방지합니다.\ -이 값을 `true`로 설정하면 aside를 오른쪽에 렌더링합니다.\ -이 값을 `left`로 설정하면 aside를 왼쪽에 렌더링합니다. +`false`: 어사이드 컨테이너가 렌더링되지 않습니다.\ +`true`: 어사이드가 오른쪽에 렌더링됩니다.\ +`left`: 어사이드가 왼쪽에 렌더링됩니다. -모든 뷰포트에 대해 비활성화하려면 `outline: false`를 사용해야 합니다. +모든 뷰포트에서 비활성화하려면 `outline: false`를 사용해야 합니다. ## outline - 타입: `Outline | Outline['level'] | false` -- [frontmatter](./frontmatter-config#outline)를 통해 페이지별로 레벨 재정의 가능 +- [전문](./frontmatter-config#outline)을 사용해 각 페이지별로 계층 구조를 재정의할 수 있습니다. -이 값을 `false`로 설정하면 윤곽선 컨테이너의 렌더링을 방지합니다. 자세한 내용은 이 인터페이스를 참조하세요: +이 값을 `false`로 설정하면 아웃라인(개요) 컨테이너가 렌더링되지 않습니다. 자세한 내용은 아래 인터페이스를 참고하세요: ```ts interface Outline { /** - * 개요에 표시될 제목 수준. - * 단일 수치는 해당 수준의 제목만 표시됨을 의미합니다. - * 튜플이 전달되면 첫 번째 수치는 최소 수준이고 두 번째 수치는 최대 수준입니다. - * `'deep'`은 `[2, 6]`과 동일하며, `

`부터 `

`까지의 모든 제목이 표시됨을 의미합니다. + * 아웃라인에 표시할 제목 레벨. + * 단일 숫자는 해당 레벨의 제목만 표시됨을 의미합니다. + * 튜플이 전달되면, 첫 번째 숫자는 최소 수준을, 두 번째 숫자는 최대 수준을 나타냅니다. + * `'deep'`은 `[2, 6]`과 동일하며, 이는 `

`에서 `

`까지의 모든 제목이 표시됨을 의미합니다. * * @default 2 */ level?: number | [number, number] | 'deep' /** - * 개요에 표시될 제목. + * 아웃라인에 표시될 제목. * - * @default '이 페이지에서' + * @default 'On this page' */ label?: string } @@ -209,7 +222,7 @@ interface Outline { - 타입: `SocialLink[]` -내비게이션에 아이콘과 함께 소셜 계정 링크를 표시하기 위해 이 옵션을 정의할 수 있습니다. +이 옵션을 정의하여 네비게이션 바에 소셜 링크를 아이콘과 함께 표시할 수 있습니다. ```ts export default { @@ -217,14 +230,14 @@ export default { socialLinks: [ { icon: 'github', link: 'https://github.com/vuejs/vitepress' }, { icon: 'twitter', link: '...' }, - // SVG 문자열을 전달하여 사용자 정의 아이콘을 추가할 수도 있습니다: + // SVG를 문자열로 전달하여 커스텀 아이콘을 추가할 수도 있습니다: { icon: { - svg: 'Dribbble' + svg: '' }, link: '...', - // 접근성을 위해 사용자 정의 레이블을 포함할 수도 있습니다 (선택 사항이지만 권장됨): - ariaLabel: '멋진 링크' + // 접근성을 위해 커스텀 레이블을 포함할 수도 있습니다 (선택 사항이지만 권장됨): + ariaLabel: '스타 링크' } ] } @@ -256,16 +269,16 @@ type SocialLinkIcon = ## footer - 타입: `Footer` -- [frontmatter](./frontmatter-config#footer)를 통해 페이지별로 재정의 가능 +- [전문](./frontmatter-config#footer)을 사용해 페이지별로 재정의할 수 있습니다. -풋터 설정입니다. 풋터에 메시지나 저작권 텍스트를 추가할 수 있지만, 사이드바를 포함하지 않는 페이지에서만 표시됩니다. 이는 디자인 우려사항 때문입니다. +푸터 구성입니다. 메시지 또는 저작권 텍스트를 푸터에 추가할 수 있지만, 이는 페이지에 사이드바가 포함되지 않은 경우에만 표시됩니다. 이는 디자인상의 이유 때문입니다. ```ts export default { themeConfig: { footer: { message: 'MIT 라이선스에 따라 릴리즈되었습니다.', - copyright: '저작권 © 2019-현재 Evan You' + copyright: '저작권 © 2019-현재 홍길동' } } } @@ -274,16 +287,16 @@ export default { ```ts export interface Footer { message?: string - COPYRIGHT?: string + copyright?: string } ``` ## editLink - 타입: `EditLink` -- [frontmatter](./frontmatter-config#editlink)를 통해 페이지별로 재정의 가능 +- [전문](./frontmatter-config#footer)을 사용해 페이지별로 재정의할 수 있습니다. -편집 링크를 통해 GitHub이나 GitLab과 같은 Git 관리 서비스에서 페이지를 편집하는 링크를 표시할 수 있습니다. [기본 테마: 편집 링크](./default-theme-edit-link)에서 자세한 내용을 확인하세요. +편집 링크 기능을 사용하면 GitHub 또는 GitLab과 같은 Git 관리 서비스에서 페이지를 편집할 수 있는 링크를 표시할 수 있습니다. 자세한 내용은 [기본 테마: 편집 링크](./default-theme-edit-link)를 참고하세요. ```ts export default { @@ -307,13 +320,13 @@ export interface EditLink { - 타입: `LastUpdatedOptions` -마지막 업데이트 텍스트와 날짜 형식을 사용자 정의할 수 있습니다. +마지막 업데이트된 날짜의 텍스트와 날짜 형식을 커스텀 할 수 있습니다. ```ts export default { themeConfig: { lastUpdated: { - text: '업데이트 되었습니다', + text: '마지막 업데이트 날짜', formatOptions: { dateStyle: 'full', timeStyle: 'medium' @@ -326,7 +339,7 @@ export default { ```ts export interface LastUpdatedOptions { /** - * @default '마지막 업데이트' + * @default 'Last updated' */ text?: string @@ -342,7 +355,7 @@ export interface LastUpdatedOptions { - 타입: `AlgoliaSearch` -[Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch)를 사용하여 문서 사이트를 검색할 수 있는 옵션입니다. [기본 테마: 검색](./default-theme-search)에서 자세히 알아보세요. +[Algolia DocSearch](https://docsearch.algolia.com/docs/what-is-docsearch)를 사용하여 문서 사이트를 검색할 수 있는 옵션입니다. 자세한 내용은 [기본 테마: 검색](./default-theme-search)을 참고하세요. ```ts export interface AlgoliaSearchOptions extends DocSearchProps { @@ -376,13 +389,13 @@ export interface CarbonAdsOptions { } ``` -[기본 테마: Carbon Ads](./default-theme-carbon-ads)에서 자세히 알아보세요. +자세한 내용은 [기본 테마: 카본 광고](./default-theme-carbon-ads)를 참고하세요. ## docFooter - 타입: `DocFooter` -영어로 문서를 작성하지 않을 때 이전 및 다음 링크 위에 나타나는 텍스트를 사용자 정의하는 데 사용할 수 있습니다. 또한 이전/다음 링크를 전역적으로 비활성화할 수 있습니다. 이전/다음 링크를 선택적으로 활성화/비활성화하려면 [frontmatter](./default-theme-prev-next-links)를 사용할 수 있습니다. +이 옵션은 이전 및 다음 링크에 표시되는 텍스트를 커스텀하는 데 사용합니다. 영어로 문서를 작성하지 않는 경우 유용합니다. 또한 이전/다음 링크를 전역적으로 비활성화할 수도 있습니다. 선택적으로 이전/다음 링크를 활성화/비활성화하려면 [전문](./default-theme-prev-next-links)을 사용합니다. ```ts export default { @@ -405,48 +418,48 @@ export interface DocFooter { ## darkModeSwitchLabel - 타입: `string` -- 기본값: `외관` +- 기본값: `Appearance` -어두운 모드 전환 레이블을 사용자 정의하는 데 사용할 수 있습니다. 이 레이블은 모바일 뷰에서만 표시됩니다. +이 옵션은 다크 모드 스위치 레이블을 커스텀할 때 사용합니다. 이 레이블은 모바일 뷰에서만 표시됩니다. ## lightModeSwitchTitle - 타입: `string` -- 기본값: `라이트 테마로 전환` +- 기본값: `Switch to light theme` -호버 시 나타나는 라이트 모드 전환 제목을 사용자 정의하는 데 사용할 수 있습니다. +이 옵션은 라이트 모드 스위치 타이틀을 커스텀할 때 사용합니다. 이것은 호버(hover)할 때 나타납니다. ## darkModeSwitchTitle - 타입: `string` -- 기본값: `어두운 테마로 전환` +- 기본값: `Switch to dark theme` -호버 시 나타나는 어두운 모드 전환 제목을 사용자 정의하는 데 사용할 수 있습니다. +호버 시 나타나는 다크 모드 스위치 타이틀을 커스텀할 때 사용합니다. ## sidebarMenuLabel - 타입: `string` -- 기본값: `메뉴` +- 기본값: `Menu` -사이드바 메뉴 레이블을 사용자 정의하는 데 사용할 수 있습니다. 이 레이블은 모바일 뷰에서만 표시됩니다. +사이드바 메뉴 레이블을 커스텀 할 때 사용합니다. 이 레이블은 모바일 뷰에서만 표시됩니다. ## returnToTopLabel - 타입: `string` -- 기본값: `맨 위로 돌아가기` +- 기본값: `Return to top` -맨 위로 돌아가기 버튼의 레이블을 사용자 정의하는 데 사용할 수 있습니다. 이 레이블은 모바일 뷰에서만 표시됩니다. +맨 위로 이동 버튼의 레이블을 커스텀 할 때 사용합니다. 이 레이블은 모바일 뷰에서만 표시됩니다. ## langMenuLabel - 타입: `string` -- 기본값: `언어 변경` +- 기본값: `Change language` -내비게이션 바의 언어 토글 버튼의 aria-label을 사용자 정의하는 데 사용됩니다. [i18n](../guide/i18n)을 사용하는 경우에만 사용됩니다. +네비게이션 바에서 언어 토글 버튼의 aria-label을 커스텀 할 때 사용합니다. 이는 [i18n](../guide/i18n)을 사용하는 경우에만 사용됩니다. ## externalLinkIcon - 타입: `boolean` - 기본값: `false` -마크다운의 외부 링크 옆에 외부 링크 아이콘을 표시할지 여부입니다. +마크다운의 외부 링크 옆에 외부 링크 아이콘을 표시할지 여부를 설정합니다. diff --git a/docs/ko/reference/default-theme-nav.md b/docs/ko/reference/default-theme-nav.md index ea6063ca..5acb88d8 100644 --- a/docs/ko/reference/default-theme-nav.md +++ b/docs/ko/reference/default-theme-nav.md @@ -1,10 +1,10 @@ -# Nav {#nav} +# 네비게이션 바 {#nav} -Nav 페이지 상단에 표시되는 내비게이션 바입니다. 사이트 제목, 전역 메뉴 링크 등을 포함하고 있습니다. +네비게이션 바는 페이지 상단에 표시되며, 사이트 제목, 전역 메뉴 링크 등이 포함됩니다. ## 사이트 제목 및 로고 {#site-title-and-logo} -기본적으로 nav는 [`config.title`](./site-config#title) 값이 참조하는 사이트 제목을 표시합니다. nav에 표시되는 내용을 변경하고 싶다면 `themeConfig.siteTitle` 옵션에 사용자 정의 텍스트를 정의할 수 있습니다. +기본적으로 네비게이션 바는 [`config.title`](./site-config#title) 값을 참조하여 사이트 제목을 표시합니다. 여기에 표시되는 내용을 변경하려면 `themeConfig.siteTitle` 옵션에 커스텀 텍스트를 정의합니다. ```js export default { @@ -14,7 +14,7 @@ export default { } ``` -사이트에 로고가 있다면 이미지 경로를 전달하여 표시할 수 있습니다. 로고를 `public` 디렉터리에 위치시키고, 그 절대 경로를 정의해야 합니다. +사이트에 로고가 있는 경우, 이미지의 경로를 전달하여 로고를 표시할 수 있습니다. 로고는 `public` 폴더에 배치하고, 이것의 절대 경로를 정의해야 합니다. ```js export default { @@ -24,7 +24,7 @@ export default { } ``` -로고를 추가하면 사이트 제목과 함께 표시됩니다. 로고만 필요하고 사이트 제목 텍스트를 숨기고 싶다면 `siteTitle` 옵션에 `false`를 설정하세요. +로고를 추가하면 사이트 제목과 함께 표시됩니다. 로고만 필요하고 사이트 제목 텍스트를 숨기고 싶다면, `siteTitle` 옵션을 `false`로 설정하면 됩니다. ```js export default { @@ -35,27 +35,27 @@ export default { } ``` -`alt` 속성을 추가하거나 어두운/밝은 모드에 따라 로고를 커스터마이즈하고 싶다면 객체로써 로고를 전달할 수 있습니다. 자세한 내용은 [`themeConfig.logo`](./default-theme-config#logo)를 참조하세요. +로고에 `alt` 어트리뷰트를 추가하거나 다크/라이트 모드에 따라 커스터마이징 하려면, 로고를 객체 형태로 전달해야 합니다. 자세한 내용은 [`themeConfig.logo`](./default-theme-config#logo)를 참고하세요. -## 내비게이션 링크 {#navigation-links} +## 네비게이션 바 링크 {#navigation-links} -`themeConfig.nav` 옵션을 정의하여 nav에 링크를 추가할 수 있습니다. +`themeConfig.nav` 옵션을 정의하여 네비게이션 바에 링크를 추가할 수 있습니다. ```js export default { themeConfig: { nav: [ { text: '가이드', link: '/guide' }, - { text: '설정', link: '/config' }, + { text: '구성', link: '/config' }, { text: '변경사항', link: 'https://github.com/...' } ] } } ``` -`text`는 nav에 표시되는 실제 텍스트이고, `link`는 텍스트를 클릭할 때 이동할 링크입니다. 링크는 실제 파일의 경로를 `.md` 접두어 없이 설정하고 항상 `/`로 시작해야 합니다. +`text`는 네비게이션 바에 표시되는 실제 텍스트이며, `link`는 텍스트를 클릭했을 때 이동할 링크입니다. 링크의 경로는 `.md` 접미사 없이 실제 파일 경로로 설정하며, 항상 `/`로 시작해야 합니다. -Nav 링크는 드롭다운 메뉴일 수도 있습니다. 이를 위해 링크 옵션에 `items` 키를 설정하세요. +네비게이션 바 링크는 드롭다운 메뉴가 될 수 있습니다. 이를 위해 `link` 옵션에 `items` 키를 설정합니다. ```js export default { @@ -75,9 +75,9 @@ export default { } ``` -드롭다운 메뉴 제목(`위 예제에서의 드롭다운 메뉴`)은 드롭다운 대화상자를 열 버튼이 되므로 `link` 속성을 가질 수 없습니다. +드롭다운 메뉴의 제목(위 예제에서 `드롭다운 메뉴`)은 드롭다운 대화 상자를 여는 버튼이 되므로 `link` 프로퍼티를 가질 수 없습니다. -더 많은 중첩된 항목을 전달하여 드롭다운 메뉴 항목에 "섹션"을 추가할 수도 있습니다. +드롭다운 메뉴 아이템에 더 많은 중첩된 아이템을 전달하여 "섹션"을 추가할 수도 있습니다. ```js export default { @@ -116,14 +116,14 @@ export default { ### 링크의 "active" 상태 커스터마이징 {#customize-link-s-active-state} -현재 페이지가 일치하는 경로에 있을 때 Nav 메뉴 항목이 강조 표시됩니다. 매치되길 원하는 경로를 커스터마이징하고 싶다면 문자열 값으로 `activeMatch` 속성과 정규식을 정의하세요. +네비게이션 바 메뉴 아이템은 현재 페이지가 매칭되는 경로에 있을 때 강조 표시됩니다. 매칭할 경로를 커스터마이징 하려면 `activeMatch` 프로퍼티에 정규식을 문자열 값으로 정의합니다. ```js export default { themeConfig: { nav: [ - // 사용자가 `/config/` 경로에 있을 때 - // 이 링크는 활성 상태가 됩니다. + // `/config/` 경로에 있을 때 + // 이 링크는 활성화된 상태가 됩니다. { text: '가이드', link: '/guide', @@ -135,22 +135,22 @@ export default { ``` ::: warning -`activeMatch`는 정규식 문자열로 예상되지만, 문자열로 정의해야 합니다. 실제 RegExp 객체를 여기서 사용할 수 없는 이유는 빌드 시간 동안 직렬화가 가능하지 않기 때문입니다. +`activeMatch`는 정규식이어야 하지만, 문자열로 정의해야 합니다. 실제 RegExp 객체를 사용할 수 없는 이유는 빌드하는 동안 직렬화할 수 없기 때문입니다. ::: -### 링크의 "target" 및 "rel" 속성 커스터마이즈 {#customize-link-s-target-and-rel-attributes} +### 링크의 "target" 및 "rel" 어트리뷰트 커스터마이징 {#customize-link-s-target-and-rel-attributes} -기본적으로 VitePress는 링크가 외부 링크인지에 따라 `target` 및 `rel` 속성을 자동으로 결정합니다. 하지만 원한다면 이들도 커스터마이징할 수 있습니다. +기본적으로 VitePress는 링크가 외부 링크인지 여부에 따라 `target`과 `rel` 어트리뷰트를 자동으로 결정합니다. 하지만 원한다면 이를 커스터마이징 할 수도 있습니다. ```js export default { themeConfig: { nav: [ { - text: '상품', + text: 'GitHub 쇼핑몰', link: 'https://www.thegithubshop.com/', target: '_self', - rel: 'sponsored' + rel: 'sponsored' // https://developers.google.com/search/docs/crawling-indexing/qualify-outbound-links } ] } @@ -159,11 +159,11 @@ export default { ## 소셜 링크 {#social-links} -[`socialLinks`](./default-theme-config#sociallinks)를 참조하세요. +[`socialLinks`](./default-theme-config#sociallinks)를 참고하세요. -## 사용자 정의 구성 요소 {#custom-components} +## 커스텀 컴포넌트 {#custom-components} -`component` 옵션을 사용하여 탐색 모음에 사용자 정의 구성 요소를 포함할 수 있습니다. `component` 키는 Vue 구성 요소 이름이어야 하며, [Theme.enhanceApp](../guide/custom-theme#theme-interface)을 사용하여 전역으로 등록해야 합니다. +네비게이션 바에 커스텀 컴포넌트를 포함하려면 `component` 옵션을 사용하세요. `component` 키는 Vue 컴포넌트 이름이어야 하며, [Theme.enhanceApp](../guide/custom-theme#theme-interface)을 사용하여 전역적으로 등록해야 합니다. ```js // .vitepress/config.js @@ -175,7 +175,7 @@ export default { items: [ { component: 'MyCustomComponent', - // 구성 요소에 전달할 선택적 props + // 컴포넌트에 전달할 선택적 프로퍼티 props: { title: 'My Custom Component' } @@ -190,7 +190,7 @@ export default { } ``` -그런 다음, 구성 요소를 전역으로 등록해야 합니다: +그런 다음, 컴포넌트를 전역적으로 등록해야 합니다: ```js // .vitepress/theme/index.js @@ -209,8 +209,8 @@ export default { } ``` -구성 요소가 탐색 모음에 렌더링됩니다. VitePress는 구성 요소에 다음과 같은 추가 props를 제공합니다: +컴포넌트는 네비게이션 바에 렌더링될 것입니다. VitePress는 컴포넌트에 다음과 같은 추가 프로퍼티를 제공합니다: -- `screenMenu`: 구성 요소가 모바일 탐색 메뉴 내부에 있는지 여부를 나타내는 선택적 boolean 값 +- `screenMenu`: 컴포넌트가 모바일 네비게이션 바 메뉴 내부에 있는지를 나타내는 선택적 boolean 값 -예제는 [여기](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress)에서 확인할 수 있습니다. +e2e 테스트 예제를 [여기](https://github.com/vuejs/vitepress/tree/main/__tests__/e2e/.vitepress)에서 확인할 수 있습니다. diff --git a/docs/ko/reference/default-theme-sidebar.md b/docs/ko/reference/default-theme-sidebar.md index 311c1a1d..21e19ccc 100644 --- a/docs/ko/reference/default-theme-sidebar.md +++ b/docs/ko/reference/default-theme-sidebar.md @@ -1,6 +1,6 @@ # 사이드바 {#sidebar} -사이드바는 문서의 주요 탐색 블록입니다. 사이드바 메뉴를 [`themeConfig.sidebar`](./default-theme-config#sidebar)에서 설정할 수 있습니다. +사이드바는 문서의 기본 탐색 블록입니다. [`themeConfig.sidebar`](./default-theme-config#sidebar)에서 사이드바 메뉴를 구성할 수 있습니다. ```js export default { @@ -19,9 +19,9 @@ export default { } ``` -## 기초 {#the-basics} +## 기본 사용법 {#the-basics} -사이드바 메뉴의 가장 간단한 형태는 링크의 단일 배열을 전달하는 것입니다. 첫 번째 레벨 아이템은 사이드바의 "섹션"을 정의합니다. 해당 섹션의 제목인 `text`와 실제 탐색 링크인 `items`를 포함해야 합니다. +사이드바 메뉴의 가장 간단한 형태는 링크 배열을 전달하는 것입니다. 첫 번째 계층 아이템은 사이드바의 "섹션"을 정의합니다. 이 섹션에는 제목인 `text`와 실제 탐색 링크인 `items`가 포함되어야 합니다. ```js export default { @@ -48,7 +48,7 @@ export default { } ``` -`link`는 `/`로 시작하는 실제 파일 경로를 지정해야 합니다. 링크 끝에 슬래시를 추가하면 해당 디렉토리의 `index.md`를 보여줍니다. +각 `link`는 `/`로 시작하는 실제 파일 경로를 지정해야 합니다. 링크 끝에 슬래시를 추가하면 해당 디렉터리의 `index.md`를 보여줍니다. ```js export default { @@ -66,20 +66,20 @@ export default { } ``` -루트 레벨부터 시작해서 최대 6레벨 깊이까지 사이드바 아이템을 중첩할 수 있습니다. 6레벨 이상 중첩된 아이템은 무시되며 사이드바에 표시되지 않습니다. +사이드바 아이템을 루트 단계에서 최대 6단계까지 중첩할 수 있습니다. 6단계를 초과하는 중첩 아이템은 무시되며 사이드바에 표시되지 않습니다. ```js export default { themeConfig: { sidebar: [ { - text: '레벨 1', + text: '1단계', items: [ { - text: '레벨 2', + text: '2단계', items: [ { - text: '레벨 3', + text: '3단계', items: [ ... ] @@ -93,11 +93,11 @@ export default { } ``` -## 다중 사이드바 {#multiple-sidebars} +## 여러 사이드바 {#multiple-sidebars} -페이지 경로에 따라 다른 사이드바를 표시할 수 있습니다. 예를 들어, 이 사이트에 표시된 것과 같이 "가이드" 페이지와 "설정" 페이지와 같이 문서의 콘텐츠 섹션을 별도로 생성할 수 있습니다. +페이지 경로에 따라 다른 사이드바를 표시할 수 있습니다. 예를 들어 이 사이트처럼 문서의 각 섹션을 "가이드"와 "레퍼런스" 페이지에 따라 별도로 만들고 싶을 수 있습니다. -이를 위해 먼저 각 원하는 섹션에 대한 디렉토리로 페이지를 구성합니다: +이를 위해 먼저 각 섹션 디렉터리로 페이지를 구성합니다: ``` . @@ -111,32 +111,32 @@ export default { └─ four.md ``` -그다음, 구성을 업데이트하여 각 섹션에 대한 사이드바를 정의합니다. 이때, 배열 대신 객체를 전달해야 합니다. +그런 다음 각 섹션에 대한 사이드바를 정의하도록 구성 파일을 업데이트합니다. 이런 경우에는 배열 대신 객체를 전달해야 합니다. ```js export default { themeConfig: { sidebar: { - // 이 사이드바는 사용자가 + // 이 사이드바는 유저가 // `guide` 디렉토리에 있을 때 표시됩니다. '/guide/': [ { text: '가이드', items: [ - { text: '인덱스', link: '/guide/' }, + { text: '개요', link: '/guide/' }, { text: '하나', link: '/guide/one' }, { text: '둘', link: '/guide/two' } ] } ], - // 이 사이드바는 사용자가 + // 이 사이드바는 유저가 // `config` 디렉토리에 있을 때 표시됩니다. '/config/': [ { text: '설정', items: [ - { text: '인덱스', link: '/config/' }, + { text: '개요', link: '/config/' }, { text: '셋', link: '/config/three' }, { text: '넷', link: '/config/four' } ] @@ -149,7 +149,7 @@ export default { ## 접을 수 있는 사이드바 그룹 {#collapsible-sidebar-groups} -사이드바 그룹에 `collapsed` 옵션을 추가하면 각 섹션을 숨기기/보이기 위한 토글 버튼이 나타납니다. +사이드바 그룹에 `collapsed` 옵션을 추가하면 각 섹션을 접거나 펼칠 수 있는 토글 버튼이 표시됩니다. ```js export default { @@ -165,7 +165,7 @@ export default { } ``` -모든 섹션은 기본적으로 "열림" 상태입니다. 초기 페이지 로드 시 "닫힘" 상태로 하고 싶다면 `collapsed` 옵션을 `true`로 설정하세요. +모든 섹션은 기본적으로 "열림" 상태입니다. 초기 페이지 로드 시 "닫힘" 상태로 두려면 `collapsed` 옵션을 `true`로 설정합니다. ```js export default { @@ -183,7 +183,7 @@ export default { ## `useSidebar` -사이드바 관련 데이터를 반환합니다. 반환된 객체는 다음과 같은 유형을 가집니다: +사이드바 관련 데이터를 반환합니다. 반환된 객체는 다음과 같은 타입을 가집니다: ```ts export interface DocSidebar { diff --git a/docs/ko/reference/frontmatter-config.md b/docs/ko/reference/frontmatter-config.md index 567d828a..b10768a4 100644 --- a/docs/ko/reference/frontmatter-config.md +++ b/docs/ko/reference/frontmatter-config.md @@ -2,20 +2,20 @@ outline: deep --- -# 프론트매터 구성 {#frontmatter-config} +# 전문 구성 {#frontmatter-config} -프론트매터(머리말)는 페이지 기반 구성을 가능하게 합니다. 모든 마크다운 파일에서, 사이트 수준 또는 테마 수준의 구성 옵션을 재정의하기 위해 프론트매터 구성을 사용할 수 있습니다. 또한, 프론트매터에서만 정의할 수 있는 구성 옵션이 있습니다. +전문은 페이지 기반 구성을 가능하게 합니다. 각 마크다운 파일에서 전문 구성을 사용하여 사이트 수준 또는 테마 수준의 구성 옵션을 재정의할 수 있습니다. 또한, 전문에서만 정의할 수 있는 구성 옵션도 있습니다. -사용 예시: +사용 예: ```md --- -title: VitePress로 문서화 +title: Docs with VitePress editLink: true --- ``` -Vue 표현식에서 `$frontmatter` 전역을 통해 프론트매터 데이터에 접근할 수 있습니다: +Vue 표현식에서 `$frontmatter` 전역 변수를 통해 전문 데이터에 접근할 수 있습니다: ```md {{ $frontmatter.title }} @@ -23,9 +23,9 @@ Vue 표현식에서 `$frontmatter` 전역을 통해 프론트매터 데이터에 ## title -- 유형: `string` +- 타입: `string` -페이지의 제목입니다. [config.title](./site-config#title)과 동일하며, 사이트 수준의 구성을 재정의합니다. +페이지의 제목입니다. [config.title](./site-config#title)과 동일하며, 사이트 레벨의 구성을 재정의합니다. ```yaml --- @@ -35,22 +35,22 @@ title: VitePress ## titleTemplate -- 유형: `string | boolean` +- 타입: `string | boolean` -제목의 접미사입니다. [config.titleTemplate](./site-config#titletemplate)와 동일하며, 사이트 수준의 구성을 재정의합니다. +제목의 접미사입니다. [config.titleTemplate](./site-config#titletemplate)와 동일하며, 사이트 레벨의 구성을 재정의합니다. ```yaml --- title: VitePress -titleTemplate: Vite & Vue로 구동되는 정적 사이트 생성기 +titleTemplate: Vite & Vue powered static site generator --- ``` ## description -- 유형: `string` +- 타입: `string` -페이지의 설명입니다. [config.description](./site-config#description)과 동일하며, 사이트 수준의 구성을 재정의합니다. +페이지의 설명입니다. [config.description](./site-config#description)과 동일하며, 사이트 레벨의 구성을 재정의합니다. ```yaml --- @@ -60,19 +60,19 @@ description: VitePress ## head -- 유형: `HeadConfig[]` +- 타입: `HeadConfig[]` -현재 페이지에 삽입할 추가 head 태그를 지정합니다. 사이트 수준 구성에 의해 삽입된 head 태그들 이후에 추가됩니다. +현재 페이지에 삽입할 추가 head 태그를 지정합니다. 사이트 수준 구성에 의해 삽입된 head 태그 뒤에 추가됩니다. ```yaml --- head: - - meta - name: description - content: 안녕하세요 + content: hello - - meta - name: keywords - content: 슈퍼 두퍼 SEO + content: super duper SEO --- ``` @@ -84,18 +84,18 @@ type HeadConfig = ## 기본 테마 전용 {#default-theme-only} -다음 프론트매터 옵션은 기본 테마를 사용할 때만 적용됩니다. +다음 전문 옵션은 기본 테마를 사용할 때만 적용됩니다. ### layout -- 유형: `doc | home | page` +- 타입: `doc | home | page` - 기본값: `doc` 페이지의 레이아웃을 결정합니다. -- `doc` - 마크다운 콘텐츠에 기본 문서 스타일을 적용합니다. -- `home` - "홈 페이지"를 위한 특별한 레이아웃입니다. `hero` 및 `features`와 같은 추가 옵션을 추가하여 아름다운 랜딩 페이지를 빠르게 만들 수 있습니다. -- `page` - `doc`과 비슷하게 동작하지만 콘텐츠에 스타일을 적용하지 않습니다. 완전히 사용자 정의된 페이지를 만들고 싶을 때 유용합니다. +- `doc` - 마크다운 컨텐츠에 기본 문서 스타일을 적용합니다. +- `home` - "홈 페이지"를 위한 특별 레이아웃입니다. 아름다운 랜딩 페이지를 빠르게 만들기 위해 `hero` 및 `features`와 같은 옵션을 추가할 수 있습니다. +- `page` - `doc`과 유사하게 작동하지만 콘텐츠에 스타일을 적용하지 않습니다. 완전히 커스텀 페이지를 만들 때 유용합니다. ```yaml --- @@ -105,18 +105,18 @@ layout: doc ### hero -`layout`이 `home`으로 설정될 때 홈 히어로 섹션의 내용을 정의합니다. [기본 테마: 홈 페이지](./default-theme-home-page)에서 자세한 내용을 확인할 수 있습니다. +`layout`이 `home`으로 설정된 경우, 홈 히어로 섹션의 내용을 정의합니다. 자세한 내용은 [기본 테마: 홈 페이지](./default-theme-home-page)에서 확인할 수 있습니다. ### features -`layout`이 `home`으로 설정될 때 기능 섹션에 표시할 항목을 정의합니다. [기본 테마: 홈 페이지](./default-theme-home-page)에서 자세한 내용을 확인할 수 있습니다. +`layout`이 `home`으로 설정된 경우, 기능 섹션에 표시할 항목을 정의합니다. 자세한 내용은 [기본 테마: 홈 페이지](./default-theme-home-page)에서 확인할 수 있습니다. ### navbar -- 유형: `boolean` +- 타입: `boolean` - 기본값: `true` -[navbar](./default-theme-nav)를 표시할지 여부입니다. +[네비게이션 바](./default-theme-nav)를 표시할지 여부를 설정합니다. ```yaml --- @@ -126,10 +126,10 @@ navbar: false ### sidebar -- 유형: `boolean` +- 타입: `boolean` - 기본값: `true` -[sidebar](./default-theme-sidebar)를 표시할지 여부입니다. +[사이드바](./default-theme-sidebar)를 표시할지 여부를 설정합니다. ```yaml --- @@ -139,14 +139,14 @@ sidebar: false ### aside -- 유형: `boolean | 'left'` +- 타입: `boolean | 'left'` - 기본값: `true` -`doc` 레이아웃에서 aside 컴포넌트의 위치를 정의합니다. +`doc` 레이아웃에서 어사이드(aside) 컴포넌트의 위치를 정의합니다. -이 값을 `false`로 설정하면 aside 컨테이너가 렌더링되지 않습니다.\ -이 값을 `true`로 설정하면 aside가 오른쪽에 렌더링됩니다.\ -이 값을 `'left'`로 설정하면 aside가 왼쪽에 렌더링됩니다. +이 값을 `false`로 설정하면 어사이드 컨테이너가 렌더링되지 않습니다.\ +이 값을 `true`로 설정하면 어사이드를 오른쪽에 렌더링합니다.\ +이 값을 `'left'`로 설정하면 어사이드를 왼쪽에 렌더링합니다. ```yaml --- @@ -156,17 +156,17 @@ aside: false ### outline -- 유형: `number | [number, number] | 'deep' | false` +- 타입: `number | [number, number] | 'deep' | false` - 기본값: `2` -페이지에 표시할 개요의 헤더 레벨입니다. [config.themeConfig.outline.level](./default-theme-config#outline)과 동일하며, 사이트 수준 구성에서 설정한 값을 재정의합니다. +페이지에 표시할 아웃라인(개요) 헤더의 레벨을 설정합니다. [config.themeConfig.outline.level](./default-theme-config#outline)과 동일하며, 사이트 수준 구성에서 설정된 값을 재정의합니다. ### lastUpdated -- 유형: `boolean | Date` +- 타입: `boolean | Date` - 기본값: `true` -현재 페이지의 바닥글에 [마지막 업데이트](./default-theme-last-updated) 텍스트를 표시할지 여부입니다. 날짜와 시간이 지정되면 마지막 git 수정 타임스탬프 대신 표시됩니다. +현재 페이지의 푸터에 [마지막 업데이트 날짜](./default-theme-last-updated) 텍스트를 표시할지 여부를 설정합니다. 날짜/시간이 지정되면 마지막 git 수정 타임스탬프 대신 해당 날짜/시간이 표시됩니다. ```yaml --- @@ -176,10 +176,10 @@ lastUpdated: false ### editLink -- 유형: `boolean` +- 타입: `boolean` - 기본값: `true` -현재 페이지의 바닥글에 [편집 링크](./default-theme-edit-link)를 표시할지 여부입니다. +현재 페이지의 푸터에 [편집 링크](./default-theme-edit-link)를 표시할지 여부를 설정합니다. ```yaml --- @@ -189,10 +189,10 @@ editLink: false ### footer -- 유형: `boolean` +- 타입: `boolean` - 기본값: `true` -[footer](./default-theme-footer)를 표시할지 여부입니다. +[푸터](./default-theme-footer)를 표시할지 여부를 설정합니다. ```yaml --- @@ -202,9 +202,9 @@ footer: false ### pageClass -- 유형: `string` +- 타입: `string` -특정 페이지에 추가 클래스 이름을 추가합니다. +페이지에 추가할 클래스 입니다. ```yaml --- @@ -212,7 +212,7 @@ pageClass: custom-page-class --- ``` -그런 다음 `.vitepress/theme/custom.css` 파일에서 이 특정 페이지의 스타일을 사용자 정의할 수 있습니다: +그런 다음 `.vitepress/theme/custom.css` 파일에서 이 페이지의 스타일을 커스텀 할 수 있습니다: ```css .custom-page-class { diff --git a/docs/ko/reference/runtime-api.md b/docs/ko/reference/runtime-api.md index a653d2d7..a483ea2f 100644 --- a/docs/ko/reference/runtime-api.md +++ b/docs/ko/reference/runtime-api.md @@ -1,35 +1,35 @@ # 런타임 API {#runtime-api} -VitePress는 앱 데이터에 액세스할 수 있도록 몇 가지 내장 API를 제공합니다. 또한 전역적으로 사용할 수 있는 몇 가지 내장 컴포넌트도 제공합니다. +VitePress는 애플리케이션 데이터를 액세스할 수 있는 여러 내장 API를 제공합니다. 그리고 전역적으로 사용할 수 있는 몇 가지 내장 컴포넌트도 제공합니다. -도우미 메서드는 `vitepress`에서 전역적으로 가져올 수 있으며 일반적으로 사용자 지정 테마 Vue 컴포넌트에서 사용됩니다. 그러나 마크다운 파일이 Vue [단일 파일 컴포넌트](https://vuejs.org/guide/scaling-up/sfc.html)로 컴파일되기 때문에 `.md` 페이지 내에서도 사용할 수 있습니다. +헬퍼 메서드는 `vitepress`에서 전역적으로 사용할 수 있으며, 주로 커스텀 테마의 Vue 컴포넌트에서 사용됩니다. 또한 마크다운 파일이 Vue [단일 파일 컴포넌트](https://vuejs.org/guide/scaling-up/sfc.html)로 컴파일되기 때문에 `.md` 페이지 내에서도 사용할 수 있습니다. -`use*`로 시작하는 메서드는 `setup()` 또는 `