118
edits
Bugzilla:L10n:Maketext: Difference between revisions
Major rewrite
(Work breakdown first version) |
(Major rewrite) |
||
| Line 1: | Line 1: | ||
The idea was introduced by mkanat ({{Bug|407752}}). If implemented, will greatly reduce localizers' workload | The idea was introduced by mkanat ({{Bug|407752}}). If implemented, will greatly reduce localizers' workload. | ||
== Design considerations == | == Design considerations == | ||
| Line 8: | Line 8: | ||
* Lexicon format | * Lexicon format | ||
* Directory structure | * Directory structure | ||
=== Perl syntax === | === Perl syntax === | ||
| Line 40: | Line 37: | ||
In fact, <tt>l</tt> and <tt>loc</tt>, <tt>|</tt> and <tt>FILTER</tt> are synonyms. | In fact, <tt>l</tt> and <tt>loc</tt>, <tt>|</tt> and <tt>FILTER</tt> are synonyms. | ||
In Bugzilla templates we will be using | |||
<nowiki>[% |l %]</nowiki> | |||
Large boilerplate text, no lines changed, filter added as separate lines. | |||
<nowiki>[% END %]</nowiki> | |||
<nowiki>[% l("Short text",arg1,arg2) %]</nowiki> | |||
See also [[#Default template look and feel]] below | |||
=== Lexicon format === | === Lexicon format === | ||
Available formats also vary: | Available formats also vary: | ||
* simple '''.pm''' modules with explicit <tt>%Lexicon</tt> entries | * simple '''.pm''' modules with explicit <tt>%Lexicon</tt> entries | ||
| Line 61: | Line 66: | ||
; <tt>po/<i>LANG</i>.po</tt> or <tt>locale/<i>LANG</i>.po</tt>: Why not create a separate dir? | ; <tt>po/<i>LANG</i>.po</tt> or <tt>locale/<i>LANG</i>.po</tt>: Why not create a separate dir? | ||
Another question is: how many '''.po''' files we need for a single instance? Is single file enough or do we split ''web'', ''command line'' and ''email'' domains? | |||
== Features == | |||
=== Terms retirement === | === Terms retirement === | ||
| Line 86: | Line 95: | ||
This way <tt>global/variables.none.tmpl</tt> would be used only during '''checksetup.pl''', to compile '''.po''' files | This way <tt>global/variables.none.tmpl</tt> would be used only during '''checksetup.pl''', to compile '''.po''' files | ||
=== Backwards compatibility === | |||
Maketext support by itself does nothing to change templates. All existing templates, custom or default, English or localized, would still work. Template search path logic is not changed either: translated <tt>template/''LANG''/default</tt> would take precedence over maketext-converted <tt>template/en/default</tt> and <tt>''LANG''.po</tt> file. | |||
=== Language negotiation === | |||
Best language is not so easy to glark anymore: suppose we have | |||
# <tt>template/en/custom</tt> -- custom set, refit with maketext | |||
# <tt>template/ru/custom</tt> -- old translated set | |||
# <tt>en.po</tt> -- English messages for <tt>template/en/custom</tt> | |||
# <tt>fr.po</tt> -- French messages | |||
# <tt>ja.po</tt> -- Japanese messages | |||
and then we get a request for '''ja, ru, fr''' language preference. With current logic, it would serve Russian instead of Japanese. | |||
=== Default templates refit === | |||
After English lexicon shakedown localizers may start the bulk of translation work. However, nearly all required texts already exist somewhere in templates. How do we automate this? | |||
Message catalog with its ''msgid/msgtxt'' pairs is very similar to unified diff between <tt>template/en</tt> and <tt>template/''LANG''</tt> trees. One can merge both, based on line numbers of English templates, and copy other (''LANG'') side of a diff into ''msgtxt''. | |||
Is it practical? | |||
== Drawbacks and concerns == | |||
=== Default template look and feel === | |||
Frequent <tt>[% l() %]</tt> calls may obfuscate templates. Example: before (without numeric inflection logic) | |||
[% nbugs %] $terms.bugs were found in [% nproducts %] products. | |||
and after | |||
[% l("[_1] bug(s) were found in [_2] products.", nbugs, nproducts) %] | |||
Another option to consider is '''Locale::Maketext::Fuzzy''': | |||
[% |l %] | |||
[% nbugs %] bug(s) were found in [% nproducts %] product(s). | |||
[% END %] | |||
And then in '''en.po''': | |||
msgid "0 bug(s) were found in 0 product(s). | |||
msgstr "Zarro boogs found." | |||
msgid "[_1] bug(s) were found in [_2] product(s)." | |||
msgstr "%quant([_1],$terms.bug was,$terms.bugs were) found in %quant([_2],product)." | |||
Note exact match for a special case. | |||
=== Site maintainers' skills === | |||
Before '''Locale::Maketext''' only single knowledge was required from custom template maintainers: Template Toolkit. Now they'll need to work with message catalogs. | |||
== Work Breakdown == | == Work Breakdown == | ||
# Generic | # Generic <tt>Locale::Maketext</tt> capability | ||
## Specify and implement( | ## Specify and implement (English) <tt>%quant()</tt> and <tt>%numerate()</tt> calls | ||
## | ## <tt>maketext()</tt> support for Templates | ||
## | ## <tt>maketext()</tt> support for command line scripts | ||
## | ## <tt>Bugzilla::L10N</tt> setup and lexicon loader | ||
# Build tools | # Build tools | ||
## | ## <tt>xgettext.pl</tt>: collect localizable strings from templates and code. | ||
# Default template | # Default template refit | ||
## Script to hunt for localizable texts in templates (inspired by mkanat's attachment to {{bug|407752}}) | ## Script to hunt for localizable texts in templates (inspired by mkanat's attachment to {{bug|407752}}) | ||
## Convert all templates to '''l()''' filter calls | ## Convert all templates to '''l()''' filter calls | ||
## Extract | ## Extract default (English) lexicon | ||
# '''checksetup.pl | ## Translate English lexicon: expand tokens to full error messages, replace ''bug(s)'' with <tt>%quant([_1],bug)</tt> calls, and ''bug'' with <tt>$terms.bug</tt>. | ||
## Preprocess '''.po''' files from ''' | ## Test and debug English lexicon | ||
## Clone and translate English lexicon to other languages | |||
# <tt>checksetup.pl</tt> refit | |||
## Preprocess '''.po''' files from '''.po.tmpl''' files to accomodate '''$terms''' changes | |||
# Documenting | # Documenting | ||
# Test suite | # Test suite | ||
## | ## Detect localizable strings missing in lexicon (would fallback as ''auto'' entries anyway) | ||
## Decommission <tt>009bugwords.t<tt> | |||
What I have missed? | |||
== References == | == References == | ||