L20n/Toolchain

From MozillaWiki
< L20n
Revision as of 16:18, 29 May 2012 by Gandalf (talk | contribs) (Created page with "== Overview == L20n provides a basic command-line tool set for localizers, developers and localization maintainers (aka release drivers). The toolchain enables all three partie...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Overview

L20n provides a basic command-line tool set for localizers, developers and localization maintainers (aka release drivers).

The toolchain enables all three parties to:

  • start a new localization project
  • learn about the status of one or more localizations
  • learn about what has to be done for the localization to be completed
  • aid in updating localizations to a given version of product string set
  • manage complete localizations for release purposes

Basic concepts

The toolchain is written in python and is made of library code and command line scripts. Command line scripts are meant to be used directly by end users, while the library code behind them constitutes an API for tool developers to build on top of.

Second design decision is to leave the process details open to particular project preference. The way the project structures the localization directories, what files are part of localization pack etc. are just stored within the project cfg file that l20n toolchain reads from. It also executes particular code for each project for things like bootstrapping new locale or updating an existing one.

In particular it works like this:

  • a project has to have a single l10n.cfg file in /config directory
  • the file has to point to particular API code that will be executed as part of toolchain commands
  • and any additional settings for the given project (like, which locale is a source one)

Commands

l10n-bootstrap

l10n-status

l10n-update