Kompletní lokalizace Nette aplikací – GettextExtractor v2

Ještě než to s chutí vyzkouším, zeptám se: vyžaduje to stále escapování řetězců v šablonác {!_'string'} nebo už mu stačí {_'string'}? Podporuje oboje?

Až se pustím do testování, určitě přijde více otázek :)

A propo, vsechny uváděné Killer features umí sám o sobě xgettext ;-) Takze se v podstatě nejedná o žádné killer…

Ano, to vim, k cemu slouzi. Ale na to je hotovy uz hoooodne davno xgettext, ktery ti prijde co chces a vygeneruje PO soubory. Takze je to k nicemu – myslim GettextExtractor.

Nehlede na to, ze POEdit je dost spatny. 100% lepsi je proste upravit soubor rucne. PO je v podstate textovy soubor a staci jen znat jeho format.

Pěkná práce, určitě vyzkouším.

hurvajs napsal(a):

A propo, vsechny uváděné Killer features umí sám o sobě xgettext ;-) Takze se v podstatě nejedná o žádné killer…

Mohu poprosit o další poučení? Jak na to tedy s xgettextem? Děkuji.

Editoval jasir (22. 10. 2009 15:48)

Karel Klíma napsal(a):
S GettextExtractorem body 1) a 2) odpadají, bod 5) záleží už čistě na implementaci překladového adaptéru.

Odpadaji? Tomu moc nerozumim. Myslel jsem napsat samotnou aplikaci v Nette. Body 1), 2) a 4) jsou proste nutne. Pro POEdit jsou nutne PO soubory, takze se musi bud pouzit xgettext nebo Gettextextractor. Ale vysledek jsou nutne PO soubory. A jak jsem uvedl, mam radeji cista reseni, na gettext existuje velice dobry programek xgettext a umi vse co umi GettextExtractor.

To je pravda. Někomu ale nativní podpora gettextu v PHP nemusí nutně vyhovovat, zvlášť nakládání s plurály je docela podivné. Implementace vlastního adaptéru pro překlad pak vývojáři umožní aplikace/stránky dělat přesně tak, jak potřebuje.

Podotykam, ze u sebe samotneho nevidim duvod, proc bych mel pouzivat nejakou nahradu za gettext. Stejne v kodu pisi _('gettext is perfect'), tak mohu nechat preklad primo na gettextu. Reseni bude na 100% rychlejsi, nemusi se kesovat (uz si to kesuje Apache). Drtiva vetsina hostingu ma gettext zapnuty, takze opravdu nevidim duvod pouzivat neco jineho. Dalsi nespornou vyhodou, je treba v Linuxu se gettext pouziva na lokalizace aplikaci.

Plural ze je spatne? He, to je docela zajima informace. Pouzivam gettext asi tak 6 let a jeste jsem nemel problem, ze bych mel spatne sklonovanou cestinu napriklad.

A zvládne obyčejný smrtelník nakonfigurovat xgettext, aby dělal přesně tohle, za dvacet vteřin? Půvab tohoto řešení spočívá v tom, že je již přesně připravené na práci s Nette a šablonami, resp. LatteFilterem. V tomhle to xgettext trumfne na celé čáře, protože upřímně, komu by se chtělo psát vlastní parser pro xgettext?

Nemusi se nic psat. Implementovano jiz v OS. Takze pokud clovek spusti xgettext s prislusnymi parametry (treba jake typy souboru ma prohledat), tak mu to vyplivne PO. Cele kouzlo. Zalezitost na 1 sek. Pak upravim v text. editoru PO a preklady klicu, pregeneruji do binarnich MO a mam hotovo.

S některými tvrzeními bych byl opatrný. Přece jenom může existovat někdo, kdo nesdílí stejné názory.

S jakymi tvrzenimi? To ze je POEdit na dve veci? Na nic a na smazani. Za tim si stojim… :-D

Samozrejme, chapu ze neco nemusi vyhovovat vsem, kazdy ma jine naroky. Nikomu nic neberu. Jen jsem se ptal, proc se „v uvozovkach“ delaji nektere veci znova, kdyz na to jiz existuji silne nastroje.

Vsak ja to nikomu neberu. Ja pouzivam xgettext, jsem s nim spokojen. Puvodne jsem se ptal, proc p. Klima se psal GettextExtractor kdyz na to uz jsou hotove veci a dobre. Ze v podstate se tim nahrazuje funkcionalita gettextu. Ale to je jedno. nicmene, klobouk dolu, protoze na tom musel nechat nejakou tu hodinu a udelat to.

GettextExtractor a gettext neni preci o F5 v browseru, ale o tom jak vytahnout klice, ktere se pak prekladaji. Alespon tak chapu ja fci GettextExtractoru.

Verim, ze nekomu to opravdu pomuze. Me asi ne. Samozrejme nechavam kazdemu pravo volby, at pouziva co chce.

