gettext: рецепт жаркое из антилопы в Javascript / Хабр

При разработке CMF я столкнулся с необходимостью грамотно реализовать i18n (мультиязычность), и стал рассматривать различные варианты…

Сначала, исходя из прошлого опыта, я хотел сделать «языковые константы» и мытарствах с хаками для числительных. Но потом к счастью остановил свой выбор на GNU gettext, на мощном и популярном (в Unix-среде) инструменте. Вскоре я понял что нет смысла излишне нагружать сервер переводами фраз, которые не индексируются поисковиками, и что в ряде случаев лучше переводить на клиенте. Однако, необходима была унифицированная система, позволяющая делать переводы в едином формате.
Прогуглив gettext javascript, я увидел несколько реализаций.

Первой попалась — code.google.com/p/gettext-js
Плюс в том что она не требует дополнительной переконвертации исходного po-файла, минус — нету ngettext.

Потом я нашел plugins.jquery.com/project/gettext
Её я и решил использовать. Однако, для работы плагина требуется подготовка специального JSON-файла из MO-файла.

Для конвертации приводится функция на Python:

import simplejson as enc
import gettext
def gettext_json(domain, path, lang = [], indent = False):
    try:
        tr = gettext.translation(domain, path, lang)
        # for unknown reasons, instead of having plural entries like 
        # key: [sg, pl1...]
        # tr._catalog has (key, n): pln, 
        keys = tr._catalog.keys()
        keys.sort()
        ret = {}
        for k in keys:
            v = tr._catalog[k]
            if type(k) is tuple:
                if k[0] not in ret:
                    ret[k[0]] = []
                ret[k[0]].append(v)
            else:
                ret[k] = v
        return enc.dumps(ret, ensure_ascii = False, indent = indent)
    except IOError:
        return None

Пришлось потратить… дцать минут на гуглеж и изучение доки, чтоб поправить код и заставить работать. В результате родил нормальную Unix-программу.

gettext2json

#!/usr/bin/python

import sys
import simplejson as enc
import gettext
    
def gettext_json(domain, path, lang = [], indent = False):
    try:
        tr = gettext.translation(domain, path, lang)
        # for unknown reasons, instead of having plural entries like 
        # key: [sg, pl1...]
        # tr._catalog has (key, n): pln, 
        keys = tr._catalog.keys()
        keys.sort()
        ret = {}
        for k in keys:
            v = tr._catalog[k]
            if type(k) is tuple:
                if k[0] not in ret:
                    ret[k[0]] = []
                ret[k[0]].append(v)
            else:
                ret[k] = v
        return enc.dumps(ret, ensure_ascii = True, indent = indent)
    except IOError as (errno, strerror):
			print "I/O error({0}): {1}".format(errno, strerror)	
        
print gettext_json(sys.argv[1],sys.argv[2],[sys.argv[3]], True)

Также, решил автоматизировать процесс создания бинарных MO-файлов из текстовых PO-файлов:

BuildLocales:

#!/usr/bin/php -q
<?php
chdir(__DIR__);
$lcPath = './locale';
$jsPath = './static/locale';

foreach (glob($lcPath.'/*/LC_MESSAGES/*.po') as $poFile) {
	
	$locale = pathinfo(dirname(dirname($poFile)), PATHINFO_FILENAME);
	$domain = pathinfo($poFile, PATHINFO_FILENAME);
	
	$moFile = dirname($poFile).'/'.$domain.'.mo';
	$jsFile = $jsPath.'/'.$locale.'/'.$domain.'.json';
	shell_exec('mkdir -p '.escapeshellarg($jsPath.'/'.$locale));
	shell_exec('msgfmt -o '.escapeshellarg($moFile).' '.escapeshellarg($poFile));
	$cmd = 'gettext2json '.escapeshellarg($domain).' '.escapeshellarg($lcPath ).' '.escapeshellarg($locale).' > '.escapeshellarg($jsFile);
	shell_exec($cmd);
}

Таким образом, для подготовки всех файлов достаточно лишь создать/изменить текстовый .po файлы в папке locale и запустить скрипт BuildLocales.

Для подключения gettext к Javascript необходимо указать атрибут lang у тега html, добавить в head элемент link с путем до json-файла и подгрузить jquery.gettext.js.

Начало HTML-кода страницы будет выглядеть примерно так:

<!DOCTYPE html> 
<html lang="ru"> 
...
<link href="/locale/ru/mydomain.json" lang="ru" rel="gettext"/>
<script type="text/javascript" src="/js/jquery.gettext.js" />
...

Затем можно вызывать функцию _(«Hello world!») и наслаждаться. Упс! Не работает!

Придется кое-что поправить в jquery.gettext.js, накладываем patch:

63,66c63,70
<                                     try {
<                                       var messages = eval('(' + data + ')');
<                                     } catch(e) {
<                                       return;
---
>                                     if (typeof(data) == 'object') {
>                                       var messages = data;
>                                     } else {
>                                       try {
>                                               var messages = eval('(' + data + ')');
>                                       } catch(e) {
>                                               return;
>                                       }

Те кому лень накладывать патч берут jquery.gettext.js.

Надеюсь жаркое вам понравилось, спасибо за внимание.

gettext: рецепт жаркое из антилопы в Javascript

Публикации

Ближайшие события