ACMAC's PrePrint Repository User Documentation

In this page are presented the most important information for the usage of the repository by an end user. Although this is far from being the entire EPrints manual it contains these parts that will get you through and which can be summarized to the following:

If you think that these are not enough or you would like to dig deeper an excellent place to start is the repository Training and Tutorial Materials. Furthermore, all the latest documentation can be found on the EPrints wiki.

Browsing

Browsing is a good way to access documents if you don't have a specific idea of what you're looking for. So far it is available to browse by year only.

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 you wish to browse by eg. "year".

You will be presented with a list of possible values, select one of these, and you will be given a list of references to documents in the repository (if any) which match this value. To access a paper, simply click on its reference in the display.

On the abstract page, you should be able to see a brief overview of the document.

Searching

The repository offers two levels of searching, simple and advanced. They are similar, but the advanced form lets you perform a finer-grained search using more fields. Access the simple search using the Search the Repository link on the front page, or using the navigation bar at the top of the screen. To perform an advanced search, use the advanced search link at the top of the simple search page.

Text Search Fields

These are used to search fields like abstract or author. These are the fields where there is a text entry area, and a popup menu just to the right of it. Type your search terms into the box. You can decide how the system will use your search terms by selecting one of the options from the popup menu just to the right of the input box.

Match all, in any order.

The system will search for records in any field containing all terms.

Match any.

The system will search for any record with either terms in any of the fields.

Match as a phrase.

In this case, the system will search for your terms appearing exactly as you type them.

Lists of Values

With these you can select one or more values from a list of values for the system to search for. If no value in the list is selected, the system will ignore this field (i.e. it will retrieve records with any value of this field.)

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 the list.

Any of these.

If this is selected, any record which has any of the values you select will be retrieved.

All of these.

If you select this option, a record must have all the values you choose associated with it to be retrieved.

Years

When you're searching a year field, you can specify a single year or range of years that you're interested in:

1999
retrieves only records where the year is "1999";
1987-1990
retrieves records with years between 1987 and 1990 inclusive;
1995-
retrieves records with years of 1995 or later;
-1998
retrieves records with years up to and including 1998.

Yes/No Fields

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 records.

Registering

Certain services require you to register with the system so that it can identify you, such as the document depositing services. When you register with the system, you can register a username, email address and password which must be confirmed. The system will email you a confirmation URL to visit to enable the password.

Before you can start uploading items, you need to fill out some personal details into your profile form. This same form is used to change user details once registered.

Depositing Records

The first thing you'll need to do, after registering, is fill out your user record using the profile form.

Once you've correctly filled out your user record, the, "Manage Deposits" page will show a number of options and 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 any papers and whether you have any papers pending entry into the main repository.

Your Profile

Your profile is used to hold contact information about you. Some of this information will be associated with eprints you upload; some of it is purely for internal repository use. General information like your name, URL, address and e-mail address are public, so it's inadvisable to put down a home address. (Usually a postal address isn't required.)

Enter the relevant information in the form. Those boxes where the field name (on the left of the box) has an asterisk are required fields that you must fill out before you can deposit papers in to the repository.

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 "Save and Return" button . If the form is filled out correctly, you'll be taken back to the profile 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 "Save and Return" again.

Your Workspace

If you start uploading a paper, you can decide that you wish to wait until later before completing the upload, and you can start on another paper. Papers that you are in the process of uploading are in your workspace.

If your workspace is empty, which will be the case when you first visit the page, you will see a button "New Item". 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 papers with some option buttons. The title of each paper you are uploading will be shown in the list, or its ID if you haven't yet given it a title. The option buttons are described below:

Remove Item

If you select a paper and click on this button, that paper will be removed from your workspace and discarded completely. You will be asked for confirmation first, so don't worry about accidentally clicking on it. Clones of any paper you delete are unaffected.

Edit

If you select a paper in your workspace and click this button, you will be able to carry on depositing that paper.

Deposit

