html2po(1)

📦
version 3.19.5 · 9 versions
, in ubuntu stonking

💖 html2po(1) — the bestie guide 💖

okay so. bestie. listen. html2po is the little command that takes your HTML files and turns them into Gettext PO localization files, and honestly? it's giving translator-core. it's part of the Translate Toolkit (version 3.19.5, for the record 👑), and this is its manual page but make it make sense.

✨ NAME ✨

html2po — convert HTML files to Gettext PO localization files. that's the whole vibe. HTML in, PO out, slay. 🦋

🌸 SYNOPSIS 🌸

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

like, that's a LOT of flags but don't panic, we're going through every single one below 💅

🎀 DESCRIPTION 🎀

so the actual examples and usage instructions live here:

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

go read that for the receipts, iykyk. this page is just the flags, but i'll hold your hand through all of them 🫶

💅 OPTIONS 💅

every single one. no skips. periodt.

  • --version — shows the program's version number and then dips out. bye ✌️
  • -h, --help — shows this help message and then also dips. iconic behaviour honestly.
  • --manpage — outputs a manpage built from the help. meta much? 💀
  • --progress — shows progress as one of: dots, none, bar, names, verbose. pick your vibe check.
  • --errorlevel — shows error level as one of: none, message, exception, traceback. how much drama do you want when something goes wrong, bestie?
  • -i, --input — read from INPUT in htm, html, xhtml formats. this is where the source files come from 👑
  • -x, --exclude — exclude names matching EXCLUDE from the input paths. not you, not you, not you 🙈
  • -o, --output — write to OUTPUT in po, pot formats. the destination, the main character of the file system ✨
  • -t, --template — read from TEMPLATE in. (yes, the formats list after "in" is literally empty in the original, so i'm not gonna invent one, okay? leave her alone 😭)
  • -S, --timestamp — skip conversion if the output file has a newer timestamp. if it's fresher than you, don't touch it 💅
  • -P, --pot — output PO Templates (.pot) rather than PO files (.po). template era.
  • --keepcomments — preserve html comments as translation notes in the output. keeping the receipts, love that for us 🎀
  • --duplicates — what to do with duplicate strings (identical source text): merge, msgctxt (default: 'msgctxt'). so like, same words showing up twice? you decide if they get merged or handled with msgctxt. the default is msgctxt, no cap.
  • --multifile — how to split po/pot files: single, toplevel or onefile. choose your splitting situation 🌈
🌟 little reminder bestie: don't guess at what these do beyond what's written here — the flags are the flags, and the defaults are the defaults. respect the manpage 📜

🧚 and that's the page 🧚

that's it, that's the whole manual. go localize something pretty and text your translator bestie about it. 💜

this page is part of Translate Toolkit 3.19.5, and it's the html2po(1) manual. bye bye, ily, drink water 🌸🦋✨

📦 where this page comes from