Locale...uConfig(3pm)

🌸 NAME 🌸

Locale::Maketext::Lexicon::CatmanduConfig — bestie, this is the little module that lets you use your Catmandu config files as a Maketext lexicon. Like, your translation strings live in your Catmandu config and Maketext just... reads them. Iconic behaviour, honestly. 💅

Oh and btw, the manual page header calls this whole thing Locale...uConfig(3pm) and it lives in the User Contributed Perl Documentation collection. That's just where it's filed, the module name up top is the real one. ✨

✨ SYNOPSIS ✨

Okay so here's the whole vibe in two chunks. First you set up your locale data inside your Catmandu config:

Catmandu->{config}->{locale} = {
    en => {
        hello => "Hello"
    },
    _style => "gettext"
};

Then you make your very own i18n package and tell Locale::Maketext::Lexicon to go grab it from that config. Main character energy:

package MyI18N;
use parent 'Locale::Maketext';
use Locale::Maketext::Lexicon {
    en => [ CatmanduConfig => ["locale.en"] ],
    _style => "gettext"
};

That's it. That's the whole thing. Slay. 💖

🎀 NOTES 🎀

• the value for CatmanduConfig is an array — and this is NOT a typo, okay? It's an array on purpose, because Locale::Maketext::Lexicon looks at plain regular strings and assumes they're files (which it then ignores). So if you hand it a bare string you're gonna get nothing and be sad. Wrap it in an arrayref. Trust. 🫶
• the config parameter _style can be set to "gettext" if you want to make use of placeholders, exactly like in Locale::Maketext::Lexicon::Gettext. Placeholders, bestie!! We love a lil dynamic string moment. 🔥

💀 Real talk: get the array thing wrong and you'll be debugging for an hour wondering why your translations are just... not there. Not me doing that. Definitely not me. 🙈

Anyway — that's the page! This manual came to you courtesy of perl v5.36.0, dated 2023-02-04, filed under Locale...uConfig(3pm) in the User Contributed Perl Documentation. Go forth and localise, queen. 👑🌈⭐