User Tools

Site Tools


i18n:problem_children

Internationalization challenges

See the i18n tag on Launchpad for open bugs related to internationalization and localization.

Unfriendly Forms

A few forms are designed as "fill in the blank" English sentences, which won't translate well.

See #1178557 Short translatable strings need context

MARC editor suggestions

There is a giant file of field labels for the MARC editor that has been generated from the Library of Congress electronic MARC21 documentation. Where translated versions of the MARC21 standard are available, we will have to create scripts to parse and build the equivalent translations. Depending on the license of the translated work, the translations may not be able to be distributed as part of Evergreen and may have to be built by each Evergreen site instead (unless an Evergreen vendor negotiates a redistribution license with the copyright owner):

Hard-coded locales in application code

Need to check for and correct code like the following in Open-ILS/src/perlmods/OpenILS/WWW/SuperCat.pm:

	if ($format eq 'opac') {
		print "Location: $root/../../en-US/skin/default/xml/rresult.xml?m=$id\n\n"
			if ($type eq 'metarecord');
		print "Location: $root/../../en-US/skin/default/xml/rdetail.xml?r=$id\n\n"
			if ($type eq 'record');
		return 302;
 
	}

Something like the following may work:

find Open-ILS/src -exec grep -H "en-US" {} \;

[ We need to teach Apache to pass the locale to mod_perl handlers (maybe it can already? %ENV is fine) and move supercat under /opac/{locale}/extras. Then a simple global replace. :) – miker ]

Calendar widgets

Logic relying on parsing English text

From Open-ILS/xul/server/circ/checkout.js:

	'check_date' : function(node) {
		JSAN.use('util.date');
		try {
			if (node.value == 'Normal') return true;
			var pattern = node.value.match(/Today \+ (\d+) days/);
			if (pattern) {
				var today = new Date();
				var todayPlus = new Date(); todayPlus.setTime( today.getTime() + 24*60*60*1000*pattern[1] );
				node.value = util.date.formatted_date(todayPlus,"%F");
			}
			if (! util.date.check('YYYY-MM-DD',node.value) ) { throw('Invalid Date'); }
			if (util.date.check_past('YYYY-MM-DD',node.value) ) { throw('Due date needs to be after today.'); }
			if ( util.date.formatted_date(new Date(),'%F') == node.value) { throw('Due date needs to be after today.'); }
			return true;
		} catch(E) {
			throw(E);
		}
	},

The problem here is that we're running a regex against an English string. A couple of approaches to solving this problem:

  • One regex per locale (brittle, perhaps, and requires regex knowledge that the average translator probably won't have)
  • Create a parallel hidden node that contains the English string and parse that instead, while the localized version is displayed (a bit tricky, but doesn't change the fundamental logic being used)
  • Set the value as an attribute of the node and parse that instead (possibly using a simple math notation like +30).

Hardcoded strings in Perl modules

OpenILS::WWW::SuperCat contains hardcoded strings and locales for the slimcat and extras (bookbags, etc). For example:

sub bookbag_feed {
...
	if ($type eq 'opac') {
		print "Location: $root/../../en-US/skin/default/xml/rresult.xml?rt=list&" .
			join('&', map { "rl=" . $_->target_biblio_record_entry } @{ $bucket->items }) .
			"\n\n";
		return 302;
	}
...
	$feed->title("Items in Book Bag [".$bucket->name."]");
...
	$feed->link(
		OPAC =>
		'/opac/en-US/skin/default/xml/rresult.xml?rt=list&' .
			join('&', map { 'rl=' . $_->target_biblio_record_entry } @{$bucket->items} ),
		'text/html'
	);
}

Org Unit shortnames

Some code invokes the .shortname() method of an actor_org_unit object to get a short code that uniquely identifies a particular org unit and uses that for display purposes. We should audit these sections of code to find out where the shortname is being displayed directly to the user and try to replace it with the full name, where possible (keeping the shortname hidden for invoking methods if necessary). For example, in Open-ILS/xul/server/circ/util.js:

'render' : function(my) {
    if (my.circ) {
        return data.hash.aou[ my.circ.circ_lib() ].shortname();
    } else {
        if (my.acp.circulations()) {
            return data.hash.aou[ my.acp.circulations()[0].circ_lib() ].shortname();
        } else {
            return "";
        }
    }
i18n/problem_children.txt · Last modified: 2025/08/02 18:08 by sleary

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.