dtd2po(1)

💖 dtd2po — like, the whole vibe 💖

okay bestie, welcome to dtd2po(1) from the Translate Toolkit 3.19.5 era — she's a little old-school but she ATE, fr fr. Sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

dtd2po — the girl whose whole job is turning a Mozilla .dtd UTF-8 localization file into a Gettext PO localization file. That's it. That's the gig. She's the translator from DTD-land to PO-land and she does it flawlessly 💅

---

✨ 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]

no cap, that's the whole shape of her 🌸

---

✨ DESCRIPTION ✨

So like. Under the hood? She's built on the po module and the dtd module, plus the dtd2po convertor class which lives in this very module. iykyk. 🧚

And the important part, bestie — you can absolutely convert back to .dtd using po2dtd.py. round trip queen 👑

---

✨ OPTIONS ✨

• --version — shows the program's version number and then dips out. exit stage left 🫶
• -h/--help — shows you this help message and then dips out too. the two of them leave together, iconic.
• --manpage — spits out a manpage built straight from the help. meta af.
• --progress — how loud she is about progress ✨ the options are: dots, none, bar, names, verbose. pick your vibe.
• --errorlevel — how loud she is about errors 😭 the options are: none, message, exception, traceback. choose your chaos level.
• -i/--input — read from INPUT in dtd format. she needs her snack.
• -x/--exclude — exclude any names matching EXCLUDE from the input paths. not me ghosting half your files 💀
• -o/--output — write to OUTPUT in po, pot formats. both formats, she's flexible like that.
• -t/--template — read from TEMPLATE in dtd format. a little blueprint, a little inspo 🎀
• -S/--timestamp — skip the conversion if the output file already has a newer timestamp. she checks before she works, lowkey respectful of your time.
• -P/--pot — output PO Templates (.pot) rather than PO files (.po). template girlies rise 🌈
• --duplicates — what to do with duplicate strings (identical source text). the options are: merge, msgctxt. the default is 'msgctxt'. heads up though — if you don't say anything, she goes with msgctxt, so don't be surprised when she does.

---

⚠️ bestie note: --duplicates is doing choices about your identical strings. merge and msgctxt are genuinely different outcomes for your file. pick with intention, don't just let the default happen to you. ✋

---

and that's the whole page!! 🌟 this gorgeous thing came to you courtesy of Translate Toolkit 3.19.5 — that's the version and the source of this very manpage, mwah 💋. stay translating, stay hydrated, and remember: .dtd in, .po out, po2dtd.py to come home. periodt. 💜🦋⭐