국제화

내장 i18n 기능을 사용하기 위해서는 다음과 같은 디렉토리 구조를 생성해야 합니다:

docs/
├─ es/
│  ├─ foo.md
├─ fr/
│  ├─ foo.md
├─ foo.md

그런 다음 docs/.vitepress/config.ts에서:

import { defineConfig } from 'vitepress'

export default defineConfig({
  // 공유 속성 및 기타 최상위 항목...

  locales: {
    root: {
      label: '영어',
      lang: 'en'
    },
    fr: {
      label: '프랑스어',
      lang: 'fr', // 선택 사항, `html` 태그에 `lang` 속성으로 추가됩니다
      link: '/fr/guide' // 기본적으로 /fr/ -- navbar 변역 메뉴에 표시됩니다, 외부일 수 있습니다

      // 다른 로케일 특정 속성...
    }
  }
})

다음 속성들은 각 로케일(루트 포함)에 대해 덮어쓸 수 있습니다:

interface LocaleSpecificConfig<ThemeConfig = any> {
  lang?: string
  dir?: string
  title?: string
  titleTemplate?: string | boolean
  description?: string
  head?: HeadConfig[] // 기존 헤드 항목과 병합되며, 중복된 메타 태그는 자동으로 제거됩니다
  themeConfig?: ThemeConfig // 얕게 병합됩니다, 공통 항목은 최상위 themeConfig 항목에 넣을 수 있습니다
}

기본 테마의 플레이스홀더 텍스트를 사용자 정의하는 방법은 DefaultTheme.Config 인터페이스를 참조하세요. 로케일 레벨에서 themeConfig.algolia 또는 themeConfig.carbonAds를 덮어쓰지 마세요. 다국어 검색을 사용하는 방법에 대해서는 Algolia 문서를 참조하세요.

전문가 팁: 구성 파일은 docs/.vitepress/config/index.ts에도 저장될 수 있습니다. 로케일별로 구성 파일을 생성한 다음 이를 index.ts에서 병합하여 내보내는 것으로, 내용을 구성하는데 도움이 될 수 있습니다.

각 로케일별 별도의 디렉토리

다음은 완전히 괜찮은 구조입니다:

docs/
├─ en/
│  ├─ foo.md
├─ es/
│  ├─ foo.md
├─ fr/
   ├─ foo.md

그러나, VitePress는 기본적으로 /를 /en/로 리다이렉트하지 않습니다. 이를 위해 서버를 구성해야 합니다. 예를 들어, Netlify에서는 다음과 같이 docs/public/_redirects 파일을 추가할 수 있습니다:

/*  /es/:splat  302  Language=es
/*  /fr/:splat  302  Language=fr
/*  /en/:splat  302

전문가 팁: 위의 접근 방식을 사용한다면, nf_lang 쿠키를 사용하여 사용자의 언어 선택을 유지할 수 있습니다:

// docs/.vitepress/theme/index.ts
import DefaultTheme from 'vitepress/theme'
import Layout from './Layout.vue'

export default {
  extends: DefaultTheme,
  Layout
}

vue

<!-- docs/.vitepress/theme/Layout.vue -->
<script setup lang="ts">
import DefaultTheme from 'vitepress/theme'
import { useData } from 'vitepress'
import { watchEffect } from 'vue'

const { lang } = useData()
watchEffect(() => {
  if (inBrowser) {
    document.cookie = `nf_lang=${lang.value}; expires=Mon, 1 Jan 2030 00:00:00 UTC; path=/`
  }
})
</script>

<template>
  <DefaultTheme.Layout />
</template>

RTL 지원 (실험적)

RTL 지원을 위해, 설정에서 dir: 'rtl'을 지정하고 https://github.com/MohammadYounes/rtlcss, https://github.com/vkalinichev/postcss-rtl, 또는 https://github.com/elchininet/postcss-rtlcss과 같은 RTLCSS PostCSS 플러그인을 사용하세요. CSS 전문성 문제를 방지하기 위해 :where([dir="ltr"]) 및 :where([dir="rtl"])을 접두사로 사용하여 PostCSS 플러그인을 구성해야 합니다.

국제화 ​

각 로케일별 별도의 디렉토리 ​

RTL 지원 (실험적) ​

국제화

각 로케일별 별도의 디렉토리

RTL 지원 (실험적)