본문으로 건너뛰기

지역 타겟팅 & 국제화

Docusaurus는 지리적 타겟팅과 다국어 콘텐츠를 기본 지원합니다. 이 가이드는 Yundera 문서 사이트에서 이러한 기능이 어떻게 작동하는지 설명합니다.

지리 메타 태그​

사이트에는 검색 엔진이 지리적 관련성을 이해하도록 돕는 지리 메타 태그가 포함됩니다:

<meta name="geo.region" content="FR">
<meta name="geo.placename" content="France">

docusaurus.config.js의 themeConfig.metadata에서 설정됩니다.

지역 커스터마이즈​

다른 지역을 타겟팅하려면 config의 값을 업데이트합니다:

metadata: [
  { name: 'geo.region', content: 'US' },      // ISO 3166-1 국가 코드
  { name: 'geo.placename', content: 'United States' },
],

일반적인 지역 코드: FR (프랑스), US (미국), DE (독일), KR (한국), JP (일본).

다국어 지원 (i18n)​

Docusaurus는 i18n을 기본 지원합니다. 현재 설정은 영어만 사용:

i18n: {
  defaultLocale: 'en',
  locales: ['en'],
},

새 언어 추가​

  1. 새 로케일을 포함하도록 config 업데이트:
i18n: {
  defaultLocale: 'en',
  locales: ['en', 'fr', 'ko'],
  localeConfigs: {
    en: { label: 'English', htmlLang: 'en-US' },
    fr: { label: 'Français', htmlLang: 'fr-FR' },
    ko: { label: '한국어', htmlLang: 'ko-KR' },
  },
},
  1. Docusaurus CLI로 번역 파일 생성:
npx docusaurus write-translations --locale fr
  1. 로케일별 복사본을 만들어 문서 번역:
i18n/
  fr/
    docusaurus-plugin-content-docs/
      current/
        intro.md
        getting-started/
          ...
  1. 다국어 사이트 빌드:
npm run build

Docusaurus가 자동 생성:

  • 네비게이션 바의 언어 선택기
  • SEO를 위한 hreflang 태그
  • 로케일별 별도 사이트맵
  • 로케일별 URL (/fr/docs/, /ko/docs/)

SEO에 도움되는 이유​

  • hreflang 태그가 Google에게 각 지역에서 어떤 언어 버전을 보여줄지 알려줌
  • 지리 메타 태그가 주요 지리적 대상을 신호
  • 로케일별 사이트맵이 모든 언어 버전의 색인을 보장
  • content-language 메타 태그가 크롤러에게 페이지 언어를 선언

Yundera App Store 번역​

App Store 자체도 docker-compose.yml에서 앱 설명 번역을 지원합니다:

x-casaos:
  description:
    en_us: English description
    fr_fr: Description en français
    ko_kr: 한국어 설명

Docusaurus i18n과는 별도이지만 동일한 원칙을 따릅니다.

참조​