csv2po(1)

📦
version 3.19.5 · 9 versions
, in ubuntu stonking

💖 csv2po — ok bestie, let's turn your spreadsheets into translation files 💖

Hi hi hiii 🫶 this is the csv2po manual page, from the Translate Toolkit (version 3.19.5, she's iconic). If you're holding a .csv file and crying because you need a Gettext PO file instead — girl, same, but also: this tool is literally made for exactly that. No cap.

✨ NAME ✨

csv2po — Convert Comma-Separated Value (.csv) files to Gettext PO localization files. That's it, that's the whole job, and she does it flawlessly. 💅

🌸 SYNOPSIS 🌸

csv2po [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]
[-P|--pot] [--charset CHARSET] [--columnorder] [--duplicates
DUPLICATESTYLE]

Look at her. All those flags. Main character energy honestly. 🎀

🦋 DESCRIPTION 🦋

Okay so the actual how-to lives over here, and you should 100% go read it because it has examples and usage instructions and everything:

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

That's the spot for examples and usage instructions — the manual page (this one, hi) is just the flag menu, iykyk. ✨

💜 OPTIONS 💜

Every single one, in order, nothing skipped, because we do not gatekeep here:

  • --version — show program's version number and exit. Quick lil "who am I" moment. 👑
  • -h/--help — show this help message and exit.
  • --manpage — output a manpage based on the help. (Manpage-ception. So meta. Obsessed.) 😭
  • --progress — show progress as: dots, none, bar, names, verbose. Pick your vibe check for how much you wanna watch it chug along. 🍓
  • --errorlevel — show errorlevel as: none, message, exception, traceback. Basically: how much detail do you want when things go sideways? Choose wisely bestie.
  • -i/--input — read from INPUT in csv format. Your source spreadsheet, the whole reason we're here. 📥
  • -x/--exclude — exclude names matching EXCLUDE from input paths. Not today, certain files. Not today. 🙈
  • -o/--output — write to OUTPUT in po, pot formats. Where the glow-up gets saved. 💾
  • -t/--template — read from TEMPLATE in po, pot, pot formats. (Yes, pot is listed twice in the original — I'm just reporting the facts, fr fr, not touching it.) 🌈
  • -S/--timestamp — skip conversion if the output file has newer timestamp. She said "already fresh, not redoing my work." 💅
  • -P/--pot — output PO Templates (.pot) rather than PO files (.po). Template era instead of translation era. ✨
  • --charset — set charset to decode from csv files. Because encoding drama is real and we respect it. 🧚
  • --columnorder — specify the order and position of columns (location,source,target,context). You tell her how your columns are laid out, she doesn't have to guess. Periodt.
  • --duplicates — what to do with duplicate strings (identical source text): merge, msgctxt (default: 'msgctxt'). So if the same source text shows up twice, you either merge them or give them msgctxt — and the default is 'msgctxt'. 🔥
Heads up bestie 💀 the duplicate-string answer matters — if you've got identical source text hanging around, pick merge or msgctxt on purpose instead of letting it surprise you. The default is 'msgctxt', just so you know what you're getting. 🫶

🌟 SEE ALSO 🌟

Um, there isn't a SEE ALSO section in this page — but the DESCRIPTION points you at the Translate Toolkit docs page above, which is basically the same energy. Go look at her. She's pretty. 💖

Okay that's the whole page, you made it, I'm so proud of you. 🎀 This was the csv2po page from Translate Toolkit 3.19.5 — go convert literally everything, you're gonna slay. 💅✨🦋

📦 where this page comes from