Changeset 4873 for trunk/gsdl/perllib/plugins/PSPlug.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/PSPlug.pm (modified) (2 diffs)

trunk/gsdl/perllib/plugins/PSPlug.pm

@@ -37 +37 @@
 my $arguments =
     [ { 'name' => "process_exp",
-    'desc' => "A perl regular expression to match against filenames. Matching filenames will be processed by this plugin. For example, using '(?i).html?\$' matches all documents ending in .htm or .html (case-insensitive).",
+    'desc' => "{BasPlug.process_exp}",
     'type' => "string",
     'deft' => &get_default_process_exp(),
     'reqd' => "no" },
       { 'name' => "block_exp",
-    'desc' => "Files matching this regular expression will be blocked from being passed to any later plugins in the list. This has no real effect other than to prevent lots of warning messages about input files you don't care about. Each plugin might have a default block_exp. e.g. by default HTMLPlug blocks any files with .gif, .jpg, .jpeg, .png or .css file extensions.",
+    'desc' => "{BasPlug.block_exp}",
     'type' => 'string',
     'deft' => &get_default_block_exp() },
       { 'name' => "extract_date",
-    'desc' => "Extract date from PS header.",
+    'desc' => "{PSPlug.extract_date}",
     'type' => "flag" },
       { 'name' => "extract_pages",
-    'desc' => "Extract pages from PS header.",
+    'desc' => "{PSPlug.extract_pages}",
     'type' => "flag" },
       { 'name' => "extract_title",
-    'desc' => "Extract title from PS header.",
+    'desc' => "{PSPlug.extract_title}",
     'type' => "flag" } ];
 
 my $options = { 'name'     => "PSPlug",
-        'desc'     => "This might look VERY similar to the PDF plugin.",
+        'desc'     => "This is a \"poor man's\" ps to text converter. If you are serious, consider using the PRESCRIPT package, which is available for download at http://www.nzdl.org/html/software.html",
         'inherits' => "yes",
         'args'     => $arguments };
@@ -77 +77 @@
              "allow_extra_options")) {
     print STDERR "\nIncorrect options passed to HTMLPlug, check your collect.cfg configuration file\n";
-    $self->print_txt_usage();
+    $self->print_txt_usage("");  # Use default resource bundle
     die "\n";
     }