Internationalization (I18n)

Transkript

1 Internationalization (I18n)

2 Ziele Begriff "Internationalization" Unterscheidung der anzupassenden Inhalte Einsatz Ruby on Rails Programmieraspekte, um Internationalisierung zu ermöglichen

3 Was muss internationalisiert werden?

4 Typische Übersetzungen in Webapplikationen Texte in Templates Lokalisierte Texte (Zeit, Datum, Währung, Nummernformat) Fehlermeldungen Model Klassen Namen und Felder Namen URLs Bilder, Logos CSS Inhalte von Feldern

5 Quellen der Übersetzungen Texte in Templates: Programmierung Lokalisierte Texte (Zeit, Datum, Währung, Nummernformat): Programmierung Fehlermeldungen: Programmierung Model Klassen Namen und Felder Namen: Programmierung URLs: Programmierung CSS: Programmierung / Grafiker Bilder, Logos: Grafiker Inhalte von Feldern: Datenbank

6 Übersetzungen und REST shop.com/product?locale=de - shop.com/product?locale=en shop.com/de/product - shop.com/en/product your.shop.ch/product - your.shop.com/product de.shop.com/product - en.shop.com/product HTTP Header: Accept-Language: de, en-gb; Nicht! session[:locale] = :de

7 Konfigurationsfile in Ruby Verwendete Lokalisationen und Defaulteinstellung. File muss als UTF-8 gespeichert sein! 1. #encoding: utf-8 2. I18n.default_locale = :en LANGUAGES = [ 5. ["English", 'en'], 6. ["Español", 'es'], 7. [" ", 'ja'] 8. ] Anstelle von UTF-8 kann auch HTMLencoding verwendet werden, aber unübersichtlich: 1. I18n.default_locale = :en LANGUAGES = [ 4. ["English", 'en'], 5. ["Español".html_safe, 'es'], 6. ["日本語".html_safe, 'ja'] 7. ]

8 Umsetzung Routing 1. Depot::Application.routes.draw do scope '(:locale)' do resources :orders 4. resources :line_items 5. resources :carts end 8. end

9 Umsetzung Controller 1. class ApplicationController < ActionController::Base 2. before_action :set_i18n_locale_from_params # def set_i18n_locale_from_params 7. if params[:locale] 8. if I18n.available_locales.map(&:to_s).include?(params[:locale]) 9. I18n.locale = params[:locale] 10. else 11. flash.now[:notice] = 12. "#{params[:locale]} translation not available" 13. logger.error flash.now[:notice] 14. end 15. end 16. end end

10 Übersetzungen im View Layer 1. t('.title') %> 2. <%= t('.home') %> 3. <%= button_to t('.add_html'), line_items_path(product_id: product),...

11 Übersetzungen pflegen /config/locales/en.yml 1. en: 2. store: 3. index: 4. title_html: "Your Catalog" 5. add_html: "Add to Cart" de: 2. store: 3. index: 4. title_html: "Ihr Katalog" 5. add_html: "Zum Warenkorb hinzufügen" 6....

12 Zahlen, Währungen, Datumsformate etc. /config/locales/en.yml 1. date: 2. formats: 3. short_datetime: "%B %d, %Y" 4. normal_datetime: "%m/%d/%y" number: 7. currency: 8. format: 9. unit: "$" 10. precision: separator: "." 12. delimiter: "," 13. format: "%u%n" 1. <%= l Date.today, :format => :short_datetime %>

13 Häufig gebrauchte Übersetzungen und Formatierungen de-ch: date: abbr_day_names: - So - Mo... abbr_month_names: - - Jan - Feb - Mär day_names: - Sonntag - Montag - Dienstag... formats: default:! '%d.%m.%y' long:! '%e. %B %Y' short:! '%e. %b' month_names: - - Januar - Februar - März - April... distance_in_words: about_x_hours: one: etwa eine Stunde other: etwa %{count} Stunden about_x_months: one: etwa ein Monat other: etwa %{count} Monate about_x_years: one: etwa ein Jahr other: etwa %{count} Jahre...

14 Keine algorithmische Stringkonstruktionen! Definition der Texte als ganze, parametrisierte Texte: 1. #Richtig 2. message: "You have ordered %{count} on %{orderdate}" <%= t('.message', count: mycount, orderdate: mydate) %> #Falsch 7. part1: "You have ordered" 8. part2: "items on " <%= t('.part1') + mycount + t('.part2') + mydate %> Verschiedene Textbausteine, um Plural abzufangen

