Upgrade to Pro — share decks privately, control downloads, hide ads and more …

i18n and L10n in TYPO3 Flow

Avatar for Karsten Dambekalns Karsten Dambekalns
October 06, 2012
Programming
0
230

i18n and L10n in TYPO3 Flow

Avatar for Karsten Dambekalns

Karsten Dambekalns

October 06, 2012
Tweet

More Decks by Karsten Dambekalns

See All by Karsten Dambekalns
Updating Neos – Why, When and How - 2024 edition
Avatar for Karsten Dambekalns kdambekalns
0
28
Updating Neos - Why, When and How
Avatar for Karsten Dambekalns kdambekalns
0
42
The Perfect Neos Project Setup
Avatar for Karsten Dambekalns kdambekalns
0
170
Importing & Exporting Nodes with Neos
Avatar for Karsten Dambekalns kdambekalns
0
810
Sawubona! Content Dimensions with Neos
Avatar for Karsten Dambekalns kdambekalns
0
140
Migrating from TYPO3 CMS to TYPO3 Neos
Avatar for Karsten Dambekalns kdambekalns
3
2.1k
Deploying TYPO3 Neos websites using Surf
Avatar for Karsten Dambekalns kdambekalns
0
240
Profiling TYPO3 Flow Applications
Avatar for Karsten Dambekalns kdambekalns
1
270
Using Document Databases with TYPO3 Flow
Avatar for Karsten Dambekalns kdambekalns
0
140

Other Decks in Programming

See All in Programming
バイラテラルアップサンプリング
Avatar for Fadis fadis
3
340
Lambda(Python)の リファクタリングが好きなんです
Avatar for komakichi komakichi
5
260
eBPF超入門「o11yに使える」とは (20250424_eBPF_o11y)
Avatar for Koki Senda thousanda
1
110
状態と共に暮らす：ステートフルへの挑戦
Avatar for ypresto ypresto
3
1.2k
Making TCPSocket.new "Happy"!
Avatar for Misaki Shioi(塩井美咲/しおい) coe401_
1
3.3k
Rubyの!メソッドをちゃんと理解する
Avatar for Yuto Urushima alstrocrack
1
130
生成AIで知るお願いの仕方の難しさ
Avatar for uutan1108 ohmori_yusuke
1
110
大LLM時代にこの先生きのこるには-ITエンジニア編
Avatar for Kuu fumiyakume
8
3.3k
LRパーサーはいいぞ
Avatar for ydah ydah
6
1.2k
Browser and UI #2 HTML/ARIA
Avatar for ken7253 ken7253
2
170
20250429 - CNTUG Meetup #67 / DevOps Taiwan Meetup #69 - Deep Dive into Tetragon: Building Runtime Security and Observability with eBPF
Avatar for ChengHao Yang tico88612
0
170
On-the-fly Suggestions of Rewriting Method Deprecations
Avatar for Masato Ohba ohbarye
3
5k

Featured

See All Featured
Intergalactic Javascript Robots from Outer Space
Avatar for Vicent Martí tanoku
271
27k
Fantastic passwords and where to find them - at NoRuKo
Avatar for Phil Nash philnash
51
3.2k
Evolution of real-time – Irina Nazarova, EuRuKo, 2024
Avatar for Irina Nazarova irinanazarova
8
700
Six Lessons from altMBA
Avatar for Skipper Chong Warson skipperchong
28
3.8k
Learning to Love Humans: Emotional Interface Design
Avatar for Aarron Walter aarron
273
40k
Visualization
Avatar for Eitan Lees eitanlees
146
16k
Bootstrapping a Software Product
Avatar for Garrett Dimon garrettdimon
PRO
307
110k
Designing Experiences People Love
Avatar for Jonathan Moore moore
142
24k
Facilitating Awesome Meetings
Avatar for Lara Hogan lara
54
6.3k
Speed Design
Avatar for Sergey Chernyshev sergeychernyshev
29
930
The Straight Up "How To Draw Better" Workshop
Avatar for Dennis Kardys denniskardys
233
140k
Thoughts on Productivity
Avatar for Jon Yablonski jonyablonski
69
4.6k