Ja bych byl treba rad za mnohem obsirnejsi dokumentaci a priklady – neco jako ZF. Taky kazdy z Vas/nas musi uznat, ze Nette dost pokulhava, ikdyz se na tom podle p. Grudla urputne pracuje. Jen to prosim, nikdo neberte spatne nebo navazeni se do Nette ;-)

No právě že F5 v prohlížeči stačí pro vytáhnutí těch klíčů. O to jde.

Píšu si do aplikace texty, skočím do browseru, F5, skočím do PoEditu a překládám, CTRL+S, skočím do browseru F5 a všechno krásně přeloženo.

Myslím, že je to prostě komfort, který se mě osobně líbí! Jen tak dál..

Aha, tak to ok. Ovšem linux nemám :)

hurvajs napsal(a):

Reseni bude na 100% rychlejsi, nemusi se kesovat (uz si to kesuje Apache).

Nevíš jestli se nějak nedá vynutit, aby si Apache .mo soubor nakešoval znovu?

wdolek napsal(a):

vzhledem k tomu, ze jsem s GetTextem nikdy nepracoval, mam trosku problémy pochopit, jak to cele funguje. z prikladu z archivu jsem se toho moc nedozvedel – respektive sem si mohl zacit myslet neco o zahadne magii, kdy tento program nejak precte vsechny skripty, a nejak nahradi (?) / prelozi texty treba v popisku formularovych prvku.

nanestesti to je v ostrem kontrastu s tim malem, co o gettextu vim – tedy ze se pouziva funkce gettext( ) nebo jeji alias _( ). tuto funkci musim uvest vsude, kde chci, aby se texty prekladaly + vyrobit .po soubor, prelozit, umistit na web .mo soubor, a pridat nekam na zacatek inicializaci gettextu…

takze :) odpustte mi muj skromny duvtip (respektive velkolepy neduvtip), ale poradi mi nekdo, co vse musim udelat, kdyz mam nyni web kompletne v cestine (nikde zadne volani _( ) nebo jakesi translate funkce (co je to zac?)) a chci vyrobit anglickou mutaci? (predpokladam, ze musim zeditovat vsechny texty a nacpat je do _( ) – ale jak rikam, z ukazek jsem moc nepobral, jestli to je automatizovane, nebo ne… pak nejakou editaci pomoci Poeditu jeste chapu… a pak zase zpetne namontovani do Nette – to uz mi take neni jasne)

predem diky :)

Pokud aplikace pro překlad není připravená, bude se muset upravit. (Nette)GettextExtractor umí automaticky vytáhnout řetězce pro překlad třeba z formulářů, ale z šablon už ne – tam je třeba každou frázi hodit do makra {_"Něco na překlad"}, respektive {!_"Něco na překlad s escapováním"} (pokud je použit LatteFilter). Z tohoto zápisu si to už umí GettextExtractor vytáhnout. Naproti tomu pokud je v šabloně třeba něco jako <p>Věta v odstavci</p>, pak to ignoruje.

Pro lokalizaci celé aplikace je třeba učinit tyto kroky:

1. Upravit šablony podle vzoru výše, viz filtr Latte
2. Vytvořit soubor podobný souboru Examples/NetteGettextExtractor.php v distribuci. Zde je potřeba akorát správně nastavit, kde všude se má hledat (metoda GettextExtractor::scan()) a kam se to pak má uložit (metoda GettextExtractor::save()). Obě dvě jsou v tomto příkladu k nalezení.
3. Spustit soubor z předchozího bodu (například skrz prohlížeč)
4. Zkopírovat vygenerovaný *.po(t) soubor a přeložit v Poeditu. Kopírování silně doporučuji, protože při každém spuštění GettextExtractoru se vygenerovaný soubor přepíše a zmizí tak veškerá manuálně vytvořená data (překlady).
5. Použít GettextTranslator, který nevyžaduje přímou podporu gettextu, nebo si napsat vlastní Translator, který bude využívat nativní gettextové funkce gettext a ngettext.

vladik napsal(a):

Ahoj Karle myslíš, že by jsi mohl udělat konkrétní příklad buď video nebo podrobný popis? Já s Nette teprve začínám, ale nevím kde uvedenou část kódu vložit …do index.php nebo do šablony @layout.phtml ?

Adresář GettextExtractor jsem nakopíroval do adresáře libs a v adresáři app mám adresář locale. Knihovnu GettextTranslator.php mám v libs/Nette.

Jak dál pokračovat?

Vezmi soubor Examples/NetteGettextExtractor.php a zkopíruj ho do stejný složky jako je index.php (složka public například podle suggested directory structure). Pak soubor uprav a nastav mu správně cesty, tzn. změň ho nějak takhle:

<?php

echo '<pre>';
echo 'NetteGettextExtractor';

