XML:NewPub

From ISFDB
Revision as of 14:10, 21 May 2008 by DESiegel60 (talk | contribs) (+cat)
Jump to navigation Jump to search

Introduction

The NewPub submission generates new publication information for a single specific publication.

Optional Tags

The submission contains contains a number of optional tags. These tags should be used whenever the relevant data is available for a particular field. The following section describes the tags are supported in the metadata section. You should refer to Help:Screen:NewPub for more detailed information on data entry. The bold text in the description refers to specific labels found in the Help article:

  • Title - The Title of the publication.
  • Authors - The Author list associated with the publication. This XML tag will enclose:
    • Author - There should be one Author entry for each individual who wrote or edited the publication.
  • Artists - The Artist list associated with the publication. This XML tag will enclose:
    • Artist - There should be one Artist entry for each individual who wrote or edited the publication.
  • Tag - Unique ASCII identifier for the publication. Used for magazines.
  • Year - The Year of publication.
  • Pages - The number of Pages in the publication.
  • Binding - The Pub Format of the publication.
  • PubType - The Pub Type type of the publication.
  • Isbn - The ISBN / Catalog # of the publication.
  • Price - The Price of the publication.
  • Image - The Image URL associated with the publication cover art.
  • Note - A Note specific to this publication.
  • Publisher - The Publisher of the publication.
  • Parent - Used to automerge the publication. The parent id is record number of the parent title.
  • Content - For non-novels, some amount of content may be associated with the publication. Only those titles undergoing change should be included in this section. If no titles are modified, the Content section must be present, although it will be empty. Any number of the following content type entries are supported:
    • ContentTitle - This is for normal content, such as short stories or essays.
    • ContentReview - This is a specialized format for reviews, taking into account the author writing the review, and the author who wrote the work being reviewed.
    • ContentInterview - This is a specialized format for interviews, taking into account the author that conducted the interview, and the author who was interviewed.

ContentTitle

Refer to Help:Screen:NewPub#General_contents for detailed data-entry help:

  • cTitle - The name of the title.
  • cAuthors - The author(s) of the title. Note that multiple authors are separated with a +; they are not enclosed in separate XML tags.
  • cDate - The copyright date of the title.
  • cPage - The page the title appears on.
  • cType - The Entry Type of the title.
  • cLength - The Length of the title.

ContentReview

Refer to Help:Screen:NewPub#Reviews for detailed data-entry help:

  • cTitle - The name of the title.
  • cBookAuthors - The author(s) of the book being reviewed. Note that multiple authors are separated with a +; they are not enclosed in separate XML tags.
  • cReviewers - The author(s) writing the review. Note that multiple authors are separated with a +; they are not enclosed in separate XML tags.
  • cDate - The copyright date of the review.
  • cPage - The page the review appears on.

ContentInterview

Refer to Help:Screen:NewPub#Interviews for detailed data-entry help:

  • cTitle - The name of the title.
  • cInterviewee - The author(s) conducting the interview. Note that multiple authors are separated with a +; they are not enclosed in separate XML tags.
  • cInterviewer - The author(s) being interviewed. Note that multiple authors are separated with a +; they are not enclosed in separate XML tags.
  • cDate - The copyright date of the interview.
  • cPage - The page the interview appears on.

Example

<?xml version="1.0" encoding="iso-8859-1" ?>
<IsfdbSubmission>
  <NewPub>
  <Submitter>Ahasuerus</Submitter>
  <Subject>Sweet and Deadly</Subject>
  <Parent>185660</Parent>
  <Title>Sweet and Deadly</Title>
  <Year>1981-00-00</Year>
  <Publisher>Houghton Mifflin</Publisher>
  <Pages>179</Pages>
  <Binding>hc</Binding>
  <PubType>NOVEL</PubType>
  <Isbn>0395305322</Isbn>
  <Price>$8.95</Price>
  <Note>Data from OCLC record 6915310.</Note>
  <Authors>
    <Author>Charlaine Harris</Author>
  </Authors>
  <Content>
  </Content>
  </NewPub>
</IsfdbSubmission>