ical2po(1)

💖 ical2po(1) — the manual, but make it make sense 💖

okay bestie, so this is the manual page for ical2po, and it lives inside the Translate Toolkit family (version 3.12.1, in case you were wondering 👀). grab a lil snack, we're converting calendars into translation files and it's honestly kind of iconic.

---

✨ NAME ✨

ical2po — the little tool that takes your iCalendar files and turns them into Gettext PO localization files. yes. calendars → translations. it's giving multilingual main character energy 🗓️➡️💬

---

🌸 SYNOPSIS 🌸

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

like, that whole line up there is the whole vibe check of what this command can accept. every bracket-y bit is optional-ish, INPUT and OUTPUT are the main characters ofc 💅

---

🦋 DESCRIPTION 🦋

okay so here's the deal — there are actual examples and usage instructions living at:

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

go read them, they're lowkey required reading before you start poking at your .ics files, no cap 🔥

---

🎀 OPTIONS 🎀

• --version — shows the program's version number and then dips out. classic exit behavior, we respect it 👋
• -h/--help — prints this help message and bounces. your friendly lil "what do I do" button 💁‍♀️
• --manpage — spits out a manpage built from the help text. very meta. very recursive. we love her 🌀
• --progress — controls how progress gets shown. your choices: dots, none, bar, names, verbose. pick your fighter 🎯
• --errorlevel — controls how loud the errors are. your choices: none, message, exception, traceback. from "say nothing" to "show me the whole crime scene" 😭
• -i/--input — read from INPUT, and that input is in ics format. your calendar source right here 📥🗓️
• -x/--exclude — kicks out any names matching EXCLUDE from the input paths. boundaries, bestie 🚫✨
• -o/--output — write to OUTPUT, in po and pot formats. the destination of your newly localized calendar 🎁
• -t/--template — read from TEMPLATE, which is also in ics format. use an existing one as your blueprint 🧵
• -S/--timestamp — skips the conversion entirely if the output file already has a newer timestamp. lazy in the smartest way possible 😴👑
• -P/--pot — outputs PO Templates (.pot) instead of regular PO files (.po). template era fr fr 📝
• --duplicates — decides what happens with duplicate strings (identical source text). your options are merge or msgctxt, and the default is 'msgctxt'. the classic "wait, which one did I mean" problem, solved 🫶

real talk: --duplicates defaults to 'msgctxt', so if that's not what you want, bestie you gotta say so out loud on the command line 💀

---

okay that's the whole page!! Translate Toolkit 3.12.1 made this one — shoutout to them, and shoutout to you for reading all the way to the bottom 🫶✨ bye bestie, go convert some calendars 💜