require_once dirname(__FILE__) . '/../libs/GettextExtractor/NetteGettextExtractor.php';

$ge = new NetteGettextExtractor();

$ge->setupForms();
$ge->setupDataGrid();

$ge->scan(dirname(__FILE__) . '/../app');

$ge->save(dirname(__FILE__) . '/../app/locale/translation.po');

echo '</pre>';
?>

Snad jsem tam někde neudělal chybu… Dále už stačí jenom zobrazit soubor NetteGettextExtractor.php v prohlížečí a spuštěný skript pak vytvoří soubor translation.po v adrešáři app/locale.

Pro použití GettextTranslator viz jeho dokumentaci.

vrtak-cz napsal(a):

Karel Klíma napsal(a):

4. Zkopírovat vygenerovaný *.po(t) soubor a přeložit v Poeditu. Kopírování silně doporučuji, protože při každém spuštění GettextExtractoru se vygenerovaný soubor přepíše a zmizí tak veškerá manuálně vytvořená data (překlady).

A nešlo by udělat něco jako metodu saveMerge() aneb že by to spojilo prave vygenerovany *.po(t) soubor se souborem ktery už obsahuje nějáké překlady?

Bylo by to proti logice věci. Tohle jsou argumenty, proč to neimplementovat:

1. Podporuje to přímo Poedit. POT soubory jsou jakési šablony, které mají obsahovat pouze nepřeložené fráze, složí jako vzor. Poedit pak umí z těchto souborů udělat update PO souboru, a to tak, že se zachovají pouze fráze, které jsou v POT souboru. Jinými slovy – fráze, které v aplikaci nejsou, se vymažou.
2. Lokalizace většinou počítá s větším množstvím jazyků. Měly by se pak mergovat všechny soubory? Jednoduše řečeno, zdroj a výsledek by měly zůstat odděleny.

vladik napsal(a):

tak jak jsi mi poradil, tak to opravdu zafungovalo. Nicméně byl vytvořen jen jeden soubor translation.po
Proto abych měl více překladů jsem si vytvořil strukturu locale/cs/LC_MESSAGES/messages.po pak locale/en/LC_MESSAGES/mesages.po locale/sk/LC_MESSAGES/messages.po atd.

To jsi udělal správně. Přesně tak to má fungovat.

otázka

1. Když mám vygenerovaný soubor .po z řetězců, které jsou v šabloně česky {!_"Něco na překlad s escapováním"}
tak, v souboru locale/cs/LC_MESSAGES/messages.po bude jak originál tak i překlad česky?

Ano. Nebo to můžeš úplně vynechat. Sice bych osobně doporučil do šablon nepsat diakritiku (i když všechno běží v unicode), ale i takhle se to dá řešit.

2. Když jsem použil {!_"Něco na překlad s escapováním"} tak mi to vyhodilo chybovou hlášku

MemberAccessException
Call to undefined method Template::translate().

Hm… Není nějaký problém s definicí helperu ‚translate‘? Jakým způsobem inicializuješ Translator? Pokud můžeš, používej radši verzi bez vykřičníku, tj. {_"Něco"}.

3. Jakou definici mám použít pro přepínání jazykových verzí?
a tuto definici mám uložit do index.php v adresáři www nebo do šablony @layout.phtml v adresáři Template?

To závisí čistě na tobě. Implementace by měla být každopádně v buď v indexu (respektive bootstrapu) nebo v presenteru. Překladovou logiku bych v šabloně určitě neřešil.

inu, tak jsem si s tim chvilku hral, postupoval podle navodu, ale bez vysledku

1. prepsal sem sablony na volani {_" "}
2. projel sem GettextExtractorem projekt
3. pomoci POEditu prelozil (cs → en)
4. soubor .mo jsem nahral do app/locale/en/LC_MESSAGES/messages.mo
5. pridal do DefaultPresenter do metody beforeRender prirazeni prekladace sablony (ne vsechny presentery potrebuju prekladat – administracni presenter je pouze v cestine, default je v cestine i anglictine)
6. smazal app/temp … ale nic :(

sablona:

<a href="#">{_"Kniha návštěv"}</a>

DefaultPresenter:

protected function beforeRender() {
	// translator
	$translator = new Translator($this->lang, (APP_DIR . '/locale'));
	$this->template->setTranslator($translator);

	...
}

… skutecne $this->lang obsahuje en pro anglictinu, cs pro cestinu

jako transrator jsem si vzal ten co je na http://charlie.cz/…t-extractor/

mimochodem, takto vypada muj translatoidni skript

<?php
echo '<pre>';

require_once dirname(__FILE__) . '/NetteGettextExtractor.php';

$ge = new NetteGettextExtractor();
$ge->setupForms();
$ge->scan(array('../app/models/', '../app/templates/Default/', '../app/templates/@layout.phtml'));
$ge->save('nette.po');

echo '</pre>';

prekvapilo me ale, ze v prekladech sem mel pouze veci ze sablon, nic z formularu (cesty sedi). .po soubor obsahoval pouze veci z @layout.phtml a default.phtml

Ahoj,

rád bych ještě požádal o radu…já když použiji {_"Kniha návštěv"} v šabloně v adresáři template

tak mi to vyhodí chybu

MemberAccessException

Call to undefined method Template::translate().

Line 223:                foreach ($this->helperLoaders as $loader) {
Line 224:                    $helper = call_user_func($loader, $lname);
Line 225:                    if ($helper) {
Line 226:                        $this->registerHelper($lname, $helper);
Line 227:                        return call_user_func_array($helper, $args);
Line 228:                    }
Line 229:                }
Line 230:                return parent::__call($name, $args);
Line 231:            }
Line 232:
Line 233:            return call_user_func_array($this->helpers[$lname], $args);
Line 234:        }
Line 235:
Line 236:
Line 237:

