flatxml2po(1)

💅 flatxml2po(1) — bestie edition ✨

okay so. flatxml2po is the girlie from the Translate Toolkit family (version 3.19.5, for the record 👑) and she does exactly one thing and she does it immaculately: she takes your flat XML files and turns them into Gettext PO localization files. that's it. that's the whole vibe. 🦋

---

✨ NAME ✨

flatxml2po — Convert flat XML files to Gettext PO localization files. no cap. 🎀

---

🌸 SYNOPSIS 🌸

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

like yes it's a lot of brackets bestie but every single one of them is doing something i promise 😭

---

💖 DESCRIPTION 💖

so the actual lore, the how-to, the examples, the whole usage situation? it lives here:

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

go read it, it's giving documentation. 📖✨

---

👑 OPTIONS 👑

here's the full roster, no skips, no cuts, we respect all of them equally 💅

• --version — shows the program's version number and dips. that's it, that's the whole job.
• -h/--help — prints this help message and exits. your bestie when you forget everything.
• --manpage — spits out a manpage built from the help output. manpage inception, iconic honestly.
• --progress — how much progress tea do you want spilled? options are: dots, none, bar, names, verbose.
• --errorlevel — how dramatic should the errors be? choices: none, message, exception, traceback. pick your chaos level 🌈
• -i/--input — read from INPUT in xml format. this is where your files come in 🫶
• -x/--exclude — exclude names matching EXCLUDE from the input paths. not today, bestie 🚫
• -o/--output — write to OUTPUT in po, pot formats. this is the glow-up destination ✨
• -S/--timestamp — skip the conversion entirely if the output file already has a newer timestamp. she's efficient, she's not doing work twice 💀
• -r/--root — name of the XML root element (default: "root"). yes literally just the word root, she's not subtle.
• -v/--value — name of the XML value element (default: "str").
• -k/--key — name of the XML key attribute (default: "key"). love a naming convention that ate 🔥
• -n/--namespace — XML namespace uri (default: None). as in, there isn't one unless you bring one 🧚

---

heads up bestie: the defaults are "root", "str", "key", and None — if your XML doesn't match those, you're gonna have to tell her. she's not psychic (she's just very good at her job). 🙈

---

and that's the whole page, fr fr. 🌟

Translate Toolkit 3.19.5 — mwah, go localize something gorgeous, you main character 💜🎀✨