Localization done bien

A talk on localization, with my colleague Alejandro Cruz @ Cocoaheads Paris, April 2018

Transcript

1. Localization done bien Trainline × CocoaHeads Paris, April 2018
2. Localisation done bien Trainline × CocoaHeads Paris, April 2018
3. DISCLAIMER This talk will be given in fr_FR and en_MX
5. 14 languages "#$%&'( )*+,-./
6. "#$%&'( )*+,-./ 14 locales
7. [correct] localisation? → Travellers won’t buy domestic tickets if they don’t feel the app is domestic → Conversion rate is higher if localised in customer’s language → Bad localisation is worse than no localisation
8. Localisation Internationalisation Code → Developer Words → Translator
9. Make your app feel so native in any language that people think it has been written in their own language.
10. It is difficult
11. What is a locale? [language] + [formatting conventions] ON A [territory] USING A [codeset] Date Time Numbers Currencies Mexico France Great Britain ES FR NL EN Netherlands UTF-8 Durations UTF-16
12. # 1 en_US Luggage en_GB Baggage Target tourists that probably have never traveled by train Target commuters going to London It’s not a matter of languages…
13. ) 2 nl_NL nl_BE …or of countries alone 2 fr_BE " fr_FR 3 fr_CA 3 en_CA 1 en_US
14. Grammar ru_RU has 4 different forms of plural is_IS has 15 to 20 indefinite articles
15. ahh, formatting too 4 # " jueves, 12 de abril 7:15 PM $ 4602 MXN es_MX en_GB jeudi 12 avril 19h15 204 € fr_FR Thursday 12 April 19:15 £178
16. and let’s not forget about typography ¿Cómo podemos ayudarte? Comment pouvons-nous vous aider ? & "
17. and let’s not forget about typography « Je recommande l’usage de Trainline, surtout pour les entreprises ayant plusieurs centaines de voyages tous les mois. » Tarif : PROMOTION STANDARD " “I definitely recommend using Trainline for Business for all companies that book hundreds of trips per month.” Refund and exchange: PROMOTION STANDARD #
22. ⚙ Verifying configuration... 7 Running with required locales ["zh-Hans", "cs", "es", "nb", "de", "en", "it", "pl", "pt-PT", "nl", "sv", "fr", "pt-BR", "da"] 8 Finding string keys required by scanning app source code and xibs (shelling out)... 7 Fetching latest strings from remote service... 7 : Updating local strings tables... 7 ; No translation issues detected. Complete
23. __attribute__((annotate("returns_localized_nsstring"))) NSString *CATLocalized(NSString *key); NSString *CATLocalized(NSString *key, NSString *defaultText); NSString *CATLocalized(NSString *key, NSInteger count); NSString *CATLocalized(NSString *key, NSDictionary <NSString *, id> *substitutions); NSString *CATUnlocalized(NSString *);
24. CATLocalized(@"ui.ios.session.disconnected") __attribute__((annotate("returns_localized_nsstring"))) NSString *CATLocalized(NSString *key);
25. - (NSString *)nameForCarrier:(NSString *)carrier { NSString *key = [@"data.carrier." stringByAppendingString:self]; return CATLocalized(key.lowercaseString, carrier); } __attribute__((annotate("returns_localized_nsstring"))) NSString *CATLocalized(NSString *key, NSString *defaultText);
26. CATLocalized(@"ui.ios.exchange.passengerWarning", self.passengers.count) "You must select the passenger" "You must select the %{count} passengers" __attribute__((annotate("returns_localized_nsstring"))) NSString *CATLocalized(NSString *key, NSInteger count);
27. CATLocalized(@"ui.ios.profiles.addYouthAge", @{@"age":self.currentProfile.ageDescription}) __attribute__((annotate("returns_localized_nsstring"))) NSString *CATLocalized(NSString *key, NSDictionary <NSString *, id> *substitutions);
28. CATUnlocalized(@"https://192.168.0.1:3000") NSString *CATUnlocalized(NSString *); ⚠ Debug code only
29. >
30. Write code,
 need a new translation Create key on TMS
 with en_GB translation Request translation Run i18n script of project ⚙
31. (also, some stuff isn’t localised)
32. Some stuff isn’t localised and that’s okay
33. What should we take care of?
34. languages right-to-left Out of the box support from iOS 9 up
35. two rules of thumb:
36. first rule: Use leadingAnchor and trailingAnchor instead of leftAnchor and rightAnchor
37. second rule: The locale comes with a defined natural order (RTL or LTR)
38. and an exception… Override the right to left alignment on any specific text view
39. will you flip… or not? ✅ MOST CONTROLS Segmented controls Progress indicators Outline views Video/timeline indicators Images Clocks Music notes Graphs
40. Use more powerful file formats
41. better plurals handling .stringdicts to the rescue C
42. better plurals handling
43. better plurals handling The key to grab the translation on our code
44. better plurals handling
45. better plurals handling The value for the key and placeholder
46. better plurals handling The plural rules applying for the first declared variable
47. D ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓ ❓
48. xliff anyone? D
49. xliff anyone? D XML Localisation Interchange File Format
50. Xcode 9 goodies for localisation
51. property list view for plurals
52. test your localisations with ease
53. localise images
55. Don’t us sentences as localization keys
56. Don’t hardcode string
57. Don’t concatenate strings
58. “Cancel inward of Adrien” ui.ticket.cancel + ticketPart + ui.of + passengerName "Cancel %{part} of %{passenger}" % « Rückfahrt von Adrien stornieren »
59. Don’t assume punctuations
60. Don’t use the same string in multiple places
61. # & Cancelar Cancel es_ES en_GB Anular Cancel action ticket
62. Don’t use reflexion
64. Follow typographic rules
65. Take care of plurals
66. Departing on %{date}, one passenger Departing on %{date}, %{count} passengers
67. Use meaningful token names over position
68. The $1 card ending in $2 expires on $3 The %{type} card ending in %{lastDigit} expires on %{date}
69. Use unicode by default
70. Localise all the things including accessibility, server error messages, etc.
71. Cleanup useless locales
72. Questions? @adhumi & @vidriloco We are hiring an iOS lead