Requirements:Author Display

From ISFDB

Jump to: navigation, search

This page is intended to be a clean specification for the display of author bibliographies. Discussions about the data here should be entered on the discussion page.

Contents

Author Bibliography Layout

The author bibliography will be laid out as follows:

author image opt author metadata
  • Legal Name
  • Birthplace
  • Birthdate
  • Deathdate
  • Wikipedia Entry
  • IMDB Entry
  • Email
  • Webpage
  • Used As Alternate Name By
  • Interviews
  • Bibliographic Comments
Fiction Series: series_list (type=NOVEL), allow(COLLECTION,SHORTFICTION,OMNIBUS)
Novels: title_list (type=NOVEL)
Collections: title_list (type=COLLECTION)
Omnibus: title_list (type=OMNIBUS)
Editor: title_list (type=EDITOR)
Anthology Series: series_list (type=ANTHOLOGY)
Anthologies: title_list (type=ANTHOLOGY)
Nonfiction Series: series_list (type=NONFICTION)
Nonfiction: title_list (type=NONFICTION)
Chapterbook: title_list (type=CHAPTERBOOK)
Nongenre: title_list (type=NONGENRE)
Cover Art: title_list (type=COVERART)
Backcover Art: title_list (type=BACKCOVERART)
Interior Art: title_list (type=INTERIORART)
Shortfiction Series: series_list (type=SHORTFICTION)
Shortfiction: title_list (type=SHORTFICTION)
Poems: title_list (type=POEM)
Essay Series: series_list (type=ESSAY)
Essays: title_list (type=ESSAY)
Reviews: review_list (type=REVIEW)
Interviews: interview_list (type=INTERVIEW)

Author Metadata Section

  • Email. The Email entry may be repeated to display multiple email addresses. These will be displayed on separate lines, preceded by the Email: label.
  • Webpage. The Webpage entry may be repeated to display multiple email addresses. These will be displayed on separate lines, preceded by the Webpage: label.
  • The Used As Alternate Name By entry will display all authors who used this author as a pseudonym. The list will consist of comma separated author links.
  • The Interviews entry will display all interviews in the ISFDB of this author. The list will consist of comma separated interview title links.

series_list

Behavior

  1. Only titles written or edited by the author will appear in the series list.
  2. A title which appears in a series list will not later appear in a non-series listing.
  3. If a series is a child of another series, that parent series (as well as any of its ancestors) shall be displayed.
  4. When a series tree is displayed that includes ancestors, the tree will not display sibling series to which the author did not contribute.
  5. If the author contributed works to separate series which have a common ancestor, the works will be displayed in a single series tree.

Grammar

 series_name
      child_seriesopt
      series_title_list
 
 child_series: series_name child_seriesopt
 
 series_title_list: series_title series_title_listopt
 
 series_title: o series_label title

Terminals

  • series_name - A hypertext link. The label for the link should be the text of the series name. The label should be displayed in a normal font. The link for the title will be $ISFDB/pe.cgi?series_id, where series_id is the record number of the series.
  • child_series - A hypertext link. This optional data is presented when the parent series has sub-series. A child series may be recursive - it may have additional child series itself. The label for the link should be the text of the child series name. The label should be displayed in a normal font. The link for the title will be $ISFDB/pe.cgi?series_id, where series_id is the record number of the child series.
  • series_label -

Example

 o Tales of Known Space
   o Draco's Tavern
     o Grammar Lesson (1977) [SF]
     o The Subject Is Closed (1977) [SF]
     o Cruel and Unusual (1977) [SF]
     o Assimilating Our Culture, That's What They're Doing! (1978) [SF]
     o The Schumann Computer (1979) [SF]
     o Limits (1981) [SF] 
   o Ringworld
     o 1 Ringworld (1970)
     o 2 The Ringworld Engineers (1980)
     o 3 The Ringworld Throne (1996)
     o 4 Ringworld’s Children (2004)

title_list

Title Structure

Grammar

 title: title_name date typeopt collaboratorsopt variant_titlesopt serialsopt
 
 collaborators: with author_name author_listopt
 
 author_list: and author_name author_listopt
 
 variant_titles: variant_title variant_titlesopt
 
 variant_title:  Variant Title: title_name date typeopt variant_authorsopt
 
 variant_authors: [as by author_name collaboratorsauthor_listopt]
 
 serials: Magazine/Anthology Appearances: serial_titles
 
 serial_titles: title_name date serial_titlesopt

Terminals

  • title_name - A hypertext link. The label for the link should be the text of the title. The label should be displayed in italics. The link for the title will be $ISFDB/title.cgi?title_id, where title_id is the record number of the title.
  • date - A display of the year associated with the title. The date field will be output in one of the following formats:
  • If the date field is a valid date that occurs in the past, the 4-digit year will be displayed in bold, between non-bold parenthesis: (1941)
  • If the date field is set to 0000-00-00, the date will be printed as the word "unknown", with the text in bold, between non-bold parenthesis: (unknown)
  • If the date field is set to 8888-00-00, the date will be printed as the word "unpublished", with the text in bold, between non-bold parenthesis: (unpublished)
  • If the date field is a valid date that occurs in the future, the date will be printed in month, day, year format, following the label "forthcoming:". The entire string shall be printed between brackets in bold: [forthcoming: Feb 01 2007]
  • type - The type is an optional title display feature. It will appear under two conditions:
  • When the title is displayed in a non-specific bibliographic section (for instance, a collection that appears in the Series section of the bibliography). In this case, the type will appear as a bold abbreviation between non-bolded brackets: [C]. The following abbreviations will be used:
  • C = Collection
  • A = Anthology
  • SF = Short Fiction
  • O = Omnibus (see note below)
  • Anytime the title is an omnibus. In this case, the type will also give an indication as to the contents of the omnibus (NEED CONSISTANT EXPLANATION HERE).
  • author_name - A hypertext link. The label for the link should be the canonical name of the author. The label should be displayed in normal text. The link for the title will be $ISFDB/ea.cgi?escaped_canonical_name, where escaped_canonical_name is the canonical name of the author with standard HTML escape sequences.

Examples

 Sixth Column (1941)
   * Variant Title: The Day After Tomorrow (1951)
   * Variant Title: Sixth Column (1941) [as by Anson MacDonald ] 
   * Magazine/Anthology Appearances:
   * Sixth Column (Part 1 of 3) (1941)
   * Sixth Column (Part 2 of 3) (1941)
   * Sixth Column (Part 3 of 3) (1941)
 Interface (1994) with J. Frederick George [as by Stephen Bury ]
 The Year's Best Fantasy and Horror: Eighteenth Annual Collection (2005) with 
 Gavin J. Grant and Kelly Link
Personal tools