Transcript

  1. Inspiring people to share i18n and L10n in TYPO3 Flow

    Karsten Dambekalns

  2. Inspiring people to share co-lead of TYPO3 Neos and Flow

    35 years old lives in Lübeck, Germany 1 wife, 3 sons, 1 espresso machine likes canoeing and climbing Karsten Dambekalns

  3. Inspiring people to share Basics i18n is the process of

    making software localizable L10n means actually • formatting dates, numbers, … • translating text • adjusting other things (images, …)

  4. Inspiring people to share Locale Locale instances encapsulate a locale

    identifier Locales define the language and formats to use Locales form a hierarchy • en is a parent of en_US which is a parent of en_US_POSIX • Thus items for the en_US locale that do not exist, will be used from the en locale if available

  5. Inspiring people to share What you need A way to

    translate in templates A way to store translations of labels Formatters for dates, numbers, … An API for use in PHP

  6. Inspiring people to share f:translate the way of translating you

    will use most <f:translate id="my.label.1"/> {f:translate(id: 'my.label.1')} translation by label is possible, but discouraged • less reliable than id-based translation • prohibits changes to the original label

  7. Inspiring people to share f:translate <f:translate id="my.label.1" source="Registration" package="Acme.Demo"/> <f:translate

    id="my.label.1" arguments="{0: 'hi'}" quantity="2"/>

  8. Inspiring people to share f:form.select has translation support built in

    <f:form.select options="{paymentOptions}" translate="{by: 'id'}" /> <f:form.select options="{paymentOptions}" translate="{by: 'id', prefix: 'payment.options.', package: 'Acme.Demo.Translations'}" />

  9. Inspiring people to share Message catalogs XML Localisation Interchange File

    Format is the standard we use Looked up in well-known location Resources/ Private/ Translations/ <locale>/ <source>.xlf

  10. Inspiring people to share XLIFF basics An XLIFF file can

    hold translations for one locale It contains one or more <file> elements corresponding to a source Localizable data is stored in <trans-unit> elements which contain a <source> element to store the source text and a (non-mandatory) <target> element to store the translated text

  11. Inspiring people to share Text Text <?xml version="1.0" encoding="UTF-8"?> <xliff

    version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2"> <file original="" product-name="Acme.Demo" source- language="en" datatype="plaintext"> <body> <trans-unit id="my.label.1" xml:space="preserve"> <source>My Label 1</source> </trans-unit> </body> </file> </xliff>

  12. Inspiring people to share <?xml version="1.0" encoding="UTF-8"?> <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">

    <file original="" product-name="Acme.Demo" source- language="en" datatype="plaintext"> <body> <trans-unit id="my.label.1" xml:space="preserve"> <source>My Label 1</source> <target>Mein Aufkleber 1</target> </trans-unit> </body> </file> </xliff>

  13. Inspiring people to share i18n configuration Default locale can be

    set in Settings.yaml Locale fallback rules are configurable TYPO3: Flow: i18n: defaultLocale: de fallbackRule: strict: FALSE order: [lv, en]

  14. Inspiring people to share i18n configuration Default locale can be

    set in Settings.yaml Locale fallback rules are configurable TYPO3: Flow: i18n: defaultLocale: de fallbackRule: strict: FALSE order: [lv, en]

  15. Inspiring people to share Placeholder use $this->view->assign('foo', 'QUUX'); $this->view->assign('bar', 'BAZ');

    <trans-unit id="my.label.3" xml:space="preserve"> <source>I have {0} and {1}</source> <target>{1} habe ich und {0} habe ich auch</target> </trans-unit> <f:translate id="my.label.3" arguments="{0: foo, 1: bar}"/>

  16. Inspiring people to share String placeholders $this->view->assign('foo', 'QUUX'); $this->view->assign('bar', 'BAZ');

    <trans-unit id="my.label.3" xml:space="preserve"> <source>I have {some} and {thing}</source> <target>{thing} habe ich und {some} habe ich auch</target> </trans-unit> <f:translate id="my.label.3" arguments="{'some': foo, 'thing': bar}"/> * will be available with Flow 2.0

  17. Inspiring people to share Using formatters $this->view->assign('currentDateAndTime', new \DateTime()); $this->view->assign('currentCost',

    1.25); <source> At {0,datetime} it costs {1,number} monetary units </source> <f:translate id="my.label.4" arguments="{ 0: currentDateAndTime, 1: currentCost }"/>

  18. Inspiring people to share Plural forms The CLDR defines six

    plural forms • zero, one, two, few, many, other Different languages use more or less forms • singular and plurals for English • one, few and other for Polish • only other for Japanese

  19. Inspiring people to share <group id="my.label.6" restype="x-gettext-plurals"> <trans-unit id="my.label.6[0]" xml:space="preserve">

    <source>There is this quark</source> </trans-unit> <trans-unit id="my.label.6[1]" xml:space="preserve"> <source>There are these quarks</source> </trans-unit> </group> Plural forms <f:translate id="my.label.6" quantity="{quarks->f:count()}"/>

  20. Inspiring people to share L10n of resources Resources can be

    localized as well The locale is part of the name • Image.png • Image.de.png • Image.lv.png Usable for all resources • Images, templates, …

  21. Inspiring people to share f:resource * see Known issues <img

    src="{f:uri.resource(path: 'Images/Image.png')}"/> <img src="../../../../Resources/Public/Images/Image.png"/> uses localized resources by default*

  22. Inspiring people to share i18n in PHP code TYPO3\Flow\I18n\Translator •

    translateById() • translateByOriginalLabel() TYPO3\Flow\I18n\Service • getConfiguration() • getLocalizedFilename() TYPO3\Flow\I18n\Formatter\*

  23. Inspiring people to share /** * @param string $locale *

    @return void */ public function selectAction($locale = NULL) { if ($locale !== NULL) { $this->i18nService->getConfiguration()->setCurrentLocale( new \TYPO3\Flow\I18n\Locale($locale) ); } $this->forward('index'); } Setting current locale WARNING: Stupid example

  24. Inspiring people to share Tips & Tricks Split catalogs at

    logical points Try to use.a.clever.id.system Avoid hardcoded labels from the start To change "original" labels simply translate to "original" language

  25. Inspiring people to share Known issues L10n support in f:resource

    VH pending in review Fallback per label is missing, currently only done per catalog Overriding parts of catalogs is missing Model translation still missing

  26. Inspiring people to share Thank You! These slides can be

    found at: http://speakerdeck.com/kdambekalns http://slideshare.net/kfish Give me feedback: [email protected] | [email protected] Download Flow: http://flow.typo3.org Follow me on twitter: @kdambekalns Support me using
  27. None