Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
Kdyby/Translation 
@ProchazkaFilip
Co si povíme? 
- Co to je 
- Něco si přeložíme 
- Typické úlohy s Nette 
- Co to neumí
Co je Kdyby/Translation? 
- LocalizationITranslator 
- Symfony/Translation 
Kdyby/Translation je implementací NetteLocaliz...
Jdeme překládat!
Instalace 
$ composer install kdyby/translation 
A do configu s tím! 
extensions: 
translation: KdybyTranslationDITranslat...
Základní nastavení 
translation: 
default: cs 
fallback: [cs_CZ, cs] 
$translator->getDefaultLocale() 
Základní nastavení ...
Odkud se berou překlady 
- slovníky v aplikaci 
- neon 
- po / mo 
- xlf 
- csv 
- ts 
- ... 
Rozšíření umožňuje díky Symf...
Použití
Slovník v neonu 
app/locale/messages.cs_CZ.neon 
"Hello World": Ahoj světe! 
Vytvoříme si slovník ve formátu neon pro češt...
Použití 
$translator->translate( 
'Hello World' 
); // Ahoj světe! 
Jednoduchým voláním pak překládáme.
“Lepší” slovník v neonu 
app/locale/front.cs_CZ.neon 
hello: 
world: Ahoj světe! 
A nebo si vytvoříme lepší slovník, kde n...
Použití s identifikátory 
$translator->translate( 
'front.hello.world' 
); // Ahoj světe! 
Translatoru řekneme že chceme p...
Plurály 
orderForm: 
useCredits: Použít %count% 
kredit|Použít %count% kredity|Použít 
%count% kreditů 
Díky Symfony má tr...
Použití plurálů 
$translator->translate( 
'front.orderForm.useCredits', 
3 
); 
Tady translator sám pozná, že má vybrat dr...
Parametry 
something: Hello %name% 
Samozřejmostí je i podpora pro parametrizované překlady.
Použití parametrů 
$translator->translate( 
'front.something, 
['name' => 'Filip'] 
); 
Druhý argument metody translate() ...
Použití v šablonách 
{_front.orderForm.useCredits} 
{_front.orderForm.useCredits, 3} 
{_}front.hello.world{/_} 
{!_front.h...
Jak nastavím jazyk? 
Kdyby obsahuje plně automatickou detekci jazyka, už žádné Environment::getService(translator) a setLo...
Routování 
abstract class BasePresenter 
{ 
/** @persistent */ 
public $locale; 
První z resolverů vybírá jazyk podle para...
Routování 
new Route( 
'[<locale=cs cs|en>/]<presenter>/<action>', 
"Homepage:default" 
); 
Parametr je potřeba taky defin...
Accept-Language hlavička 
Accept-Language: 
cs,en;q=0.8,en-US;q=0.6 
Pokud translator není schopný si přečíst locale z App...
Jazyk v session 
translation: 
resolvers: 
session: on 
Protože ukládat jazyk stránky do session není zrovna best practise...
Jazyk v session 
abstract class BasePresenter 
{ 
/** 
* @var SessionResolver 
* @inject 
*/ 
public $localeSession; 
Je p...
Jazyk v session 
abstract class BasePresenter 
{ 
public function handleLanguage($locale) 
{ 
$this->localeSession 
->setL...
Jazyk v session 
{link language!, cs} 
{link language!, en} 
Vygenerovat odkaz na signál s jazykem, který se má nastavit, ...
Co ještě jde překládat?
Flash messages 
<div n:foreach='$flashes as $flash' 
n:class='flash, $flash->type'> 
{_$flash->message} 
</div> 
Nejsnadně...
Formuláře 
$form->setTranslator( 
$translator 
); 
Překládat formuláře je také snadné, stačí jim předat translator. Nejlép...
Formuláře 
$form->addText( 
'name', 
'front.registrationForm.name' 
); 
Formulář pak své texty pro label nejprve předá tra...
Formuláře 
$form->setTranslator( 
$translator->domain( 
'front.registrationForm' 
) 
); 
Do formuláře si pomocí metody dom...
Formuláře 
$form->addText( 
'name', 
'name' 
); 
Jak je vidět, použití se drasticky zkrátilo.
Formuláře 
$control->setTranslator(NULL); 
Občas se hodí vypnutí překladů pro jeden konkrétní prvek, to jde udělat snadno ...
Parametry ve formulářích 
$form->addText( 
'name', 
new Phrase( 
'front.registrationForm.name', 
['name' => $name] 
Ve for...
Parametry ve validačních hláškách 
$control->addRule( 
Form::FILLED, 
new Phrase( 
'front.orderForm.useCredits', 
$credits...
Jak získám seznam 
dostupných jazyků?
Whitelisting 
translation: 
whitelist: [cs, en, de] 
$translator->getAvailableLocales() 
Pokud máte univerzální komponenty...
Co extrakce?
Extrakci umí, ale.. 
- latte je implementováno 
- PHP extraktor stále není 
- _() & __() jsou prasárny 
- Kdyby/Console co...
Co to neumí? 
A umět nikdy nebude, protože taková feature je prasárna?
Dotazy?
Díky za pozornost! 
filip-prochazka.com 
Follow me maybe? @ProchazkaFilip
Kdyby/Translation
Upcoming SlideShare
Loading in …5
×

Kdyby/Translation

3,515 views

Published on

Talk about my solution for translations and Nette Framework.
The Kdyby/Translation is an integration of Symfony/Translation into Nette Framework.

Published in: Technology
  • Follow the link, new dating source: ❤❤❤ http://bit.ly/2F90ZZC ❤❤❤
       Reply 
    Are you sure you want to  Yes  No
    Your message goes here
  • Dating for everyone is here: ♥♥♥ http://bit.ly/2F90ZZC ♥♥♥
       Reply 
    Are you sure you want to  Yes  No
    Your message goes here
  • První commit 9.3.2013 :) https://github.com/Kdyby/Translation/commits/master?page=7
       Reply 
    Are you sure you want to  Yes  No
    Your message goes here
  • Tyjo, tohle sem potreboval pred ctvrt rokem :) Anyway diky moc za bezvadnej nastroj i vsechny ostatni veci co delas! :)
       Reply 
    Are you sure you want to  Yes  No
    Your message goes here

Kdyby/Translation

  1. 1. Kdyby/Translation @ProchazkaFilip
  2. 2. Co si povíme? - Co to je - Něco si přeložíme - Typické úlohy s Nette - Co to neumí
  3. 3. Co je Kdyby/Translation? - LocalizationITranslator - Symfony/Translation Kdyby/Translation je implementací NetteLocalizationITranslator pro Nette, využívající Symfony/Translator, díky kterému má podporu pro spoustu super featur.
  4. 4. Jdeme překládat!
  5. 5. Instalace $ composer install kdyby/translation A do configu s tím! extensions: translation: KdybyTranslationDITranslationExtension Instalace je jako vždy primitívní, stačí použít composer a vložit extension do configu.
  6. 6. Základní nastavení translation: default: cs fallback: [cs_CZ, cs] $translator->getDefaultLocale() Základní nastavení jsou také jednoduchá. Je nutné nastavit pouze výchozí jazyk, který pak jde získat metodou getDefaultLocale(). Fallback umožňuje načíst překlady z “náhradního” slovníku - tedy například když není překlady dostupný v němčině a máte nastavený fallback na angličtinu, načte se z anglického slovníku.
  7. 7. Odkud se berou překlady - slovníky v aplikaci - neon - po / mo - xlf - csv - ts - ... Rozšíření umožňuje díky Symfony načítat slovníky v hromadě formátů, z nichž nejzajímavější jsou asi po/mo, díky kterým můžete translator použít jako drop-in replacement vašeho současného gettext translatoru. Kdyby pak přidává ještě navíc podporu pro neon slovníky.
  8. 8. Použití
  9. 9. Slovník v neonu app/locale/messages.cs_CZ.neon "Hello World": Ahoj světe! Vytvoříme si slovník ve formátu neon pro češtinu a do něj vložíme nějaký překlad.
  10. 10. Použití $translator->translate( 'Hello World' ); // Ahoj světe! Jednoduchým voláním pak překládáme.
  11. 11. “Lepší” slovník v neonu app/locale/front.cs_CZ.neon hello: world: Ahoj světe! A nebo si vytvoříme lepší slovník, kde nebudeme mít jako klíče stringy, ale identifikátory, které pak máme unikátní napříč aplikací. Je možné pak mít více slovníků, kde název souboru se bere vždy jako první část identifikátoru, což je v tomto případě slovo front.
  12. 12. Použití s identifikátory $translator->translate( 'front.hello.world' ); // Ahoj světe! Translatoru řekneme že chceme překládat nějaký identifikátor a on nám ho přeloží.
  13. 13. Plurály orderForm: useCredits: Použít %count% kredit|Použít %count% kredity|Použít %count% kreditů Díky Symfony má translator podporu pluralizačních pravidel pro 95 různých jazyku a sám ví, který z výrazů v překladu použít, pokud se mění počet v předmětu daného překladu.
  14. 14. Použití plurálů $translator->translate( 'front.orderForm.useCredits', 3 ); Tady translator sám pozná, že má vybrat druhý výraz a správně vrátí “Použít 3 kredity”.
  15. 15. Parametry something: Hello %name% Samozřejmostí je i podpora pro parametrizované překlady.
  16. 16. Použití parametrů $translator->translate( 'front.something, ['name' => 'Filip'] ); Druhý argument metody translate() je volitelný.
  17. 17. Použití v šablonách {_front.orderForm.useCredits} {_front.orderForm.useCredits, 3} {_}front.hello.world{/_} {!_front.hello.world} Kdyby řeší i překlady v šablonách a přidává vlastní makra. Samozřejmostí je opět podpora plurálů a parametrů. Druhý argument s počtem je opět volitelný.
  18. 18. Jak nastavím jazyk? Kdyby obsahuje plně automatickou detekci jazyka, už žádné Environment::getService(translator) a setLocale() podle parametru v každém BasePresenteru. Při každém requestu se volají resolvery, které samy rozhodnou jaký jazyk použít.
  19. 19. Routování abstract class BasePresenter { /** @persistent */ public $locale; První z resolverů vybírá jazyk podle parametrů AppRequest, který vytváří router. Pokud jej chcete využívat, je potřeba definovat persistentní parametr locale.
  20. 20. Routování new Route( '[<locale=cs cs|en>/]<presenter>/<action>', "Homepage:default" ); Parametr je potřeba taky definovat v routeru na vhodném místě, aby se předával do requestu a translator si ho mohl načíst.
  21. 21. Accept-Language hlavička Accept-Language: cs,en;q=0.8,en-US;q=0.6 Pokud translator není schopný si přečíst locale z AppRequest, tak zkouší zpracovat hlavičku s požadovaným jazykem, kterou posílá prohlížeč. Jazyk vybírá na základě dostupných slovníků s překlady.
  22. 22. Jazyk v session translation: resolvers: session: on Protože ukládat jazyk stránky do session není zrovna best practise, je potřeba toto chování explicitně zapnout.
  23. 23. Jazyk v session abstract class BasePresenter { /** * @var SessionResolver * @inject */ public $localeSession; Je potom možné si do presenteru injectnout třídu SessionResolver, kterou budeme potřebovat abychom do ní mohli nastavit jazyk, když si ho uživatel změní. Třída si ho pamatuje díky uložení do session.
  24. 24. Jazyk v session abstract class BasePresenter { public function handleLanguage($locale) { $this->localeSession ->setLocale($locale); $this->redirect('this'); Jazyk je pak možné měnit například vlastním signálem.
  25. 25. Jazyk v session {link language!, cs} {link language!, en} Vygenerovat odkaz na signál s jazykem, který se má nastavit, je velice snadné.
  26. 26. Co ještě jde překládat?
  27. 27. Flash messages <div n:foreach='$flashes as $flash' n:class='flash, $flash->type'> {_$flash->message} </div> Nejsnadnější způsob jak překládat flash zprávy je použít makro na překlad v šabloně.
  28. 28. Formuláře $form->setTranslator( $translator ); Překládat formuláře je také snadné, stačí jim předat translator. Nejlépe nějak globálně, pomocí DI Containeru.
  29. 29. Formuláře $form->addText( 'name', 'front.registrationForm.name' ); Formulář pak své texty pro label nejprve předá translatoru, než je vykresluje. Samozřejmě je ale lepší vůbec titulek nenastavovat, vykreslovat formulář ručně a tedy mu i předat tento text k překladu až v šabloně.
  30. 30. Formuláře $form->setTranslator( $translator->domain( 'front.registrationForm' ) ); Do formuláře si pomocí metody domain() můžu předat “prefixovaný translator”, což je šikovná zkratka, která vám umožní zbavit se opakování společné části identifikátoru v daném formuláři (nebo komponentě či konkrétní šabloně) a psát jen to co je v něm skutečně unikátní.
  31. 31. Formuláře $form->addText( 'name', 'name' ); Jak je vidět, použití se drasticky zkrátilo.
  32. 32. Formuláře $control->setTranslator(NULL); Občas se hodí vypnutí překladů pro jeden konkrétní prvek, to jde udělat snadno jedním voláním. Je pak ale potřeba ručně přeložit například titulek prvku. Hodí se to když máme například dynamické hodnoty v selectu.
  33. 33. Parametry ve formulářích $form->addText( 'name', new Phrase( 'front.registrationForm.name', ['name' => $name] Ve formulářích není prostor pro nějaké parametrizované překlady nebo plurály, zajímá ho prostě titulek pro label a jak mu ho předáte je mu jedno. Jenže tento titulek vždy předává translatoru. Je tedy možné využít objekt Phrase, který dokáže propašovat parametry i počet až do translatoru, kde se správně očasuje a přeloží.
  34. 34. Parametry ve validačních hláškách $control->addRule( Form::FILLED, new Phrase( 'front.orderForm.useCredits', $credits = 10 ) Stejný fígl funguje i ve validačních pravidlech.
  35. 35. Jak získám seznam dostupných jazyků?
  36. 36. Whitelisting translation: whitelist: [cs, en, de] $translator->getAvailableLocales() Pokud máte univerzální komponenty typu Symfony/Validator, které přidávají překlady pro 25 různých jazyků, tak nechcete, aby translator procházel a zpracovával slovníky pro jazyky které nepoužíváte. Od toho je whitelist, který odfiltruje nepotřebné jazyky. Dostupné jazyky je pak možné získat metodou getAvailableLocales()
  37. 37. Co extrakce?
  38. 38. Extrakci umí, ale.. - latte je implementováno - PHP extraktor stále není - _() & __() jsou prasárny - Kdyby/Console command Kdyby/Translation obsahuje extractor ve formě Kdyby/Console commandu, který umí extrahovat Latte soubory. Neumí ovšem extrahovat přehlady z presenterů, komponent a dalších php souborů. Komunito, zapoj se prosím!
  39. 39. Co to neumí? A umět nikdy nebude, protože taková feature je prasárna?
  40. 40. Dotazy?
  41. 41. Díky za pozornost! filip-prochazka.com Follow me maybe? @ProchazkaFilip

×