Columbia University Libraries Digital Program

Ejournal Specs: Geographic Listing
Revised 7/11/2001

Path: Digital Library Projects : Metadata : Ejournals : Specs : Geographic Listing

IN PROCESS

LC GACs

A. Data Element Definitions

*Output Element*	*MMF Data Definition*
"Publisher"	Each instance of Name.name associated with item where Role.relator_code = "pub" (???)

[an error occurred while processing this directive]

B. Selection & Sorting

Select for output all MMF/CLIO records that are

ejournals and
where one or more Name.name elements is present with Role.relator_code = "pub"
Stop List??

Any record should have only a single Name.name elements with Role.relator_code = "pub"; if more than one, ignore subsequent.
Create normalized versions of "Publisher" and "Title" strings for sorting purposes;
Sort first by "Publisher" and then subarrange by "Title"

C. Schematic List Output

<DL>
<DT><H3>["Publisher" A]</H3>
        <DD><B>["Title" + "Link" 1.1]</B> — ["Imprint"] — ["SSN"]
        <BR>Bookmark as: [Link + "Link text"] — ["CLIO Backlink"]
        <BR>
        <DD><B>["Title" + "Link" 1.2]</B> — ["Imprint"] — ["SSN"]
       <BR>Bookmark as: [Link + "Link text"] — ["CLIO Backlink"]
        <BR>
<DT><H3>["Publisher" B]</H3>
        <DD><B>["Title" + "Link" 2.1]</B> — ["Imprint"] — ["SSN"]
        <BR>Bookmark as: [Link + "Link text"] — ["CLIO Backlink"]
       <BR>
<DT><H3>["Publisher" C]</H3>
        <DD><B>["Title" + "Link" 3.1]</B> — ["Imprint"] — ["SSN"]
        <BR>Bookmark as: [Link + "Link text"] — ["CLIO Backlink"]
        <BR>
       <DD><B>["Title" + "Link" 3.2]</B> — ["Imprint"] — ["SSN"]
        <BR>Bookmark as: [Link + "Link text"] — ["CLIO Backlink"]
</DL>

D. Markup Specification

The ejournals name-title listing citation display is essentially the same as the title listing citation display, with the addition of the "Name" element. Every unique iteration of a "Name" is displayed once ahead of all the citations associated with that name (i.e., the "Name" is de-duped after sorting). Also:

<DL><DT><DD> notation is used for the list, as shown in the schematic above
<H3></H3> is used for the Publisher Element;
<B></B> is used for the Title Element.
<BR><BR><BR> is inserted before each subsequent Title Element associated with a "new" Publisher Element
<BR><BR> is inserted before each subsequent Title Element associated with the same Publisher Element (i.e., for deduped entries)
If "Imprint" or "SSN" element is present (i.e., is non-null), precede with space, em-dash (i.e., &#151 ), space; if element is not present, do not insert corresponding em-dash
Insert eye-legible anchor & link for Resolver-Type URL.
Append "CLIO Backlink"

E. Page Layout

Insert headers, footers, etc. per instructions in "boilerplate.html"
Enclose content of each page in a single table with the following attributes:
- ROWS="1"
- COLS="1"
- WIDTH="640"
- BORDER="0"
- CELLSPACING="0"
- CELLPADDING="2"
- CLASS="lmargin5"

e.g.,

<TABLE ROWS="1" COLS="1" WIDTH="640"BORDER="0" CELLSPACING="0" CELLPADDING="2" CLASS="lmargin5">
<TR>
<TD>
[Page content]
</TD>
</TR>
</TABLE>

Output on a single page all entries for names beginning with the same character.

F. Alphabetic Navigation Bar

Create 27 separate 'include' files with custom navigation bars in the /cu/lweb/includes/names, /titles/ and other subdirectories, named as follows:

/cu/lweb/includes/[subdirectory]/numeric.html
/cu/lweb/includes/[subdirectory]/alpha_a.html
/cu/lweb/includes/[subdirectory]/alpha_b.html
/cu/lweb/includes/[subdirectory]/alpha_c.html
etc.
Default link display: each link-text in the alpha navbar is enclosed within a SPAN element as follows:

<SPAN CLASS="alphabet">[letter or word]</SPAN>

The SPAN should appear in place of the HREF tag for that letter.
Selected letter or word link display: In the file for entries beginning with a particular letter or with a numeric, use CLASS="alpha_selected" in place of CLASS= "alphabet" for the link corresponding to that file:

<SPAN CLASS="alpha_selected">[letter or word]</SPAN>

Also, omit the Link from the 'selected' entry (since the link would be to the same page).

See mockup of custom alpha navigation file at: http://www.columbia.edu/cu/libraries/inside/working/ejournals/specs/custom_alpha.html
In the file for the corresponding ejournal entries, insert as the first and last elements of the file a server-side include reference to the appropriate custom alpha navigation file, e.g.,

in the file:
/cu/lweb/data/eresources/ejournals/[subdirectory]/a.html

insert SSI references at the top and bottom as follows:

G. Special Processing for Records Having Multiple URLs

Records that meet the requirements for inclusion in this output set having more than one URL (Part_Presentation.url) are handled as exceptions, as follows:

As indicated in Section A above, the "Link" element is constructed from the CLIO Record Key (MMF cu001), e.g.,

<A HREF="detail/ank2942.html">Title</A>
The presence of multiple URLs must also trigger the creation a file that includes the corresponding "Detail Record", e.g.,

/ejournals/names/detail/ank2942.html
Specifications for creating "Detail record" record pages are in a separate document.

H. File Names, Directories, Shells & File Management

Output data files for the Publisher-Title listing in the following subdirectories:

/cu/lweb/data/eresources/ejournals/publishers/
/cu/lweb/data/eresources/ejournals/detail/
Output all entries in which the sort string begins with an alpha character 26 separate files according to the segment of the alphabet included in that file, e.g.,

a.html
b.html
[etc.]
Output all entries in which the sort string begins with a numeric in a single file called:

numeric.html
Output all entries that begin with with other than alphabetic or numeric characters in a single file called:

other.html
If there are letters of the alphabet or numbers (from 0-9) for which there are no corresponding ejournal entries to output, create the appropriately named file but insert the following server side include where the ejournal listing would ordinarily have been inserted:
Create corresponding "shell" files for each file output in the data directory in the specified parallel shell directory:

/cu/lweb/eresources/ejournals/publishers/
/cu/lweb/eresources/ejournals/detail/

['Makeshell' templatee info & parameters should be included here -- SPD]
When publishing new data, delete and remove all files in the production directories, i.e.,

/cu/lweb/eresources/ejournals/publishers/
/cu/lweb/eresources/ejournals/detail/
and
/cu/lweb/data/eresources/publishers/names/
/cu/lweb/data/eresources/ejournals/detail/

EXCEPTION: Do not delete the "index.html" file present in any subdirectory; this file will be created manually (or be a poke-error).

I. Sample Output

Mockup of output for the Publisher Listing
Mockup of output for the "Detail Page"

J. Revision Log

5/17/2001: Added "Bookmark as:" element
7/11/2001: Updated with previous spec change to add "lmargin5" to framing table [needs fixing?]
7/11/2001: Added "CLIO Backlink Element"

Columbia Libraries

Digital Program