dtd2po(1)

💅 dtd2po(1) — your Mozilla .dtd to Gettext PO bestie 💅

okay so welcome to the dtd2po(1) manual page from Translate Toolkit 3.12.1. This is the little icon that converts a Mozilla .dtd UTF-8 localization format into a Gettext PO localization file. no cap.

🎀 NAME 🎀

dtd2po — converts a Mozilla .dtd UTF-8 localization format to a Gettext PO localization file. 💖

✨ SYNOPSIS ✨

dtd2po [--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]

🦋 DESCRIPTION 🦋

So this tool uses the po and dtd modules, plus the dtd2po convertor class that lives in this module. Yes, “convertor” — that’s the spelling in the source, bestie, we’re not correcting it. 💅

You can convert back to .dtd using po2dtd.py. round-trip queen behavior, honestly. ✨

🌸 OPTIONS 🌸

• --version — shows the program’s version number and exits.
• -h/--help — shows the help message and exits.
• --manpage — outputs a manpage based on the help.
• --progress — shows progress as: dots, none, bar, names, verbose.
• --errorlevel — shows errorlevel as: none, message, exception, traceback.
• -i/--input — reads from INPUT in dtd format.
• -x/--exclude — excludes names matching EXCLUDE from input paths.
• -o/--output — writes to OUTPUT in po, pot formats.
• -t/--template — reads from TEMPLATE in dtd format.
• -S/--timestamp — skips conversion if the output file has a newer timestamp.
• -P/--pot — outputs PO Templates (.pot) rather than PO files (.po).
• --duplicates — what to do with duplicate strings (identical source text): merge, msgctxt (default: 'msgctxt').

lowkey important: --duplicates defaults to 'msgctxt', so if you don’t touch it, that’s the duplicate-string behavior. 💅

cute little sign-off: this page is serving Translate Toolkit 3.12.1 source/version energy, and there’s no date stamped on this footer, bestie — that’s the whole footer vibe. 💖✨