MAKETEXT(1p)

💖 NAME 💖

maketext — okay bestie, this is the little script that translates and makes messages ✨

---

🌸 SYNOPSIS 🌸

maketext [OPTION] [--domain=TEXTDOMAIN] MSGKEY [PARAM...]
maketext [OPTION] -s MSGKEY [PARAM...]

---

🎀 DESCRIPTION 🎀

So, here's the tea: the maketext script takes a natural language message and translates it into your language, by looking up the translation in a message MO file, and then it processes the plural transformation with Maketext. Lowkey iconic of it. 👑

The maketext script is basically a command-line interface to Locale::Maketext::Gettext(3) (and Locale::Maketext(3) too, obvi). You can drop it in shell scripts, whatever, to translate, maketext and return the result. Which means — and this is the part that slays — it lets Maketext get integrated into other programming languages/systems, like bash/csh, python, PHP, C, etc. It works like the command-line program gettext, fr fr.

For example, look at this:

% maketext -s "[*,_1,virus was,viruses were] found in [*,_2,file,files]." 0 1
0 viruses were found in 1 file.
% maketext -s "[*,_1,virus was,viruses were] found in [*,_2,file,files]." 1 3
1 virus was found in 3 files.
%

See how the plurals did their whole thing? 💅 Main character behavior.

---

✨ OPTIONS ✨

• -d, --domain=TEXTDOMAIN — go pull the translated messages from TEXTDOMAIN.
• -s — this one adds a new line to the end of the output so it behaves like the echo or the gettext command. Little glow-up for your newline needs. 🌈
• -h, --help — shows you the help messages.
• -V, --version — shows version info and then exits, periodt.
• MSGKEY — the original text used to look up the translated text.
• PARAM... — the parameters handed to Maketext for the plural and other text functions.

---

🦋 ENVIRONMENT 🦋

• TEXTDOMAIN — TEXTDOMAIN is what decides the text domain when you didn't pass the -d parameter. She'll cover for you. 💜
• TEXTDOMAINDIR — TEXTDOMAINDIR is used to search the message catalog/MO file if it doesn't live in the system locale directories.

---

👑 NOTES 👑

Maketext language function override, like quant or numerate, is not available here. Suggestions are welcome, bestie — slide into the inbox. 🙈

The current system locale directory search order is: /usr/share/locale, /usr/lib/locale, /usr/local/share/locale, /usr/local/lib/locale. Suggestions are welcome. (Yes, both times. They really do want your suggestions. 🫶)

---

💀 BUGS 💀

Report bugs to imacat <imacat@mail.imacat.idv.tw> — not me, I'm just the messenger 😭

---

🔥 SEE ALSO 🔥

Locale::Maketext(3), Locale::Maketext::TPJ13(3), Locale::Maketext::Gettext(3), Locale::Maketext::Gettext::Functions(3), bindtextdomain(3), textdomain(3). Also, please refer to the official GNU gettext manual at <https://www.gnu.org/software/gettext/manual/>. Go read, iykyk 📚💖

---

🌟 AUTHOR 🌟

imacat <imacat@mail.imacat.idv.tw>

---

🎀 COPYRIGHT 🎀

Copyright (c) 2003-2021 imacat. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's the whole page, bestie — you ate it all up 💅✨

This little masterpiece shipped with perl v5.36.0, dated 2022-10-15, and yes, it is a MAKETEXT(1p) situation, courtesy of the User Contributed Perl Documentation crew. 🎀 Go translate something iconic. 🦋