Changeset 4873 for trunk/gsdl/perllib/plugins/MARCPlug.pm

Timestamp:

2003-07-03T15:59:04+12:00 (21 years ago)

Author:

mdewsnip

Message:

Further work on standardising option descriptions. Specifically, in preparation for translating the option descriptions into other languages, all the option description strings have been moved in a "resource bundle" file (modelled on a Java resource bundle). (This also has the advantage of reducing the number of duplicate descriptions). The option descriptions in the plugins, classifiers, mkcol.pl, import.pl and buildcol.pl have been replaced with keys into this resource bundle (perllib/strings.rb). When translating the strings in this file into a new language, the new resource bundle should be named strings_<language-code>.rb (where <language-code> is a combination of language and country, eg. 'fr_FR' for the version of French spoken in France).

To support these changes, the PrintUsage module (perllib/printusage.pm) has new code for reading resource bundles and displaying the correct strings. Also, pluginfo.pl, classinfo.pl, mkcol.pl, import.pl and buildcol.pl have a new option (-language) for specifying the language code to display option descriptions in.

If a resource bundle for the specified language code does not exist, a generic resource bundle is used (strings.rb). This currently contains the English text descriptions. However, for users who always use Greenstone in another language, it would be easier to rename the standard file to strings_en_US.rb and rename the resource bundle of their desired language to strings.rb. This would mean they would not have to constantly specify their language with the -language option, since the default resource bundle will suit them.

Currently, the encoding names (in encodings.pm) are not part of this scheme. These are displayed as part of BasPlug's input_encoding option. It is debatable whether these names would be worth translating into other languages.

Parse errors in plugins and classifiers currently cause them to display the usage information using the default resource bundle. It is likely that BasPlug will soon have an option added to specify the language for the usage information in this case. (Note that this does not include using pluginfo.pl or classinfo.pl to display usage information - these have a -language option).

File:

• trunk/gsdl/perllib/plugins/MARCPlug.pm (modified) (3 diffs)

trunk/gsdl/perllib/plugins/MARCPlug.pm

@@ -40 +40 @@
 my $arguments = 
     [ { 'name' => "metadata_mapping",
-    'desc' => "Name of file that includes mapping details from MARC values to Greenstone metadata names. Defaults to 'marctodc.txt' found in the site's etc directory.",
+    'desc' => "{MARCPlug.metadata_mapping}",
     'type' => "string",
     'deft' => "marctodc.txt",
@@ -46 +46 @@
 
 my $options = { 'name'     => "MARCPlug",
-        'desc'     => "",
+        'desc'     => "Basic MARC plugin.",
         'inherits' => "Yes",
         'args'     => $arguments };
@@ -73 +73 @@
 
     print STDERR "\nIncorrect options passed to MARCPlug, check your collect.cfg configuration file\n";
-    $self->print_txt_usage();
+    $self->print_txt_usage("");  # Use default resource bundle
     die "\n";
     }