[OAI-implementers] Multilingualising OAI/eprints.org documentation and software

[Stevan Harnad]

  This message is in MIME format.  The first part should be readable text,
  while the remaining parts are likely unreadable without MIME-aware tools.
  Send mail to mime@docserver.cac.washington.edu for more info.

--a8Wt8u1KmwUX3Y2C
Content-Type: TEXT/PLAIN; CHARSET=iso-8859-1
Content-Transfer-Encoding: QUOTED-PRINTABLE
Content-ID: <Pine.SGI.3.95.1010209164515.13083c@cogito.ecs.soton.ac.uk>


---------- Forwarded message ----------
Date: Fri, 9 Feb 2001 16:24:47 +0000
From: ePrints Support (Christopher Gutteridge) <support@eprints.org>
Subject: Multiple language Support for Eprints.

eprints.org is beginning to gain some multi-language functionality.

I plan to have "language" files with all the phrases used by eprints in
them. I will maintain an English version, and arrange to make it as
easy as possible to create/maintain other languages - hopefully a
script to compare any language file with the english file and spot any
missing phrases etc.

It's time-consuming applying this change, but also easy. It will take a
while to get the whole code done.

The advantage of this method is that although each eprint.org archive
will have a default language, a user could view the CGI scripts in any
language supported, using cookies or something!

I'm currently considering how to make the static pages support multiple
languages... I'm considering mod_rewrite using the same cookie. I think
static pages are a slightly different issue from the main code, as
people will want to customise those, and customising in more than one
language will be more than most people, especially anglocentric ones,
will want to do.

The other issue is the "help" in the metadata cfg section and various
blocks of english text in the site routines.=20

Some of SiteInfo.pm may go from:

$EPrintsSite::SiteInfo::blurb =3D "This is some blurb only in english";

to

$EPrintsSite::SiteInfo::blurb{english} =3D "This is some blurb only in engl=
ish";

With the option to add any language you support; how does this sound?

My main concern is not making any significant extra work to deploy
eprints.org for people who DON'T care about this issue.

Please see the attached file for an example of a language file - this
is only somewhere between 1/8 and 1/4 of the final length I'm
expecting.

I'd be keen for some of you to at least have a go at translating some
of this so I've got some french (and other language) text to work with
(I'm afraid I am a monoglot). Also let me know if there is anything
good/bad about the way that I've organised it.

The file is organised by the file which uses the phrase. Eg. User.pm
Each line has a ID for the phrase eg:

H:thanks =3D Thank-you. Your paper named $(1) is now in the system.

"H" indicates that this will be displayed as HTML so &aacute; etc are
acceptable. Other types, "M" for example, will need different escaping
of such characters, or they may be altogether illegal.

Rather than split a sentence into two phrases, the system inserts data
into the points at $(1) $(2) etc...

Christopher Gutteridge=20
ePrints Technical Support
support@eprints.org

------------------------------------

# English Language Phrases

# First letter donates use:
#
# H =3D HTML
# A =3D ASCII
# L =3D Log
# S =3D Mail Subject (or From) Line
# M =3D Mail Message
# F =3D HTML Form (Some characters maybe illegal! Don't use &eacute; escapi=
ng)=20

<file SearchExpression.pm>
H:leastone =3D You need to specify something for at least one field!
F:any =3D any
F:all =3D all
H:mustfulfill =3D Retrieved records must fulfill $(1) of these conditions.
H:orderresults =3D Order the results: $(1)
</file>

<file update_ecs_users>
A:dude =3D Internationalisation Rocks.
</file>

<file Citation.pm>
H:unknowneprint =3D Unknown EPrint field $(1) in "$(2)"
H:na =3D N/A
</file>

<file UserForm.pm>
H:dontknow =09=3D I don't know who you are
H:recfor =09=3D Record for $(1)
H:blurb =09=3D Please enter correct information about yourself for our reco=
rds. This information will be useful to us and readers of your papers. You =
don't have to supply all this information if you don't want to; you need on=
ly fill out those fields marked wi
th a * to start using the archive.
H:changeemail =09=3D For instructions on how to change your e-mail address,=
 $(1).
H:clickhere =09=3D click here
H:formincorrect =3D The form doesn't seem to be filled out correctly:
H:completeform =09=3D Please complete the form before continuing.
H:problemupdating =3D There was a problem reading the posted data and updat=
ing the database. Please try again later
H:usernotmatch =09=3D Username in form $(1) doesn't match object username $=
(2)
</file>

<file User.pm>
H:missedfield =3D You haven't filled out the required $(1) field.
S:weclome =3D Welcome to $(1)!
M:reminder =3D Dear $(1) User,\n\n$(2)Your username and password for the si=
te are:\n\nUser name: $(3)\nPassword:  $(4)\n\nIf you didn't expect this e-=
mail, please contact the site\nadministrator at:\n\n$(5)\n
S:remindersub =3D Your username and password
S:newuser =3D New $(1) User
S:newstaff =3D New $(1) Staff
</file>

<file Subscription.pm>
H:sendupdates =3D Send updates: $(1)
M:weekly =3D weekly
M:daily =3D daily
M:monthly =3D monthly
L:notopenrec =3D Couldn't open user record for user $(1) (sub ID $(2))
M:blurb =3D This mail contains your $(1) subscription to $(2).\n\nTo cancel=
, temporarily disable or alter your subscription,\nvisit the following Web =
page:\n\n $(3)\n\n
M:newsub =3D One new submission was received.
M:newsubs =3D $(1) new submissions were received.
S:subsubj =3D Subscription
L:failsend =3D Failed to send subscription to user $(1): $(2)
</file>

