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

Sarina Canelake - I18N: World Domination the Ea...

Sarina Canelake - I18N: World Domination the Easy Way

Have you heard about internationalization (i18n) and wondered what it meant? Perhaps your project already has i18n of its strings but you have a nagging feeling you could be doing it better. This talk will walk through the basics of i18n’ing a Django project (but the principles apply to any project!), and how to make the process of localization (l10n) go more smoothly.

https://us.pycon.org/2015/schedule/presentation/403/

PyCon 2015

April 18, 2015
Tweet

More Decks by PyCon 2015

Other Decks in Programming

Transcript

  1. • i18n/l10n basics • Presenting your project in a new

    language • Help your community & leverage crowd-sourced translation work Ready player 1?
  2. 1. Mark strings for i18n 2. Scrape the strings 3.

    Translate the strings 4. Serve the strings RECAP MINIBOSS
  3. msg = _( "Hello {name}!".format(name=user.name) ) .po file has key

    "Hello {name}!" At runtime, what’s looked up in .mo file?
  4. msg = _("Hello {name}!").format( name=user.name ) .po file has key

    "Hello {name}!" AND same key will be looked up in .mo file ☺
  5. • various file types • po segmenting • dümmý längüägé

    generation github.com/edx/i18n-tools Advanced applications
  6. Translators... may not have seen the UX of the rest

    of your application Consider the Translator
  7. Consider the Translator Nothing can stop me now that variables

    have meaning + there’s additional context!
  8. Use .format over %s & %d interpolation Use named, not

    positional, variables ({user} vs {} or {0}) Add # Translators: comments PRO TIP: Basic Rules
  9. # Translators: This message means that the # user could

    not be logged in to the site msg = _( "Failed in authenticating {username}\n" ).format( username=eamap.uname )
  10. PRO TIP: Keep Phrases Together _("That is a ") +

    car.color + _(" car") ↓ En: “That is a blue car” Fr: “C’est une bleue voiture” Sacré Bleu!!!
  11. PRO TIP: Keep Phrases Together _( "That is a {color}

    car" ).format(color=car.color) ↓ En: “That is a blue car” Fr: “C’est une voiture bleue”
  12. PRO TIP: Plurals with ngettext from django.utils.translation import ungettext msg

    = ungettext( "There is {num} file", "There are {num} files", num_files ).format(num=num_files)
  13. PRO TIP: Plurals with ngettext if num_tags >= 2: msg

    = _( "There are {num} retweets!" ).format(num=num_tags)
  14. PRO TIP: Plurals with ngettext if num_tags >= 2: msg

    = _( "There are {num} retweets!" ).format(num=num_tags) Darny darn darn! This breaks on languages with differing plural forms.
  15. PRO TIP: Plurals with ngettext if num_tags >= 2: msg

    = ungettext( "There is {num} retweet!", "There are {num} retweets!", num_tags ).format(num=num_tags)
  16. PRO TIP: Remove HTML from Strings "Confirm <em>{action}</em>?" ↓ _("Confirm

    {action}?").format( action=u"<em>" + action + u"</em>" )
  17. PRO TIP: Remove HTML from Strings "<p class='blah'>Lots of words!</p>"

    ↓ u"<p class='blah'>{text}</p>".format( text=_("Lots of words!") )
  18. PRO TIP: Don’t Leave Order to Chance # Translators: Leave

    asterisk at end! _("Password *") ↓ _("Password") + u" *"
  19. All changes to strings create new entries in .po files

    “login”, “Login”, “Log In” PRO TIP: Try to Keep Strings Constant
  20. Non-Latin characters may be taller, wider Fight for the User

    (Experience) 给你点颜色看看!!!
  21. German, Dutch can have extremely long words like... Die deutsche

    Bevölkerungspyramide Fight for the User (Experience) Verflixt und zugenäht!!!
  22. Be multi-directional with Right to Left (RTL) support فاﺮﺴﯾ ،اردو

    ،עברית ،ﻲﺑﺮﻋ Fight for the User (Experience) !!!ﺮﺗﺎﺳ ﺎﯾ