make_repository Readme

UNIFORM REPOSITORY SERVICE - Version 1.1

Gerald J. F. Banon,
banon@dpi.inpe.br

Copyright for the Uniform Repository Service (c) 1995, 1996, 1997,
by Gerald Banon. All rights reserved.

make_repository
alias is mr

The make_repository command creates a new Uniform Repository, that is,
a new directory where to deposit a document.

WHEN TO USE the make_repository command?

When a copyright holder of a document needs to deposit it in the Uniform
Repository Library.

HOW TO USE the make_repository command?

Go to the following directory:

col/dpi.inpe.br/banon/1995/08.08.00.00/not_sent/library_service

(
for example if the current directory is the one in which you have
installed the initial collection (e.g. URLib), just execute the line

cd col/dpi.inpe.br/banon/1995/08.08.00.00/not_sent/library_service
)

then execute the line

make_repository <entry_type>

The <entry type> is one of the following words:

Article                  MastersThesis
Book                     Misc
Booklet                  PhdThesis
InBook                   Proceedings
InCollection             TechReport
InProceedings            Unpublished
Manual

Example:

make_repository Article

Once a new repository has been made a message is printed on the screen
asking to:

1. deposit or link the document from the doc directory in this repository;

2. edit the bibliographic reference file called bib/XxxxxxYyyyZzzz::ABC/a.bib
   in this repository; the targetfile field is the filename of the target
   file in the current doc directory, that is, the file that should be
   accessed first when consulting the document (default is target.html);

3. update the index by executing the ui command;

OBSERVATION 1

The default citation key is XxxxxxYyyyZzzz::ABC; when editing the a.bib
file, you must change it according the following rules:

The citation key should be formed of three parts (separeted by :):

1. the last name of the (first) author (beginning with a capital letter)
   concatenated with the last name first four letters of each other author,
   if any (beginning with a capital letter);
2. the year (with no abreviation);
3. three capital letters representing the first letters of the
   first three essential words in the title; for shorter titles fewer
   letters may be used. If needed, more capital letter or mumber may be
   added.

Example:

@Article{MolchanovStoy:1994:APE,
  author =          "I. Molchanov and D. Stoyan",
  title =           "Asymptotic properties of estimators for parameters
                     of the Boolean model",
  journal =         "Advances in Applied Probability",
  year =            "1994",
  volume =          "26",
  pages =           "301--323",
  annote =          "entry from dpi.inpe.br/banon/1995/09.18.18.50",
}

Another example of citation key is:

Candeias::I

no year mentioned means that the document is in progress.

IMPORTANT

Once you send a document (see the send_repository command) its
write-permission is automatically turned off unless it is a
work-in-progress document (::). So, if you want to continue modifying a
document after it has been sent, you should NOT mention the year or the
version within the citation key, that is, :: should appear in the
middle of the citation key.

OBSERVATION 2

To have the small icone appearing in the index.html file, with your
own image, just deposit a .gif file in the bib/<citation_key> directory.

end_Readme