pomerge(1)

📦
version 3.19.5 · 9 versions
, in ubuntu stonking

💖 pomerge(1) — the Translate Toolkit glow-up 💖

okay bestie, sit down, hydrate, because we're talking about pomerge from the Translate Toolkit and it's genuinely a whole vibe. ✨

🌸 NAME 🌸

pomerge — Merges XLIFF and Gettext PO localization files. yes. that's the whole job. it takes your translation files and smooshes them together. slay. 💅

🎀 SYNOPSIS 🎀

pomerge [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]
[--mergeblanks] [--mergefuzzy] [--mergecomments]

🦋 DESCRIPTION 🦋

so here's the tea: a snippet file — the kind that gets produced by, like, pogrep (that's :doc:pogrep </commands/pogrep> if you want the fancy docs reference) — gets handed off to a translator, translated, updated, whatever. and then pomerge takes that snippet file and merges it back into the original files. round trip. reunion tour. the translations come home. 🫶

See: http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/pomerge.html for examples and usage instructions.

fr fr go read that link, it's got the examples and the whole usage walkthrough. no cap.

✨ OPTIONS ✨

  • --version — show program's version number and exit. quick lil flex and then it's gone. 👋
  • -h, --help — show this help message and exit. the classic. the icon.
  • --manpage — output a manpage based on the help. yes it generates a manpage. meta? a little. iconic? absolutely. 👑
  • --progress — show progress as: dots, none, bar, names, verbose. pick your fave progress aesthetic 🍓
  • --errorlevel — show errorlevel as: none, message, exception, traceback. how much drama do you want when things go wrong 💀
  • -i, --input — read from INPUT in po, pot, pot, xlf, xliff formats
  • -x, --exclude — exclude names matching EXCLUDE from input paths. not like that, bestie ✋
  • -o, --output — write to OUTPUT in po, pot, pot, xlf, xliff formats
  • -t, --template — read from TEMPLATE in po, pot, pot, xlf, xliff formats
  • -S, --timestamp — skip conversion if the output file has newer timestamp. it's giving "we already have that one at home" 🙈
  • --mergeblanks — whether to overwrite existing translations with blank translations (yes/no). Default is yes.
  • --mergefuzzy — whether to consider fuzzy translations from input (yes/no). Default is yes.
  • --mergecomments — whether to merge comments as well as translations (yes/no). Default is yes.
⚠️ heads up bestie: those last three all default to yes, so if you don't want blanks, fuzzy stuff, or comments riding along, you gotta say so. nobody's out here guessing for you. 💀

and that's the whole page, you ate it, you understood it, you're lowkey a localization main character now 🌈

lots of love from Translate Toolkit 3.19.5, and from pomerge(1) itself — mwah, periodt. 💖✨🎀

📦 where this page comes from