WordPress 테마 번역 파일 만들기 완벽 가이드

1. 워드프레스 테마 번역 준비 작업

텍스트 도메인 지정

먼저, 테마의 `functions.php` 파일에 텍스트 도메인을 정의해야 합니다. 이는 번역 파일을 로드하는 데 필요한 설정입니다.

function my_theme_setup() {
    load_theme_textdomain('my-theme', get_template_directory() . '/languages');
}
add_action('after_setup_theme', 'my_theme_setup');

텍스트 도메인 사용

번역할 텍스트는 번역 함수로 감싸고, 지정한 텍스트 도메인을 사용합니다.

<?php
echo __('Hello, World!', 'my-theme'); // 단일 문자열 번역
_e('Welcome to my site!', 'my-theme'); // 바로 출력하는 번역
?>

2. Poedit를 사용하여 번역 파일 생성

Poedit 설치 및 번역 파일 시작

• Poedit 설치: [Poedit](https://poedit.net/)을 다운로드하여 설치합니다.
• 새 번역 파일 생성: Poedit를 실행하고 ‘새 번역’을 클릭합니다. 원하는 언어를 선택합니다(예: 한국어 `ko`).
• 문자열 추출: ‘카탈로그 > 새로 고침’을 클릭하여 테마 파일에서 번역 가능한 모든 문자열을 자동으로 추출합니다.
• 번역 입력: 추출된 각 문자열을 번역하여 입력합니다.
• .po 및 .mo 파일 저장: Poedit는 `.po` 파일과 `.mo` 파일을 생성합니다. 파일 이름은 `텍스트도메인-언어코드_국가코드` 형식을 따릅니다. 예를 들어, `my-theme-ko_KR.po` 및 `my-theme-ko_KR.mo` 파일이 생성됩니다.
• 파일 저장 위치: 생성된 파일을 테마의 `languages` 폴더에 저장합니다.

3. gettext 명령어로 번역 파일 생성

Poedit 대신 터미널을 사용하여 번역 파일을 생성할 수도 있습니다.

gettext 도구 설치 및 번역 템플릿 파일 생성

sudo apt-get install gettext
xgettext --language=PHP --keyword=__ --keyword=_e --output=my-theme.pot path/to/theme/**/*.php

.po 파일을 기반으로 .mo 파일 생성

msgfmt my-theme-ko_KR.po -o my-theme-ko_KR.mo

4. 번역 파일 구조

번역 파일을 저장할 `languages` 폴더 구조는 다음과 같습니다:

my-theme/
│
├── languages/
│   ├── my-theme-ko_KR.po
│   └── my-theme-ko_KR.mo
├── functions.php
...

5. 번역 파일 로드 확인

올바르게 번역 파일이 로드되었는지 확인하기 위해 `functions.php` 파일에 다음 코드를 추가합니다:

add_action('after_setup_theme', function() {
    load_theme_textdomain('my-theme', get_template_directory() . '/languages');
});

요약

• 테마의 `languages` 폴더에 번역 파일을 저장합니다.
• `functions.php` 파일에서 `load_theme_textdomain`을 사용해 번역 파일을 로드합니다.
• Poedit나 `gettext` 도구를 사용해 .po와 .mo 파일을 만듭니다.

이 과정을 따르면 WordPress 테마를 다국어 지원으로 번역할 수 있습니다. 이 가이드를 통해 글로벌 사용자에게 더 나은 경험을 제공할 수 있을 것입니다.

부록

`get_stylesheet_uri()` 기본 경로 이해하기

`get_stylesheet_uri()` 함수는 현재 활성화된 테마의 `style.css` 파일의 URI를 반환합니다. 기본 경로는 워드프레스 설치 디렉토리의 `wp-content/themes/[활성화된 테마 폴더]`입니다. 예를 들어, 다음과 같은 코드를 사용하여 테마의 `style.css` URI를 가져올 수 있습니다:

<?php
$stylesheet_uri = get_stylesheet_uri();
echo $stylesheet_uri; // 예시 출력: http://example.com/wp-content/themes/your-theme/style.css
?>

이 함수는 내부적으로 `get_stylesheet_directory_uri()` 함수를 사용하여 현재 테마 디렉토리의 URI에 `’/style.css’`를 추가하여 반환합니다.

이처럼 WordPress 테마 번역 파일을 만들고 기본 경로를 이해하는 것은 다국어 지원 사이트를 구축하는 데 중요한 첫걸음입니다. 이 가이드를 통해 번역 작업을 효율적으로 수행할 수 있습니다.