poswap(1)

πŸ’… poswap(1) β€” the glow-up era

okay bestie, welcome to poswap, part of the Translate Toolkit 3.19.5 era. this is the little command with big main character energy: it builds a brand new translation file where the target of your input language becomes the source language. it's giving remix. it's giving rebirth. πŸ¦‹


✨ NAME ✨

poswap β€” Builds a new translation file with the target of the input language as source language.

like. literally that. it takes a translation and flips it so what used to be the destination becomes the starting point. obsessed. πŸ’–


🌸 SYNOPSIS 🌸

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

that's the whole vibe check right there. all the flags, one line, no cap. ✨


πŸŽ€ DESCRIPTION πŸŽ€

bestie. READ THIS FIRST. Make sure your two po files correspond 100% to the same pot file before using this. fr fr. do not skip this. this is the whole ballgame. πŸ’€

so here's the tea πŸ“ β€” you can translate one language through another one. like a relay race but make it linguistics.

To translate Kurdish (ku) through French:

poswap -i fr/ -t ku -o fr-ku

To convert the fr-ku files back to en-ku:

poswap --reverse -i fr/ -t fr-ku -o en-ku

To translate Quechua (qu) through Spanish (es) using intermediate mode:

poswap --intermediate -t en/ es/ es-qu/

now let's talk about intermediate mode because she's the moment πŸ‘‘ β€” it keeps the original source language (English) and adds the intermediate language translation (Spanish) as a translator comment. so you get to translate through a middle language while both languages stay visible the whole time. it's giving bilingual icon behavior. 🌈

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

iykyk πŸ’…


⭐ OPTIONS ⭐

  • --version β€” show program's version number and exit. the classic "who am i" moment.
  • -h/--help β€” show this help message and exit. your safety net bestie 🫢
  • --manpage β€” output a manpage based on the help. manpage-ception, iconic.
  • --progress β€” show progress as: dots, none, bar, names, verbose. pick your fave way to watch the little progress goblin work 🧚
  • --errorlevel β€” show errorlevel as: none, message, exception, traceback. how much do you want to know when things go sideways 😭
  • -i/--input β€” read from INPUT in po, pot formats.
  • -x/--exclude β€” exclude names matching EXCLUDE from input paths. bye felicia, not you πŸ‘‹
  • -o/--output β€” write to OUTPUT in po, pot formats.
  • -t/--template β€” read from TEMPLATE in po, pot, pot formats. (yes bestie, it says po, pot, pot. that's what it says. we do not question the source. πŸ’€)
  • -S/--timestamp β€” skip conversion if the output file has newer timestamp. she's efficient. she's not doing redundant work. periodt.
  • --reverse β€” reverse the process of intermediate language conversion. the uno reverse card 🎴
  • --intermediate β€” use intermediate language mode: keep original source and add target as translator comment. both languages stay visible, bestie, no gatekeeping. 🌸

and that's the whole page, bestie. go forth and swap those po files. you're gonna eat. πŸ”₯πŸ‘‘

β€” brought to you by Translate Toolkit 3.19.5, dated like the little legend she is. mwah. πŸ’–βœ¨

πŸ“¦ where this page comes from