po2idml(1)

📦
version 3.19.5 · 9 versions
, in ubuntu stonking

💖 po2idml — the glow-up your translations deserve 💖

okay bestie, listen. po2idml is a lil command from the Translate Toolkit (we're on version 3.19.5 here, iconic) and it does one thing but it does it gorgeously: you hand it an IDML template file 🎀 and a PO file full of translations of the strings that live inside that IDML template, and it hands you back a brand new IDML file with all your translated strings slotted in. that's it. that's the whole vibe. no cap. ✨

🌸 NAME 🌸

po2idml — takes an IDML template file and a PO file containing translations of strings in the IDML template. It creates a new IDML file using the translations of the PO file. 🦋

⭐ SYNOPSIS ⭐

po2idml [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]

💅 OPTIONS 💅

like. every single one. no skipping, we don't do that here. 💜

  • --version — shows the program's version number and then dips out (exits). so slay of it.
  • -h/--help — prints this help message and exits. the classic "hello what is this" button. 😌
  • --manpage — spits out a manpage that's based on the help. meta fr fr.
  • --progress — decides how progress gets shown, and your choices are: dots, none, bar, names, verbose. pick your fav aesthetic. 📊
  • --errorlevel — decides how much error tea gets spilled: none, message, exception, traceback. (traceback is the unhinged one, we love her.) 💀
  • -i/--input — read from INPUT in the po, pot formats. your translations go here bestie.
  • -x/--exclude — exclude names matching EXCLUDE from the input paths. like a lil velvet rope for your files. 🚫✨
  • -o/--output — write to OUTPUT in the idml format. this is the glow-up result. 💖
  • -t/--template — read from TEMPLATE in the idml format. your IDML template lives here, don't forget her.
  • -S/--timestamp — skips the conversion entirely if the output file already has a newer timestamp. lowkey efficient, highkey respectful of your time. 🫶
heads up: -i/--input, -o/--output and -t/--template all want their argument, and --progress and --errorlevel want a value too. don't leave them hanging, that's rude. 🙈

🧚 SEE ALSO 🧚

(nothing listed in this one — go be the reference you wish to see in the world, periodt. 👑)

stay hydrated, keep your PO files tidy, and remember: this page is from Translate Toolkit 3.19.5. mwah. 💋🌈

📦 where this page comes from