po2yaml(1)

🌸 po2yaml — the manual page, but make it make sense 💖

okay so bestie, this is po2yaml(1) from the Translate Toolkit, and it's literally the glow-up pipeline: you take your Gettext PO localization files and you turn them into YAML files. no cap. 🌈

---

✨ NAME ✨

po2yaml — Convert Gettext PO localization files to YAML files. that's it, that's the whole job, and it does it flawlessly 💅

---

🦋 SYNOPSIS 🦋

po2yaml [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]
[--threshold PERCENT] [--fuzzy] [--nofuzzy] [--personality TYPE]

like yes queen, that's a LOT of flags, but every single one is here to help you and we're gonna go through all of them together 🫶

---

🎀 DESCRIPTION 🎀

okay so the toolkit itself wants you to go read the docs for examples and usage instructions, and honestly? respect. they said:

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

(that's the yaml2po page btw — the reverse direction — and yes, the original manual really does point you there, so go look at it and don't @ me 🙈)

---

💜 OPTIONS 💜

every flag, every default, no skips. take notes bestie 📝

• --version — shows the program's version number and then exits. short and iconic ✨
• -h/--help — shows this help message and exits. your "wait what was that flag again" emergency button 💖
• --manpage — spits out a manpage based on the help output. manpage-ception, we love to see it 👑
• --progress — shows progress as: dots, none, bar, names, verbose. pick your vibe of ongoing-ness 🔥
• --errorlevel — shows errorlevel as: none, message, exception, traceback. how much detail do you want when things go sideways, choose wisely 😭
• -i/--input — read from INPUT in po, pot formats. this is your source material bestie 📥
• -x/--exclude — exclude names matching EXCLUDE from input paths. bye felicia, not you 🚫
• -o/--output — write to OUTPUT in yaml, yml formats. the destination of the whole glow-up 💅
• -t/--template — read from TEMPLATE in yaml, yml formats. for when you want the finished thing to already know its shape ✨
• -S/--timestamp — skip conversion if the output file has a newer timestamp. it's giving "girl you're already up to date, go drink water" 🍓
• --threshold — only convert files where the translation completion is above PERCENT. a vibe check for your translations, literally 📊
• --fuzzy — use translations marked fuzzy 🌀
• --nofuzzy — don't use translations marked fuzzy (this is the default, so if you do nothing, nothing fuzzy gets in, periodt) 💀
• --personality — override the output YAML format: default, ruby (for Ruby on Rails YAML files with a language root node, e.g. 'en:' or 'ca:'). yes, it's called personality, and yes, that's the most main-character option name in this whole toolkit 🧚

⚠️ heads up: --nofuzzy is the default. so if you're like "why are my fuzzy translations not showing up 😭" — that's why. pass --fuzzy if you want them, bestie.

---

🌟 SEE ALSO 🌟

(no see-also section in the original, so we're keeping it that way — but the DESCRIPTION does send you to http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/yaml2po.html, which is your homework, do it 📚)

---

and that's the whole page, you ate that 🍽️💖 go convert some PO files into YAML and be the main character of your localization pipeline. sending you so much love from Translate Toolkit 3.19.5 — that's the version that brought you this little masterpiece. mwah 💋🌈✨