nevím, kde mám co definovat

také nevím jak nadeginovat v hlavičce šablony aby se defaultně použila čeština

a jak volat v odkazu jiné překlady?

<a href="http://www.pokus.cz"><img src="{$baseUri}images/cs.gif" alt="Čeština (Česká republika)" title="Čeština (Česká republika)" /></a>

děkuji za info

Vladik

Editoval vladik (7. 11. 2009 21:36)

Kevas napsal(a):

Ahoj,

je verze php 5.2.2 a vyšší důležitá pro funkčnost? Mám totiž na hostingu verzy 5.2.0–8+etch15.

Děkuji

Nejsem si jistý. Pravděpodobně tam to omezení je kvůli Tokenizeru, ale nedá se vyloučit, že knihovna bude správně pracovat i v nižších verzích PHP.

Nechcete to přidat do extras?

Pouzivam aplikaci s moduly a tato vyjimka se mi vyhodi pri zavolani gettext.php

Cannot load presenter 'Gettext:Php', class 'Gettext_PhpPresenter' was not found in 'www/document_root/../app/GettextModule/presenters/PhpPresenter.php'.

Obsah gettext.php

<?php
define('BASE_DIR', dirname(__FILE__));
define('APP_DIR', BASE_DIR . '/app');

require BASE_DIR . '/libs/GettextExtractor/NetteGettextExtractor.php';

$ge = new NetteGettextExtractor(); // provede základní nastavení pro šablony apod.
$ge->setupForms()->setupDataGrid(); // provede nastavení pro formuláře a DataGrid
$ge->scan(APP_DIR); // prohledá všechny aplikační soubory
$ge->save(APP_DIR . '/locale/front/template.po'); // vytvoří Gettextový soubor editovatelný např v Poeditu
?>

Uz jsem si vytvoril routu a presenter Tools a v nem akci getText() a tedka si volam pouze /tools/gettext/modul a generuje se mi podle toho soubor .po pro admin modul, nebo front modul.

Mám podobný problém a nedaří se mi jej vyřešit: https://forum.nette.org/…i-lokalizace?…

Zdravím, mám takový problém s Translatorem. Všechny texty se v pořádku přeloží, akorát v polích, kde je prázdná EmptyValue se nachází tento text:

Project-Id-Version:
POT-Creation-Date:
PO-Revision-Date:
Last-Translator: Martin Zadražil <zadram1@gmail.com>
Language-Team:
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Nevíte někdo jak se tohoto zbavit? Díky

Ahoj, zkouším toto chytré řešení, ale zápasím s poEditem. Jak ho přinutím, aby mi nabídl zápis 3 plurálů pro řetězec: I see %d little indians!

katalog mám nastavený dle návodu na plurály:

nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4 ? 1 : 2);

přesto mi poedit nabízí ke klíči pouze jeden překlad a nikde se mi nepodařilo vygooglit jak na to.

Předem díky za pomoc

verze poeditu: 1.4.6 (win)

bohužel ani to nepomohlo…

tak po dalším experimentování jsem zjistil, že nakonec byla chyba v .po souboru.

U plurálových forem musí být v .po souboru následující úprava

msgid "I see %d little indians!"
msgid_plural "I see %d little indians!"
msgstr[0] ""
msgstr[1] ""
msgstr[2] ""

to jsem nevěděl a GettextExtractor udělá pouze

msgid "I see %d little indians!"
msgstr "I see %d little indians!"

Domníval jsem se, že plurály poedit nabídne automaticky u řetězců s %d.

Dá se to řešit nějak automatizovaně v GettextExtractoru nebo v poeditu? nebo se musejí plurály ručně doupravit?

jj, už na to koukám, stačilo trochu poupravit a už jede jak po másle. GettextExtractor je vážně kůl tůl :) Díky za něj!