po2flatxml(1)

📦
version 3.19.5 · 9 versions
, in ubuntu stonking

💖 po2flatxml — the girlies are converting PO files to flat XML 💖

okay so bestie, welcome to po2flatxml from the Translate Toolkit fam. It's a little command that takes your Gettext PO localization files and turns them into flat XML files. That's it, that's the whole vibe. 🦋

✨ NAME ✨

po2flatxml — Convert Gettext PO localization files to flat XML files.

periodt. that's literally the whole job description. 💅

🌸 SYNOPSIS 🌸

po2flatxml [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]
[-r|--root] [-v|--value] [-k|--key] [-n|--namespace] [-w|--indent]

like, that's a LOT of flags bestie, but every single one of them is serving a purpose I promise 🙈

👑 DESCRIPTION 👑

There's a whole page of examples and usage instructions waiting for you right here:

http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/flatxml2po.html

go read it, it's giving tutorial energy ✨

💜 OPTIONS 💜

  • --version — shows the program's version number and then dips out 🫶
  • -h/--help — shows this help message and then dips out. iconic behaviour honestly 👑
  • --manpage — spits out a manpage built from the help output. manpage inception fr fr 💀
  • --progress — how do you want your progress shown? your choices are: dots, none, bar, names, verbose. pick your aesthetic ✨
  • --errorlevel — how dramatic should the errors be? options are: none, message, exception, traceback. choose your chaos level 😭
  • -i/--input — read from INPUT in po, pot formats 📥
  • -x/--exclude — exclude names matching EXCLUDE from the input paths. bye felicia 👋
  • -o/--output — write to OUTPUT in xml format 📤
  • -t/--template — read from TEMPLATE in xml format 🎀
  • -S/--timestamp — skip the conversion entirely if the output file already has a newer timestamp. it's like "already knew that, no notes" 💅
  • -r/--root — the name of the XML root element (default: "root"). it's the main character of your XML tree 👑
  • -v/--value — the name of the XML value element (default: "str") 💖
  • -k/--key — the name of the XML key attribute (default: "key") 🔑
  • -n/--namespace — the XML namespace uri (default: None). ngl she's optional, she's mysterious 🦋
  • -w/--indent — indent width in spaces, and 0 means no indent at all (default: 2). space it out or don't, we're not judging 🌸
quick lil reminder bestie: the -r, -v, -k, -n, and -w flags are all about shaping that flat XML output exactly how you want it. defaults exist so you don't have to think about it, but the moment you want control, she's there 🫶

🌈 SEE YA 🌈

this whole page came to you courtesy of Translate Toolkit 3.19.5 — version 3.19.5, dated the same, because that's just how they do the footer around here 💀

stay slay, go convert something, and remember: your PO files could never be flat XML on their own. that's what I'M here for 💖✨🎀

📦 where this page comes from