diff --git a/Repositories/otago_eprints/otago_eprints/cfg/static/en/help/index.xpage b/Repositories/otago_eprints/otago_eprints/cfg/static/en/help/index.xpage index 45b4ce8..1e39444 100755 --- a/Repositories/otago_eprints/otago_eprints/cfg/static/en/help/index.xpage +++ b/Repositories/otago_eprints/otago_eprints/cfg/static/en/help/index.xpage @@ -35,9 +35,9 @@

Browsing

-

Browsing is a good way to access documents if you don't have a specific -idea of what you're looking for. There are two ways to browse the repository, -by subject and by year.

+

Browsing is a good way to access documents if you don't have a +specific idea of what you're looking for. There are several ways to +browse the repository, including by subject and by year.

To browse the repository either select Browse from the front page or from the navigation bar at the top of the screen. Then choose which property @@ -72,17 +72,17 @@

Match all, in any order.

In the example shown, the system will search for records in which any of the title, abstract or keywords fields contain both the word -``patient'' and ``care''.

+"patient" and "care".

Match any.

In the example shown, the system will search for any record with either -the term ``patient'' or ``care,'' in any of the title, abstract or +the term "patient" or "care," in any of the title, abstract or keywords fields.

Match as a phrase.

In this case, the system will search for your terms appearing exactly as you type them. In the example, the system will return any record with -the phrase ``patient care'' appearing in the title, abstract or +the phrase "patient care" appearing in the title, abstract or keywords.

@@ -94,7 +94,7 @@

In cases where each individual record may have more than one value attached to the list, you can also change search behaviour by selecting -``Any of these'' or ``All of these'' from the popup menu on the right of +"Any of these" or "All of these" from the popup menu on the right of the list.

@@ -123,7 +123,7 @@

Yes/No Fields

-

Some fields can have the value yes or no, for example the ``Refereed'' +

Some fields can have the value yes or no, for example the "Refereed" field. In this case, the search field lets you specify whether you want retrieved records to have the value yes or no for this field, or whether you have no preference, in which case the field isn't used to find @@ -153,12 +153,12 @@

The first thing you'll need to do, after registering, is fill out your user record using the form at &perl_url;/users/record. When -you click on ``Deposit Papers,'' you'll see an option saying ``View/change -your user record'': Select this option. The user record form is described +you click on "Deposit Papers," you'll see an option saying "View/change +your user record": Select this option. The user record form is described below.

-

Once you've correctly filled out your user record, the ``Deposit -Papers'' page will show a number of options and any any items you are working +

Once you've correctly filled out your user record, the "Deposit +Papers" page will show a number of options and any any items you are working on or have submitted but are not yet approved by an editor. The options are described below. Note that the options and information that appear may vary slightly, depending on whether you are in the process of depositing @@ -182,19 +182,19 @@

Note that you cannot change your e-mail address here. This is deliberate; if you inadvertently enter an incorrect e-mail address, the site will have no way of contacting you. Instructions for changing your -e-mail address can be found on the ``Registered Users Area''.

+e-mail address can be found on the "Registered Users Area".

Rather than clicking in each box before you enter something into it, you may find that your browser will let you use the tab key to move the cursor between the boxes. In this way you can enter the information much more quickly.

-

When you've entered the relevant information, click on the ``Update -Record'' button at the bottom of the form. If the form is filled out -correctly, you'll be taken back to the ``Deposit Papers'' page. If there's +

When you've entered the relevant information, click on the "Update +Record" button at the bottom of the form. If the form is filled out +correctly, you'll be taken back to the "Deposit Papers" page. If there's a problem with the form, the form will be presented to you again with a -description of what's wrong. Correct the error and click on ``Update -Record'' again.

+description of what's wrong. Correct the error and click on "Update +Record" again.

Your Workspace

@@ -204,8 +204,8 @@ workspace.

If your workspace is empty, which will be the case when you first visit -the page, you will see a button ``Click here to start uploading a -document.'' This button will add a fresh, empty record to your workspace +the page, you will see a button "Click here to start uploading a +document." This button will add a fresh, empty record to your workspace and allow you to start editing it.

If there are papers in your workspace, you will see a list of those @@ -252,15 +252,15 @@

The depositing process is divided into a number of stages. You can move -between these stages by using the ``Back'' and ``Next'' buttons at the +between these stages by using the "Back" and "Next" buttons at the bottom of each screen. This should be familiar to those accustomed to -using the ``wizard'' style of interface popular on many modern operating +using the "wizard" style of interface popular on many modern operating systems.

Don't worry about losing information you've entered when you press the -``Back'' button on a form: The system will store everything you've entered -when you press it. However, you should not use your browser's ``back'' +"Back" button on a form: The system will store everything you've entered +when you press it. However, you should not use your browser's "back" button when you are depositing papers.

