플러그인 개요
Jekyll 기반 정적 웹사이트에서 다국어 (i18n) 기능을 구현하려면 별도의 플러그인 도입이 필요합니다. jekyll-multiple-languages-plugin 은 Rails 의 국제화 처리 방식과 유사하게 동작하여, 언어별로 페이지를 컴파일하고 하위 디렉토리에 저장하는 기능을 제공합니다. 이 도구는 번역 문자열 관리, 템플릿 지역화, 그리고 언어별 링크 처리를 주요 기능으로 포함합니다.
설치 절차
Ruby 환경과 Jekyll 이 설정되어 있다는 전제 하에, 다음과 같은 세 가지 방식 중 하나를 선택하여 설치할 수 있습니다.
1. Bundler 를 통한 설치
프로젝트 루트의 Gemfile 에 다음 라인을 추가합니다.
gem 'jekyll-multiple-languages-plugin'
이후 터미널에서 번들링을 실행하여 의존성을 해결합니다.
$ bundle install
설치가 완료되면 _config.yml 파일의 plugins 목록에 해당 플러그인을 등록해야 활성화됩니다.
plugins:
- jekyll-multiple-languages-plugin
2. 수동 설치
플러그인 소스 코드를 다운로드하여 압축을 풀고, Jekyll 프로젝트의 _plugins 디렉토리 안에 플러그인 폴더 전체를 복사합니다. 이 방법은 Gem 관리 없이 직접 소스를 통제할 때 유용합니다.
3. Git Submodule 활용
버전 관리를 위해 Git 을 사용 중이라면 submodule 로 추가하는 것이 효율적입니다. 별도의 디렉토리 이름으로 관리할 수 있습니다.
$ git submodule add https://github.com/kurtsson/jekyll-multiple-languages-plugin.git _plugins/i18n-support
업데이트가 필요할 경우 해당 디렉토리로 이동하여 pull 을 수행합니다.
설정 파일 구성
다국어 기능을 활성화하기 위해 _config.yml 에서 지원할 언어 코드를 정의합니다. 목록의 첫 번째 언어가 기본 언어로 설정되며,其余 언어들은 각각의 하위 폴더에 생성됩니다.
languages:
- ko # 한국어 (기본)
- en # 영어
- ja # 일본어
주요 활용 시나리오
문자열 번역 처리
템플릿 내에서 번역이 필요한 텍스트는 t 필터를 사용하여 키 값으로 호출합니다. 실제 번역 문구는 별도의 YAML 파일에 정의된 키에 매핑됩니다.
<h2>{{ "header_greeting" | t }}</h2>
언어별 파일 포함
특정 언어에 따라 다른 HTML 조각을 포함해야 할 경우, include 태그 경로에 언어 프리픽스를 적용하거나 해당 언어 디렉토리의 파일을 참조합니다.
{% include locales/navigation.html %}
언어 간 페이지 링크
현재 페이지의 다른 언어 버전으로 이동하는 링크는 url_for 필터를 통해 생성합니다. 이를 통해 사용자는 동일한 콘텐츠의 다른 언어 버전을 쉽게 접근할 수 있습니다.
<a href="{{ page.url | url_for: lang='ja' }}">日本語ページ</a>
포스트 및 페이지 메타데이터
새로운 블로그 포스트나 페이지를 작성할 때 Front Matter 에 언어 속성을 명시해야 합니다. 이 속성이 없으면 기본 언어로 간주됩니다.
---
layout: post
title: 기술 블로그 시작하기
lang: ko
---
번역 제외 및 포함 제어
특정 파일이나 디렉토리는 번역 프로세스에서 제외하거나 포함시킬 수 있습니다. 이를 통해 불필요한 번역 작업을 줄일 수 있습니다.
exclude_translation:
- /legal/privacy.html
include_translation:
- /docs/guides/
위 설정은 개인정보 처리방침 페이지는 번역하지 않고, 가이드 문서 디렉토리는 번역 대상으로 포함합니다.
유사 대안 플러그인
비슷한 목적을 가진 다른 도구들도 존재하므로 프로젝트 요구사항에 따라 비교 검토해 볼 수 있습니다.
- Polyglot: 활발히 유지보수되는 다국어 지원 플러그인
- Jekyll Language Plugin: Jekyll 3 이상 버전과 호환되는 도구
- Octopress Multilingual: Octopress 테마에 특화된 현지화 솔루션