[pve-devel] [PATCH proxmox-i18n 2/2] po2js: add ngettext support

Maximiliano Sandoval m.sandoval at proxmox.com
Thu Jul 31 13:26:00 CEST 2025


We add new array for plural forms.

We use the msgid as the identifier translatable strings with a plural
form. This is the same as done for .mo files, from [1]:

> However, only the singular of the original string takes part in the
> hash table lookup.

We also obtain the plural forms and the number of plural forms directly
from the $LANG.po file, this requires the file to have a Plural-Forms
header that is valid, otherwise it would fail to evaluated by the
ngettext function when calling `Number($plural_forms)`.

Regarding the fallback to the original string, from [2]:

> The parameter n is used to determine the plural form. If no message
> catalog is found msgid1 is returned if n == 1, otherwise msgid2.

We default to the non-translated singular/plural depending on whether
n==1.

Regarding the default for $nplurals and $plural_forms: We select the
values for "Two forms, singular used for one only" from [2], this would
match with germanic and latin families.

This partially restores commit 2235ad7c7c79e29f09d3f3205ad86e862b5ac14c.

[1] https://www.gnu.org/software/gettext/manual/html_node/MO-Files.html
[2] https://www.gnu.org/software/gettext/manual/html_node/Plural-forms.html

Signed-off-by: Maximiliano Sandoval <m.sandoval at proxmox.com>
---
 po2js.pl | 52 +++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 45 insertions(+), 7 deletions(-)

diff --git a/po2js.pl b/po2js.pl
index c5268d7..d5a78a6 100755
--- a/po2js.pl
+++ b/po2js.pl
@@ -35,6 +35,10 @@ sub fnv31a {
 }
 
 my $catalog = {};
+my $plurals_catalog = {};
+
+my $nplurals = 2;
+my $plural_forms = "n!=1";
 
 foreach my $filename (@ARGV) {
     my $href = Locale::PO->load_file_ashash($filename)
@@ -49,6 +53,11 @@ foreach my $filename (@ARGV) {
         die "unable to get charset\n" if !$charset;
     }
 
+    if ($header =~ m|^Plural-Forms:\s+nplurals\s?=\s?([123456]);\s+plural=(.*);$|im) {
+	$nplurals = $1 + 0;
+	$plural_forms = $2;
+    }
+
     foreach my $k (keys %$href) {
         my $po = $href->{$k};
         next if $po->fuzzy(); # skip fuzzy entries
@@ -64,23 +73,37 @@ foreach my $filename (@ARGV) {
         my $qmsgid = decode($charset, $po->msgid);
         my $msgid = $po->dequote($qmsgid);
 
-        my $qmsgstr = decode($charset, $po->msgstr);
-        my $msgstr = $po->dequote($qmsgstr);
+        my $qmsgid_plural = decode($charset, $po->msgid_plural);
+        my $msgid_plural = $po->dequote($qmsgid_plural);
 
-        next if !length($msgid); # skip header
-
-        next if !length($msgstr); # skip untranslated entries
+        next if !length($msgid) && !length($msgid_plural); # skip header
 
         my $digest = fnv31a($msgid);
 
         die "duplicate digest" if $catalog->{$digest};
 
-        $catalog->{$digest} = [$msgstr];
-        # later, we can add plural forms to the array
+        if (defined($po->msgstr)) {
+            my $qmsgstr = decode($charset, $po->msgstr);
+            my $msgstr = $po->dequote($qmsgstr);
+
+            next if !length($msgstr); # skip untranslated entries
+            $catalog->{$digest} = [$msgstr];
+        }
+
+        if (defined(my $plurals = $po->msgstr_n)) {
+            for my $case (sort { $a <=> $b } keys $plurals->%*) {
+                my $qmsgstr_n = decode($charset, $plurals->{$case});
+                my $msgstr_n = $po->dequote($qmsgstr_n);
+
+                next if !length($msgstr_n); # skip untranslated entries
+                push $plurals_catalog->{$digest}->@*, $msgstr_n;
+            }
+        }
     }
 }
 
 my $json = to_json($catalog, { canonical => 1, utf8 => 1 });
+my $plurals_json = to_json($plurals_catalog, { canonical => 1, utf8 => 1 });
 
 my $version = $options->{v} // ("dev-build " . localtime());
 my $content = "// $version\n"; # write version to the beginning to better avoid stale cache
@@ -91,6 +114,7 @@ $content .= "// Proxmox Message Catalog: $outfile\n" if $outfile;
 
 $content .= <<__EOD;
 __proxmox_i18n_msgcat__ = $json;
+__proxmox_i18n_plurals_msgcat__ = $plurals_json;
 
 function fnv31a(text) {
     var len = text.length;
@@ -112,6 +136,20 @@ function gettext(buf) {
     }
     return data[0] || buf;
 }
+
+function ngettext(singular, plural, n) {
+    const msg_idx = Number($plural_forms);
+    const digest = fnv31a(singular);
+    const translation = __proxmox_i18n_plurals_msgcat__[digest];
+    if (!translation[msg_idx]) {
+        if (n === 1) {
+	    return singular;
+        } else {
+	    return plural;
+        }
+    }
+    return translation[msg_idx];
+}
 __EOD
 
 if ($outfile) {
-- 
2.47.2





More information about the pve-devel mailing list