@@ -270,13 +270,13 @@

Deposit Type

In this screen, you should select the one option on the list that best -described your paper, for example ``conference paper'' or ``journal paper -(paginated).'' The option you choose here will affect what bibliographic +described your paper, for example "conference paper" or "journal paper +(paginated)." The option you choose here will affect what bibliographic information about your deposit the system will collect in later stages.

-

Then click on the ``Next'' button.

+

Then click on the "Next" button.

Succession/Commentary

@@ -285,9 +285,9 @@ to move easily around those versions, commentaries and responses.

If the paper you are depositing is a later version of a paper you -previously deposited in the repository, enter its ID code into the ``Later -Version Of'' box. If you used the ``Clone'' option on the ``Review -Documents'' page, then this box will have already been filled out for you, +previously deposited in the repository, enter its ID code into the "Later +Version Of" box. If you used the "Clone" option on the "Review +Documents" page, then this box will have already been filled out for you, but can be overwritten.

To find the ID of a document, use the repository's Search feature to find @@ -296,18 +296,18 @@ to this form.

If you are depositing a commentary on a paper in the repository, enter its -ID code in the ``Commentary On'' box. If you are responding to a +ID code in the "Commentary On" box. If you are responding to a commentary, enter the ID code of the commentary you are responding to in this box.

You can make sure that you've entered the correct ID codes by clicking -on the ``Verify IDs'' button at the bottom of the page. The system will +on the "Verify IDs" button at the bottom of the page. The system will then show you what papers the ID codes pertain to, so you can make sure you've entered the right codes. Note that the system will not let you proceed with the deposit if either ID code you enter is invalid.

You can of course leave either box empty if your paper is not a later -version of another, a commentary or a response. Click on the ``Next'' +version of another, a commentary or a response. Click on the "Next" button when you're sure the information you've entered is correct.

Note that you cannot deposit a later version of a paper that has been @@ -356,16 +356,16 @@

You can enter title, given name, family name and lineage. Title and lineage can be ignored if you wish. Sometimes you can enter a list of names. In these cases, you can add more boxes for names by clicking on the -``More Spaces'' button on the right. Note that empty boxes are +"More Spaces" button on the right. Note that empty boxes are ignored.

To remove names from a list just remove the name from the relevant boxes and leave it empty. Don't worry about leaving a blank box in the -middle of the list; the system will ``bunch up'' the list.

+middle of the list; the system will "bunch up" the list.

-

Once you've entered the relevant information, click on the ``Next'' +

Once you've entered the relevant information, click on the "Next" button. If there are any omissions from the data, the system will explain what is wrong and re-present the form so you can fix the problems.

@@ -374,7 +374,16 @@ to move between the input fields, allowing you to enter the information quickly.

-

Subject Categories

+

Addiliations and Subject Categories

+ +

In the affiliations stage, you should select the organisational +unit(s) within the University that your paper is associated. For +example, if your paper was published in a departmental working papers +series, you would add both your department and the working paper series +as affiliations. If the paper was associated with a particular research +group, you would add this as well. Add all the affiliations that are +appropriate to your submission to ensure that it appears in the +corresponding browse pages.

In the subject categories stage, you should select the subject or subjects from the list that best represent the content of your @@ -389,7 +398,7 @@ box is there purely for you to suggest categories you really believe are serious omissions.

-

Once you've selected your subject categories, click on the ``Next'' +

Once you've selected your subject categories, click on the "Next" button.

Document Storage Formats

@@ -401,26 +410,26 @@

If you want to upload some files for a format, or remove some files you've already uploaded for a format, click on the relevant -``Upload/Edit'' button. When you do this, you'll be presented with the -``Document file upload'' screen described in the next section.

+"Upload/Edit" button. When you do this, you'll be presented with the +"Document file upload" screen described in the next section.

To remove all of the files for a format completely, click on the -relevant ``Remove'' button.

+relevant "Remove" button.

Note that you must upload files for at least one of the formats shown in bold type.

-

The ``Other'' format allows you to upload the document in any other +

The "Other" format allows you to upload the document in any other format you think may be useful. For example, you may wish to upload a Microsoft Word document.

When you're happy that you've uploaded all of the document files, click -on the ``Finished'' button. Later, you'll have a chance to make sure that +on the "Finished" button. Later, you'll have a chance to make sure that the uploads have all worked, and to come back and fix anything that's amiss.

-

Once you've clicked the ``finished'' button on this page, you'll be -taken to the ``Deposit Verification'' page described in a later +

Once you've clicked the "finished" button on this page, you'll be +taken to the "Deposit Verification" page described in a later section.

