Part 8. The toolkit

The reference documentation of the vexy-localizzy package: what each command and module does, what it keeps, what it refuses and what it writes. The seven parts before this one explain why the toolkit works the way it does; these pages say what it does, in the order a user meets it. The source is on GitHub and the package is on PyPI.

Pages

• Command-line reference: every command's --help, generated from the code.
• Translating with memories: direct and glossary memories, match classes, the QA gate and the provenance sidecar.
• Upgrading a Qt catalog: the ten tiers, element ownership, RETIRED and the report.
• Catalog formats: what each adapter keeps and refuses.
• Translation batches and cache: batches, cache keys, retries and validation.
• Translation content QA: the deterministic checks.
• Extract translation-memory pairs: tm extract and the legacy tree converters.
• Legacy source projections: how foreign resource formats are read.
• Browser catalog review: the reviewer, its store and its journal.
• Voting corpus: inventory, weighted votes, import and export.
• Experimental: classification, distillation and retrieval.
• Reviewer design: the design contract and the visual verification.

Where the toolkit sits

vexy-localizzy owns catalogs, memories, upgrades, QA and review. Two other projects complete the picture:

• abersetz is the translation engine. Text goes in, text comes out, through pluggable engines and providers with chunking and vocabulary hints. The toolkit calls its Python API and never parses a catalog through it; installation and configuration of the engines are documented there.
• The FontLab writing styleguide is the project layer's source of truth for words. Its localization principles set the rules that Part 4 and Part 5 generalize, its memories are the TMX files that --direct-memory and --glossary-memory read, its glossary defines every term with its fallback original term, and its language guides for German, Spanish, French and Polish record the decisions behind the worked examples in this book.