pofilter(1)

✨ pofilter β€” the vibe check for your localization files ✨

okay bestie, welcome to pofilter(1) πŸ’… this is the Translate Toolkit 3.19.5 girlie whose whole job is running quality checks on your Gettext PO, XLIFF and TMX localization files. she's not mean, she's just honest. πŸŽ€


🌸 NAME 🌸

pofilter β€” perform quality checks on Gettext PO, XLIFF and TMX localization files.


πŸ¦‹ SYNOPSIS πŸ¦‹

pofilter [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-l|--listfilters] [--review] [--noreview]
[--fuzzy] [--nofuzzy] [--nonotes] [--autocorrect] [--language LANG]
[--openoffice] [--libreoffice] [--mozilla] [--drupal] [--gnome] [--kde]
[--wx] [--excludefilter FILTER] [-t|--test FILTER] [--notranslatefile
FILE] [--musttranslatefile FILE] [--validcharsfile FILE]

πŸ’– DESCRIPTION πŸ’–

So here's the tea β˜• every single time a test fails, pofilter makes a snippet file. no cap. those snippets are like little screenshots of the problem β€” you can look at them πŸ‘€, fix them up ✍️, and then merge them back into the originals using pomerge. it's giving "cleanup era." 🧹✨

want examples and usage instructions? the docs have you covered: http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/pofilter.html

want the full description of literally every test it can run? also covered: http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/pofilter_tests.html

iykyk πŸ“š


πŸ‘‘ OPTIONS πŸ‘‘

  • --version β€” shows the program's version number and then dips out. bye bestie πŸ‘‹
  • -h/--help β€” prints this help message and exits. the classic "help me help you" moment 🫢
  • --manpage β€” spits out a manpage based on the help output. meta, honestly πŸ’«
  • --progress β€” how do you want your progress shown? your choices are: dots, none, bar, names, verbose. pick your aesthetic πŸŽ€
  • --errorlevel β€” how do you want your errors shown? your choices are: none, message, exception, traceback. choose your level of drama πŸ’€
  • -i/--input β€” read from INPUT in po, pot, tmx, xlf, xliff formats. that's the source material, bestie πŸ“₯
  • -x/--exclude β€” exclude names matching EXCLUDE from the input paths. not everything deserves an invite to the party πŸ™…β€β™€οΈ
  • -o/--output β€” write to OUTPUT in po, pot, tmx, xlf, xliff formats. this is where the receipts go 🧾✨
  • -l/--listfilters β€” lists the filters that are available. window shopping, but for checks πŸ›οΈ
  • --review β€” include units marked for review. this one is the default, so it's already the main character 🌟
  • --noreview β€” exclude units marked for review. ghosting them, respectfully πŸ‘»
  • --fuzzy β€” include units marked fuzzy. also the default 🐻 (fuzzy wuzzy bear, iconic)
  • --nofuzzy β€” exclude units marked fuzzy. fuzzy units, you are NOT coming 🚫
  • --nonotes β€” don't add notes about the errors. just the drama, no commentary πŸ™ˆ
  • --autocorrect β€” where possible, output automatic corrections instead of describing the issues. she doesn't just point, she fixes πŸ’…βœ¨
  • --language β€” set the target language code (e.g. af-ZA). required for spell check, and recommended in general, fr fr 🌍
  • --openoffice β€” use the standard checks for OpenOffice translations πŸ“„
  • --libreoffice β€” use the standard checks for LibreOffice translations πŸ“
  • --mozilla β€” use the standard checks for Mozilla translations 🦊
  • --drupal β€” use the standard checks for Drupal translations πŸ’§
  • --gnome β€” use the standard checks for Gnome translations 🐾
  • --kde β€” use the standard checks for KDE translations πŸ–₯️
  • --wx β€” use the standard checks for wxWidgets translations 🧩
  • --excludefilter β€” don't use FILTER when filtering. sit this one out, filter πŸͺ‘
  • -t/--test β€” only use the test *FILTER*s specified with this option when filtering. it's giving "curated guest list" 🎟️
  • --notranslatefile β€” read a list of untranslatable words from FILE. these ones must not be translated πŸš«πŸ”€
  • --musttranslatefile β€” read a list of translatable words from FILE. these ones must be translated βœ…πŸ”€
  • --validcharsfile β€” read a list of all valid characters from FILE. it must be in UTF-8, no exceptions bestie 🌐

ngl, this girl is running on Translate Toolkit 3.19.5 🫢 go run your checks, fix your snippets, merge them back with pomerge, and remember: every failed filter is just the universe telling you to level up. slay πŸ’…βœ¨πŸ’–
πŸ“¦ where this page comes from