Document File Upload

@@ -429,46 +438,46 @@ presented with an upload menu from here you can select how you'd like to upload files to the repository.

-

Plain files.

+

Plain files

Choose this option if you want to upload files you have on your computer as-is. For example, if you have a PDF file on your hard disk, you would choose this option. If you have to upload more than one file using this method (for instance, an HTML file and a corresponding .gif figure image file,) then type the number of files you wish to upload into the -``Number of files to upload'' box. From an existing Web site. +"Number of files to upload" box. From an existing Web site.

If your paper is up on the Web already, this option will let you specify the URL of that paper. The repository software will copy your paper from that Web site. You should be careful with this option, though; and -read the ``uploading from an existing Web site'' section below. +read the "uploading from an existing Web site" section below. As a ZIP archive/Compressed TAR archive.

Your paper may be stored in several separate files. This is often the case if your paper is stored in HTML format and contains figures. These two options let you use the ZIP tool (available on all operating -systems) or the ``tar'' and ``compress'' tools (commonly used on UNIX +systems) or the "tar" and "compress" tools (commonly used on UNIX systems) to collect all of those files into one compacted file. -Now click on the ``Upload'' button. +Now click on the "Upload" button.

-

If you selected ``plain files'' or are uploading a compressed file, you +

If you selected "plain files" or are uploading a compressed file, you will be presented with a screen where you can either type in the full filename and path of the document file or compressed file into the text -field, or (recommended) click on the ``Browse...'' button, and select the +field, or (recommended) click on the "Browse..." button, and select the relevant file using the file selector1. If you're uploading more than one file, there will be a corresponding number of these fields to fill out.

-

If you selected ``from an existing Web site,'' enter the full URL of +

If you selected "from an existing Web site," enter the full URL of the first page of the actual document; don't just enter the URL of the Web site the document appears in or the URL of an index or contents page. See -the section ``uploading from an existing Web site'' below.

+the section "uploading from an existing Web site" below.

-

When you've entered the filenames or URLs, click on the ``Upload'' -button. You'll then be taken back to the ``Document File Upload'' +

When you've entered the filenames or URLs, click on the "Upload" +button. You'll then be taken back to the "Document File Upload" screen.

At least one file needs to be shown first. In many cases (e.g. PDF, @@ -477,17 +486,17 @@ file in the document that a reader should be presented with; the .html file if your document is in HTML format, or the contents page if your document is spread over several uploaded several HTML documents. Use the -``Show First'' button to tell the system which file should be shown +"Show First" button to tell the system which file should be shown first.

-

The ``Delete'' buttons on the right of the table can be used to remove -individual files that you've uploaded in error. ``Delete all files'' will +

The "Delete" buttons on the right of the table can be used to remove +individual files that you've uploaded in error. "Delete all files" will wipe the slate clean (for this document storage format only) so you can start again.

You can continue to upload more files as before. If you've uploaded all -necessary files, click on ``Finished''. This will take you back to the -``Document Storage Format'' page.

+necessary files, click on "Finished". This will take you back to the +"Document Storage Format" page.

Uploading From an Existing Web Site

@@ -512,7 +521,7 @@ Wide Web by following every single link, some rules are applied when the system collects your document:

-

Only files reached by ``relative'' links are retrieved. For example, if +

Only files reached by "relative" links are retrieved. For example, if the HTML contains a link to node1.html then node1.html will be copied. If the link points to http://somewebsite.edu/bar.html, then that URL will not be copied.

@@ -525,8 +534,8 @@ rate. However we have been using it here at Southampton for a number of months and it usually works very well.

-

If something does go wrong, it's normally best to select ``delete all -files'' from the ``Document File Upload'' screen, and try another +

If something does go wrong, it's normally best to select "delete all +files" from the "Document File Upload" screen, and try another uploading method.

Deposit Verification

@@ -534,19 +543,19 @@

This page will display the abstract page for your document as it will appear in the repository. You should carefully check that all information has been uploaded correctly. Note that your paper will not appear in the -``available versions'' or ``commentary/response'' lists at the bottom of +"available versions" or "commentary/response" lists at the bottom of the page; this is normal.

You should also check that the document files have been uploaded correctly, including any associated figures and links. If you spot a -mistake, you can use forms' ``back'' buttons (not the browser's ``back'' +mistake, you can use forms' "back" buttons (not the browser's "back" button) to cycle back through the depositing process and fix any mistakes.

If you're satisfied that everything is correct and has been uploaded correctly, and have read, understood and complied with the agreement at -the bottom of the page, click on the ``Deposit'' button to deposit your +the bottom of the page, click on the "Deposit" button to deposit your paper in the repository. It will then be put in the editorial buffer.