본문으로 건너뛰기

프레임워크 통합

인기 있는 프레임워크와 champollion을 설정하는 단계별 가이드입니다.

Hugo (TOML / YAML / Markdown)​

프로젝트 구조​

Hugo는 문자열 번역에 i18n/을 사용하고 페이지 콘텐츠에 content/을 사용해요:

my-hugo-site/
├── i18n/
│   ├── en.toml             ← source of truth
│   ├── fr.toml
│   └── ja.toml
├── content/
│   ├── posts/
│   │   ├── hello.md        ← source (English)
│   │   ├── hello.fr.md
│   │   └── hello.ja.md
│   └── about.md
└── .env.local

설정​

npm install --save-dev champollion
champollion.config.json
{
  "version": 3,
  "inputLocale": "en",
  "localesDir": "./i18n",
  "contentDir": "./content",
  "format": "auto",
  "languages": ["fr", "de", "ja", "es", "ko", "zh"]
}
champollion sync           # sync i18n string files + content files
champollion sync --dry     # preview changes without writing

콘텐츠 번역 세부 정보​

Front matter: YAML(---)과 TOML(+++) 구분자를 모두 지원해요. 기본적으로 title, description, summary, subtitle, caption, linkTitle을 번역해요. 다른 모든 필드(date, draft, tags, weight, slug 등)는 그대로 유지돼요. 설정 파일에서 translatableFields으로 사용자 지정할 수 있어요.

블록 보호: 코드 블록, Hugo 단축 코드, 인라인 코드, 원시 HTML은 유니코드 센티넬 플레이스홀더를 사용해 자동으로 보호돼요. 이들은 변경 없이 그대로 전달돼요.

파일명 규칙: Hugo의 파일명 기반 번역 패턴을 따라요:

  • my-post.md → my-post.fr.md
  • my-post.en.md → my-post.fr.md (소스 접미사 제거)

기존 파일 건너뛰기: 기존에 번역된 파일은 절대 덮어쓰지 않아요. 재번역을 강제하려면 대상 파일을 삭제하세요.

복수형​

TOML과 YAML 로케일은 CLDR 복수형을 지원해요:

[items]
one = "{{ .Count }} item"
other = "{{ .Count }} items"

내부적으로는 비교(diffing)를 위해 items.one과 items.other으로 표현된 후, 작성 시 올바른 섹션 형식으로 다시 직렬화돼요.