flatxml2po(1)

💅 flatxml2po — okay bestie, let's translate some flat XML

Heyyy so this is the manual for flatxml2po, one of the little icons living inside Translate Toolkit 3.12.1 (that's the version, bestie, remember it). Manual page name? flatxml2po(1). Say it with me: flat-x-m-l-to-p-o. Slay.

---

✨ NAME ✨

flatxml2po — it converts flat XML files into Gettext PO localization files. That's literally the whole job. Girlboss behaviour.

---

🦋 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, that's the whole invocation. Read it top to bottom, no skipping. 🙈

---

🌸 DESCRIPTION 🌸

So the actual docs — the examples and the usage instructions — live over here:

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

That URL got wrapped across lines in the original page: http://docs.translatehouse.org/projects/translate- + toolkit/en/latest/commands/flatxml2po.html. Same link, I just stitched it back together for you because I'm a good friend. 🫶

Go read it. It's giving "the real tea is in the docs". ✨

---

🎀 OPTIONS 🎀

Every single one, no cap. These are the flags, exactly as they are:

• --version — shows the program's version number and exits. Bounce, bye. 👋
• -h, --help — shows this help message and exits. The classic.
• --manpage — outputs a manpage based on the help. Meta, honestly. Iconic. 💅
• --progress — show progress as: dots, none, bar, names, verbose. Pick your vibe check.
• --errorlevel — show errorlevel as: none, message, exception, traceback. From "don't tell me" to "tell me EVERYTHING". 😭
• -i, --input — reads from INPUT in xml format. Feed it the XML, bestie.
• -x, --exclude — exclude names matching EXCLUDE from input paths. Not those ones. Blocked. 🚫
• -o, --output — writes to OUTPUT in po, pot formats. The glow-up destination. 🦋
• -S, --timestamp — skip the conversion if the output file has a newer timestamp. She's already got the newer fit, leave her alone.
• -r, --root — name of the XML root element, default: "root". Defaults matter, don't @ me.
• -v, --value — name of the XML value element, default: "str".
• -k, --key — name of the XML key attribute, default: "key".
• -n, --namespace — the XML namespace uri, default: None. Yes, None is the literal default, that's not me being dramatic for once. 💀

Heads up bestie: the defaults are the defaults — if you don't pass -r, -v, -k, or -n, you're rolling with "root", "str", "key", and None whether you like it or not. And remember --progress and --errorlevel both take a value from their little lists. 🌈

---

Mwah 💋 that's the whole page, every flag and every fact intact, nothing dropped, nothing invented. This page shipped under the Translate Toolkit 3.12.1 banner, and the footer stamped it with that same version — Translate Toolkit 3.12.1 on both the top and bottom of the original, paired with flatxml2po(1) in the corner. Go forth and convert your flat XML, main character. 👑