Difference between revisions of "XML:NewPub"

From ISFDB
Jump to navigation Jump to search
m (+cat)
(→‎Optional Tags: +Publication series and number)
 
(3 intermediate revisions by 2 users not shown)
Line 12: Line 12:
 
* '''Artists''' - The '''Artist''' list associated with the publication. This XML tag will enclose:
 
* '''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.
 
** '''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. Uses the YYYY-MM-DD format.
−
* '''Year''' - The '''Year''' of publication.
 
 
* '''Pages''' - The number of '''Pages''' in the publication.
 
* '''Pages''' - The number of '''Pages''' in the publication.
 
* '''Binding''' - The '''Pub Format''' of the publication.
 
* '''Binding''' - The '''Pub Format''' of the publication.
Line 19: Line 18:
 
* '''Isbn''' - The '''ISBN / Catalog #''' of the publication.
 
* '''Isbn''' - The '''ISBN / Catalog #''' of the publication.
 
* '''Price''' - The '''Price''' of the publication.
 
* '''Price''' - The '''Price''' of the publication.
 +
* '''Language''' - One of the languages recognized by ISDFB. See the [http://www.isfdb.org/cgi-bin/mypreferences.cgi My Preference] page for a list of currently recognized languages.
 
* '''Image''' - The '''Image URL''' associated with the publication cover art.
 
* '''Image''' - The '''Image URL''' associated with the publication cover art.
 
* '''Note''' - A '''Note''' specific to this publication.
 
* '''Note''' - A '''Note''' specific to this publication.
 +
* '''ModNote''' - A note which will be reviewed by the approving moderator, but will not be included in the database upon approval.
 
* '''Publisher''' - The '''Publisher''' of the publication.
 
* '''Publisher''' - The '''Publisher''' of the publication.
−
* '''Parent''' - Used to automerge the publication. The parent id is record number of the parent title.
+
* '''PubSeries''' - The '''Publication series''' of the publication
−
* '''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:
+
* '''PubSeriesNum''' - The '''Publication series number''' of the publication
−
** '''ContentTitle''' - This is for normal content, such as short stories or essays.
+
* '''Parent''' - This is the record number of the parent title used to auto-merge the publication with an existing title record.
−
** '''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.
+
* '''Content''' - Additional content titles may be associated with the publication. Any number of the following content type entries are supported:
−
** '''ContentInterview''' - This is a specialized format for interviews, taking into account the author that conducted the interview, and the author who was interviewed.
+
** '''ContentTitle''' - This is for normal content, such as short fiction or essays.
 +
** '''ContentReview''' - This is a specialized format for reviews, which includes the author(s) writing the review and the author(s) who wrote the work being reviewed.
 +
** '''ContentInterview''' - This is a specialized format for interviews, which includes the author(s) that conducted the interview and the author(s) who was interviewed.
  
 
====ContentTitle====
 
====ContentTitle====
Line 32: Line 35:
 
* '''cTitle''' - The name of the title.
 
* '''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.
 
* '''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.
+
* '''cDate''' - The date of the title.
 
* '''cPage''' - The page the title appears on.
 
* '''cPage''' - The page the title appears on.
 
* '''cType''' - The '''Entry Type''' of the title.
 
* '''cType''' - The '''Entry Type''' of the title.
Line 42: Line 45:
 
* '''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.
 
* '''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.
 
* '''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.
+
* '''cDate''' - The date of the review.
 
* '''cPage''' - The page the review appears on.
 
* '''cPage''' - The page the review appears on.
  
Line 50: Line 53:
 
* '''cInterviewee''' - The author(s) conducting the interview. Note that multiple authors are separated with a '''+'''; they are not enclosed in separate XML tags.
 
* '''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.
 
* '''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.
+
* '''cDate''' - The date of the interview.
 
* '''cPage''' - The page the interview appears on.
 
* '''cPage''' - The page the interview appears on.
  
 
==Example==
 
==Example==
  
 +
<source lang="xml">
 
  <?xml version="1.0" encoding="iso-8859-1" ?>
 
  <?xml version="1.0" encoding="iso-8859-1" ?>
 
  <IsfdbSubmission>
 
  <IsfdbSubmission>
Line 77: Line 81:
 
   </NewPub>
 
   </NewPub>
 
  </IsfdbSubmission>
 
  </IsfdbSubmission>
 +
</source>
  
 
[[Category:Data Submission Formats|NewPub]]
 
[[Category:Data Submission Formats|NewPub]]

Latest revision as of 18:52, 13 February 2014

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.
  • Year - The Year of publication. Uses the YYYY-MM-DD format.
  • 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.
  • Language - One of the languages recognized by ISDFB. See the My Preference page for a list of currently recognized languages.
  • Image - The Image URL associated with the publication cover art.
  • Note - A Note specific to this publication.
  • ModNote - A note which will be reviewed by the approving moderator, but will not be included in the database upon approval.
  • Publisher - The Publisher of the publication.
  • PubSeries - The Publication series of the publication
  • PubSeriesNum - The Publication series number of the publication
  • Parent - This is the record number of the parent title used to auto-merge the publication with an existing title record.
  • Content - Additional content titles may be associated with the publication. Any number of the following content type entries are supported:
    • ContentTitle - This is for normal content, such as short fiction or essays.
    • ContentReview - This is a specialized format for reviews, which includes the author(s) writing the review and the author(s) who wrote the work being reviewed.
    • ContentInterview - This is a specialized format for interviews, which includes the author(s) that conducted the interview and the author(s) 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 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 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 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>
Retrieved from "https://isfdb.org/wiki/index.php?title=XML:NewPub&oldid=342275"