<file SubmissionForm.pm>
L:dberr =09=3D Database Error: $(1)
H:useautharea=09=3D Use your author area to deposit new documents
L:errclone=09=3D Error cloning EPrint $(1): $(2)
H:uploadprob=09=3D There was a problem uploading your file(s). Please try a=
gain.
L:removeerror=09=3D DB Error removing EPrint $(1): $(2)
H:seltype=09=3D Please select the most appropriate type for your deposit.
H:bibinfo=09=3D Please enter the bibliographic data about your deposit. Fie=
lds marked with a * are fields that must be filled out before your deposit =
will be accepted.
H:verify=09=3D Verify:
H:invaleprint=09=3D ID $(1) is not a valid EPrint ID!
H:validformats=09=3D Here are the available upload formats, and how many fi=
les you have uploaded for each.
H:leastone=09=3D You must upload at least one of the formats listed in bold=
=2E
F:plain=09=09=3D Plain Files
F:graburl=09=3D From an Existing Web Site
H:fixupload=09=3D The document upload can't be completed because:
H:pleasefix=09=3D Please fix this before continuing.
H:nofiles=09=3D No files have been uploaded for this format.
H:heretoview=09=3D Click here to view and verify the uploaded files
H:selfirst=09=3D You need to select the file that should be shown first whe=
n a reader wishes to view your deposit.
H:filesforformat=3D These are the files you have uploaded for this format.
H:fileupmethod=09=3D File upload method:
H:plainonly=09=3D (Plain files only)
H:numfiles=09=3D Number of files to upload:
H:enterurl=09=3D Please enter the URL of the document you wish to upload to=
 the archive in the box below.
H:urlwarning=09=3D Occasionally, uploading this way may not produce a total=
ly accurate copy. This is because some assumptions about the structure of t=
he HTML must be made, to stop the software from trying to upload the whole =
World-Wide Web!
H:entercompfile =3D Enter the filename (with full path) of the compressed f=
ile in the box below.
H:enterfile=09=3D Please enter the filename (with full path) of the documen=
t file in the box below.
H:enterfiles=09=3D Please enter the filenames (with full paths) of the docu=
ment files in the boxes below.
H:fixprobs=09=3D Before you deposit this entry to the archive, the followin=
g problems need to be corrected:
H:pleaseverify=09=3D Please verify that all of the details about your depos=
it are correct, and that all necessary document files have been correctly u=
ploaded including any figures. =20
H:thanks=09=3D Thank you.
H:inbuffer=09=3D Your document is now held in the deposit buffer. Provided =
there are no problems it should appear in the main archive within the next =
few days.
H:retdeppage=09=3D Click here to return to your deposit papers page=20
H:suredelete=09=3D Are you absolutely sure you want to delete this entry?
H:filledwrong=09=3D The form doesn't seem to be filled out correctly:
H:pleasecomplete=3D Please complete the form before continuing.
L:idnotmatch=09=3D EPrint ID in form >$(1)< doesn't match object id $(2)
H:filename=09=3D Filename
H:sizebytes=09=3D Size (Bytes)
H:shownfirst=09=3D Shown First
F:showfirst=09=3D Show first
F:action_new    =3D Nouvou
F:action_delete =3D Delete
F:action_edit   =3D Edit
F:action_next   =3D N=E9xt >
F:action_prev   =3D < Back
F:action_submit =3D Deposit
F:action_cancel =3D Cancel
F:action_confirm=3D Confirm
F:action_clone  =3D Clone
F:action_uploadedit =3D Upload/Edit >
F:action_finished   =3D Finished
F:action_upload =3D Upload >
F:action_verify =3D Verify ID's
H:title_type       =3D Deposit Type
H:title_meta       =3D Bibliographic Information
H:title_subject    =3D Subject Categories
H:title_linking    =3D Succession/Commentary
H:title_format     =3D Document Storage Formats
H:title_fileview   =3D Document File Upload
H:title_upload     =3D Document File Upload
H:title_verify     =3D Deposit Verification
H:title_done       =3D Completed Deposit
H:title_error      =3D Error
H:title_return     =3D Return to Author's Home
H:title_confirmdel =3D Confirm Deletion
H:corrupt_err=09=3D An inconsistency in the posted data was detected. Usual=
ly this is caused by arriving directly to this page from a bookmark and not=
 from your paper depositing page, or through using the browser's back/forwa=
rds or reload buttons. Always acce
ss the depositing mechanism via your author area and use the buttons on the=
 form.</P><P>If this has happened in the normal course of operation please =
tell the $(1).
H:database_err =09=3D There's been a problem accessing the site database. P=
lease try again later, and contact the $(1) if the problem persists.
H:siteadmin=09=3D site administrator=20
H:nosel_err=09=3D You hadn't selected a paper to edit, clone, delete or dep=
osit!
F:delete=09=3D Delete
F:delete_all=09=3D Delete All Files
H:format=09=3D Format
H:files_uploaded=3D Files Uploaded
F:uploadedit=09=3D Upload/Edit
F:remove=09=3D Remove
</file>


--a8Wt8u1KmwUX3Y2C--