po2flatxml(1)

🦋 po2flatxml — like, the manual page, but make it make sense ✨

okay so bestie, welcome to the po2flatxml(1) page from Translate Toolkit 3.12.1 — yes, the whole manual, and yes I'm gonna walk you through it like we're texting at 1am 💜

---

✨ NAME ✨

po2flatxml — the little icon that converts Gettext PO localization files into flat XML files. that's it, that's the job, and she does it flawlessly 💅

---

🎀 SYNOPSIS 🎀

like, here's how you actually call her:

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]

no notes, she ate 💖

---

🌸 DESCRIPTION 🌸

okay so the page is very chill about this and just points you at the docs, so I'm passing the pointer straight to you, no cap:

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

that's where the actual examples and usage instructions live — go look, she's iconic 👑

---

💖 OPTIONS 💖

every single one, in order, nothing skipped, because I would never 🙈

• --version — show program's version number and exit. the "who even am I" flag 💁‍♀️
• -h/--help — show this help message and exit. use it, bestie, it's free
• --manpage — output a manpage based on the help. manpage-ception, we love to see it 🌀
• --progress — show progress as: dots, none, bar, names, verbose. pick your vibe check for how much you wanna watch it work ✨
• --errorlevel — show errorlevel as: none, message, exception, traceback. how much detail you want when things go sideways 😭
• -i/--input — read from INPUT in po, pot formats. the source material, the moment, the main character 📥
• -x/--exclude — exclude names matching EXCLUDE from input paths. not you, girl, sit down 🚫
• -o/--output — write to OUTPUT in xml format. the glow-up destination 📤
• -t/--template — read from TEMPLATE in xml format. giving it a blueprint to follow 🧚
• -S/--timestamp — skip conversion if the output file has newer timestamp. lowkey efficient, highkey lazy, we stan ⏰
• -r/--root — name of the XML root element (default: "root"). the foundation, the parent, the one who holds it all together 🌳
• -v/--value — name of the XML value element (default: "str"). where the actual words go 💬
• -k/--key — name of the XML key attribute (default: "key"). the label on the tin 🏷️
• -n/--namespace — XML namespace uri (default: None). no namespace unless you say so, and honestly respect 🫶
• -w/--indent — indent width in spaces, 0 for no indent (default: 2). two spaces is the correct answer and I will not be taking questions 💅

ngl, defaults are doing a lot of heavy lifting here — "root", "str", "key", None, and 2. if you don't pass them, that's what you get, fr fr 🍓

---

🌈 that's the whole page, bestie 🌈

this was po2flatxml(1) from Translate Toolkit 3.12.1, and that's the version and everything you need to quote at people when they ask where the docs came from. go convert some PO files into flat XML, you absolute legend 👑💖✨