If you're satisfied that you've completed uploading the paper and associated information as you had intended, then you can select the paper and click on this button to deposit the paper in the repository. Note that if there are problems with the paper (for instance, if a document file upload hasn't worked, or the associated bibliographic information is invalid), you will be told what is wrong, and you won't be able to deposit the paper until those problems are fixed.

The depositing process is described in a following section.

New Item

This button creates a fresh record and starts the depositing process.

The Depositing Process

Please DO NOT start unless you have prepared everything that is required as described in the Deposit Guide in order to avoid the insertion of empty entries in the database.

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 bottom of each screen. This should be familiar to those accustomed to 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" button when you are depositing papers.

Each stage of the process is described in the following sections. To start with just press "New Item" and the sytem will provide you automatically an "Article #ID" which will appear on top of the screen (e.g. "Article #32").

This ID is important because before proceeding to the second step where you will be asked to upload your PDF document you have to make sure that the PDF file name follows the format "acmac-xxxx.pdf", where "xxxx" is the "ID" number (if the "ID" number has less than four digits then please add leading zeros in order to have a four digit number e.g. "acmac-0032.pdf").

Item 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 information about your deposit the system will collect in later stages. The only available option yet is the "Article".

Then click on the "Next" button.

Document File Upload

If there are no files uploaded in a particular format, you will be presented with an upload menu from here you can select how you'd like to upload files to the repository.

File.

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.

Before upload anything make sure that the PDF file is named as "acmac-xxxx.pdf", where "xxxx" is the "ID" number (if the "ID" number has less than four digits then please add leading zeros in order to have a four digit number). "ID" is the number after the "Article #ID" which is automatically generated by the system. For instance if your "Article #ID" is "Article #32" you have to name your PDF as "acmac-0032.pdf", if it is "Article #103" the name has to be set to "acmac-0103.pdf" etc.

From URL.

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.

If you selected "File" 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 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 URL" 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.

When you've entered the filenames or URLs, click on the "Upload" button. You'll then see a progress bar.

At least one file needs to be shown first. In many cases (e.g. PDF, Postscript) there will only be one file; if you've uploaded many files you will need to select the one to be shown first. This should be the first 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 Up and Down arrow buttons to tell the system which file should be shown first.

The "Delete" buttons (e.g. Bin) on the right can be used to remove individual files that you've uploaded in error.

You can continue to upload more files as before. If you've uploaded all necessary files, click on "Next".

Uploading From an Existing Web Site

When you give the repository a URL to retrieve your document from, the repository stores a copy of the file stored at that URL. If the URL is an HTML file, the repository will also copy the images associated with that HTML file, and other HTML files linked to it.

You must supply the URL of the first page of document itself: NOT the URL of the whole Web site, or the URL of any contents page listing multiple documents, index page or abstract page.

http://www.myinstitution.edu/~myhomepage/paper.html And NOT www.myinstitution.edu/~myhomepage/

In order to prevent the repository from trying to copy the whole World 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 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.

Only files at the same depth or deeper in the Web site file hierachy are retrieved. For example, if a link points to /index.html or ../index.html, the file will not be copied.

This method of uploading papers cannot have a guaranteed 100% success rate. However they have been using it at the University of Southampton for a number of months and it usually works very well.

If something does go wrong, it's normally best to delete all files, and try another uploading method.

Details

Next you will be asked to enter details, like bibliographic information, about your paper. The exact details that are required will vary depending on the deposit type you selected in the first stage and the system configuration.

On the right of each input field will be a questionmark which when pressed will give a short explanation of what should be put in the field. Above each input field is the field name. If the field name has an asterisk, the field must be filled out before the paper can be deposited; other fields are optional.

The following are the types of input field you may see:

Text boxes.

Fairly straightforward. Just type the relevant information in, or copy and paste direct from your document.

Popup menus.

Just select the most appropriate option from the popup menu.

Checkboxes.

Used to indicate a yes or no value.

Lists.

Select one or more appropriate options from the list.

Page ranges.

Type the first page in the range into the box on the left, and the last page in the box on the right. If the range consists of a single page, just enter the page number into the left-hand box, and leave the right-hand box empty.

Names.

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 input rows" button . 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.

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.

As with user profile, most browsers will allow you to use the tab key to move between the input fields, allowing you to enter the information quickly.

Subjects

In the subject categories stage, you should select the subject or subjects from the list that best represent the content of your paper. Please try and be as accurate as possible here, and please don't just select lots of categories if you're unsure, just pick the categories you are sure of.

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

Deposit Verification

If you're satisfied that everything is correct and has been uploaded correctly, and have read, understood and complied with the policies of the repository, click on the "Deposit Item Now" button to deposit your paper in the repository. It will then be put in the editorial buffer. If you spot a mistake you can use the "back" buttons (not the browser's "back" button) to cycle back through the depositing process and fix any mistakes. Through the depositing process there is always the option "Save for Later" that puts the document in your workspace area and can be resumed later.