15 Fehlermeldungen /config/locales/de.yml 1. activerecord: 2. errors: 3. messages: 4. inclusion: "ist nicht in der Liste vorhanden" 5. blank: "ist leer" 6. errors: 7. template: 8. body: "Die Einträge in folgenden Feldern sind fehlerhaft:" 9. header: 10. one: "Aufgrund eines Fehlers kann %{model} nicht gespeichert werden" 11. other: "Aufgrund von %{count} Fehlern kann %{model} nicht gespeichert werden" 12.

16 Locale-Switcher 1. <%= form_tag store_path, class: 'locale' do %> 2. <%= select_tag 'set_locale', 3. options_for_select(languages, I18n.locale.to_s), 4. onchange: 'this.form.submit()' %> 5. <%= submit_tag 'submit' %> 6. <%= javascript_tag "$('.locale input').hide()" %> 7. <% end %> def index 2. if params[:set_locale] 3. redirect_to store_url(locale: params[:set_locale]) 4. else = Product.order(:title) 6. end 7. end

17 Übersetzungen von Inhalten Inhalte gespeichert in Datenbank Erst zur Laufzeit bekannt Spezielle Datenbank Designs, z.b Übersetzungstabellen 1. class Post < ActiveRecord::Base 2. translates :title, :text 3. end 1. class CreatePosts < ActiveRecord::Migration 2. def up 3. create_table :posts do t 4. t.timestamps 5. end 6. Post.create_translation_table! :title => :string, :text => :text 7....

18 Konzepte der I18n in Java Internationalisierungs-APIs funktionieren oft ähnlich 1. Locale dech = new Locale("de", "CH") 1. # This is the LabelsBundle_de.properties file 2. s1 = Computer 3. s2 = Platte 4. s3 = Monitor 5. s4 = Tastatur 1. ResourceBundle labels = ResourceBundle.getBundle("LabelsBundle", currentlocale); 2. String value = labels.getstring(key);

19 Ein Beispiel aus der Praxis (JavaScript) Default Fallbacks falls Übersetzungstext nicht verfügbar: 1. Defaultsprache, z.b. Englisch 2. Technischer Name 1. qx.converttolocale = function (txtid, lang, args) { var englishtexts = qx.localizedstrings['en']; 4. var localizedtexts = qx.localizedstrings[lang]; if (localizedtexts === undefined) { 7. localizedtexts = englishtexts; 8. if (localizedtexts === undefined) { return msgid; } var localizedtext = localizedtexts[txtid]; 11. if (localizedtext === undefined ) { 12. localizedtext = englishtexts[txtid]; 13. if (localizedtext === undefined) { 14. localizedtext = txtid; 15. } 16. } if (arguments.length > 2) { 19. var fmt = localizedtext; 20. var fmtarg = Array.prototype.splice.call(arguments, 2); 21. localizedtext = fmt.format(fmtarg); 22. } return localizedtext; };

20 Sprachabhängige Sortierung Alphabetische Sortierung ist nicht gleich ASCII/UTF-Sortierung! Beispiel: Sortierung von schwedischen Ortsnamen: Auf Deutsch: 1. Åkersberga 2. Alingsås 3. Borås 4. Göteborg 5. Örebro 6. Stockholm Auf Schwedisch: 1. Alingsås 2. Borås 3. Göteborg 4. Stockholm 5. Åkersberga 6. Örebro Collator-Klasse in Java, localecompare in JavaScript... Noch extremer in fernöstlichen Sprachen wie Japanisch

21 Aufgepasst bei dynamisch erzeugten Katalogen Ein schlechtes Beispiel, gesehen bei einem grossen internationalen Softwarehersteller...

22 Zusammenfassung I18N bedeutet: Übersetzen aller Texte Anpassen von Formaten für Zahlen, Währungen, Datum etc. Allenfalls auch CSS, Grafiken Alle lokalisierungsspezifischen Angaben in einer Datei pro Locale Einige Punkte sind bei der Programmierung zu beachten Encoding / Multi-Byte-Fähigkeit Stringmanipulation Sprachspezifisches String-Handling