Page MenuHomePhabricator

Make translations more modular so third-party libraries can translate their strings
ClosedPublic

Authored by epriestley on Feb 11 2015, 8:00 PM.
Tags
None
Referenced Files
F15488714: D11745.id28320.diff
Fri, Apr 11, 1:56 AM
F15480214: D11745.id.diff
Tue, Apr 8, 12:44 PM
F15478126: D11745.diff
Mon, Apr 7, 8:42 PM
F15458563: D11745.diff
Mon, Mar 31, 4:47 AM
F15379927: D11745.id28311.diff
Mar 14 2025, 12:24 AM
F15379369: D11745.id.diff
Mar 13 2025, 8:33 PM
Unknown Object (File)
Feb 9 2025, 6:03 PM
Unknown Object (File)
Feb 8 2025, 2:32 AM
Subscribers

Details

Summary

Ref T7152. Ref T1139. This is a little far afield, but I need to translate some "%s thing(s)" strings into English in Instances to complete the invite workflow.

This isn't currently possible because translations are not modular enough: a library can not translate only its own strings.

To fix this:

  • Define PhutilLocale, which provides a target translation language, like "English (US)".
  • Provide PhutilTranslation, which provides some strings in a target language. Libraries can subclass PhutilTranslation to supplement strings.
  • Rework PhutilTranslator to be aware of locales.
  • I also formalized test translations, silly translations, and de-hacked up the "ALL CAPS" translation. The sex/plural rules are still hard-coded for now.
Test Plan

See next two diffs.

Diff Detail

Repository
rPHU libphutil
Branch
xlation1
Lint
Lint Passed
SeverityLocationCodeMessage
Advicesrc/internationalization/PhutilTranslator.php:129XHP16TODO Comment
Unit
Tests Passed
Build Status
Buildable 4462
Build 4476: [Placeholder Plan] Wait for 30 Seconds

Event Timeline

epriestley retitled this revision from to Make translations more modular so third-party libraries can translate their strings.
epriestley updated this object.
epriestley edited the test plan for this revision. (Show Details)
epriestley added a reviewer: btrahan.
btrahan edited edge metadata.
This revision is now accepted and ready to land.Feb 11 2015, 8:28 PM
This revision was automatically updated to reflect the committed changes.