################################################### # # This file is part of Shutter. # # Shutter is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 3 of the License, or # (at your option) any later version. # # Shutter is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with Shutter; if not, write to the Free Software # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA # ################################################### package Shutter::I18N; # Translation helpers. Replaces passing a Locale::gettext object ($d) # around: modules import __() and __n() and call them directly. # # use Shutter::I18N qw(__ __n); # my $label = __('Preferences'); # my $msg = sprintf __n('%d file', '%d files', $count), $count; # # There is one gettext domain per process. Shutter::App::Common's # gettext_object (the legacy $d) is this same object, so old and new code # always agree on the domain and locale directory. use v5.36; use Exporter qw(import); use Locale::gettext (); our @EXPORT_OK = qw(__ __n); my $text_domain = 'shutter'; my $domain; # Bind the domain to a locale directory (share/locale). Call once at # startup; returns the Locale::gettext object. sub init ($localedir) { $domain = Locale::gettext->domain($text_domain); $domain->dir($localedir); return $domain; } # The shared Locale::gettext object. Before init() it uses the system # default locale directory, so code that runs early or in tests still # gets the original strings back. sub domain () { $domain //= Locale::gettext->domain($text_domain); return $domain; } sub __ ($msgid) { return domain()->get($msgid); } sub __n ($singular, $plural, $count) { return domain()->nget($singular, $plural, $count); } 1;