Columbia Escutcheon Columbia University Libraries Digital Program
Ejournal Specs: Name Listing
Revised 7/11/2001
          Path: Digital Library Projects  : Metadata  :  Ejournals :  Specs  :  Names


A. Data Element Definitions
B. Selection & Sorting
     • Name Stoplist
C. Schematic Output
D. Markup Specification
E. Page Layout

F. Alphabetic Navigation Bar
G. Special Processing: Multiple URLs
H. File Names
I. Sample Output
J. Revision Log


A. Data Element Definitions

Output Element MMF Data Definition
"Name" Each instance of Name.name where Name_Item.tag = "110" or "111" or "710" or "711" where Name.name is not present in Stoplist
[an error occurred while processing this directive]

B. Selection & Sorting

  1. Select for output all MMF/CLIO records that are

    • ejournals and
    • where one or more Name.name elements is present with Name_Item.tag = "110" or "111" or "710" or "711" and
    • where Name.name element is not found on the Name Stop List

  2. For those records having more than one iteration of the "Name" element, output a separate entry once per each iteration; (i.e., "explode" record on the "Name" element)

  3. Create normalized versions of "Name" and "Title" strings for sorting purposes;

  4. Sort complete set of exploded entries on "Name" element; subarrange entries according to "Title" Element.

C. Schematic List Output

<DL>
<DT><H3>["Name" 1]</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>["Name" 2]</H3>
        <DD><B>["Title" + "Link" 2.1]</B> — ["Imprint"] — ["SSN"]
         <BR>Bookmark as: [Link + "Link text"] — ["CLIO Backlink"]
        <BR>
<DT><H3>["Name" 3]</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 Name Element;
  • <B></B> is used for the Title Element.
  • <BR><BR><BR> is inserted before each subsequent Title Element associated with a "new" Name Element
  • <BR><BR> is inserted before each subsequent Title Element associated with the same Name 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.

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:
      <!--#include virtual="/cu/lweb/includes/[subdirectory]/alpha_a.html" -->

    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 Name-Title listing in the following subdirectories:

      /cu/lweb/data/eresources/ejournals/names/
      /cu/lweb/data/eresources/ejournals/names/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.htm      l
      [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:

      <!--#include virtual="/cu/lweb/includes/nohits_gen.html" -->

    • Create corresponding "shell" files for each file output in the data directory in the specified parallel shell directory:

      /cu/lweb/eresources/ejournals/names/
      /cu/lweb/eresources/ejournals/names/      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/names/
      /cu/lweb/eresources/ejournals/names/detail      /
      and
      /cu/lweb/data/eresources/ejournals/names/
      /cu/lweb/data/eresources/ejournals/names/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

    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
    Last revision: 07/13/01
    © Columbia University