[Dpubs-content] XML for Journal Issues

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Hi All,

As part of getting ready to upload our first issue of new content, 
I've been studying the requirements of the xml metadata file.  To 
help me understand these requirements, I went through the schema 
definition (DPubS/htdocs/dtds/dpubs_journal_issue.xsd) and used it to 
produce an empty xml file containing all the possible containers the 
schema describes.  I've also gone through and added comments about 
which fields and attributes are required, repeatable, etc.

I'm sending it to the list in hopes that folks who know the schema 
better than I might tell me if I've made any glaring errors.  I also 
thought others might find it helpful for documenting the process of 
preparing content.  I'll both attach it and copy-paste it below.

TGIF,
Henry Griffy
Ohio State University Libraries

<?xml version="1.0" encoding="iso-8859-1"?>
<dpubs_access_data version="1.0" 
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance 
xsi:noNamespaceSchemaLocation="dpubs_journal_issue.xsd">
<journal_issue> <!-- main container: contains <header> and <issue> -->
	<header> <!-- contains four elements, each required and non-repeatable -->
		<issue_identifier>title, volume, number, date</issue_identifier> 
<!-- required -->
		<timestamp>yyyy-mm-dd</timestamp> <!-- required -->
		<journal_id>aka, the authority</journal_id> <!-- required -->
		<contact> <!--  -->
			<contact_name>string</contact_name> <!--  -->
			<email>string@string</email> <!--  -->
			<phone>string</phone> <!--  -->
		</contact>
	</header>
	<issue> <!-- contains the bulk of the metadata: <issue_data> and 
_either_ <div> or <record> -->
		<issue_data> <!-- information that applies to the whole issue -->
			<identifiers>  <!-- required -->
				<identifier type="doi | dpubs | jstorURL | pii | sici | url | 
other" other="">string</identifier>  <!-- required, repeatable -->
			</identifiers>
			<series order="">integer btwn 1 and 10</series>  <!-- optional  -->
			<journal_vol_number>string</journal_vol_number>  <!-- required -->
			<issue_title>string</issue_title>  <!-- optional -->
			<issue_sortList_title 
sortKey="">string</issue_sortList_title>  <!-- optional -->
			<issue_number label="">required</issue_number>  <!-- required -->
			<issue_publ_date iso8601="yyyy-mm-dd" type="PRINT | online | 
other" other="">string</issue_publ_date>  <!-- optional, repeatable -->
			<start_page>string</start_page>  <!-- optional -->
			<end_page>string</end_page>  <!-- optional -->
			<extent>string</extent>  <!-- optional -->
			<editorial_board>  <!-- optional -->
				<editor>  <!-- required, if <editorial_board> is used; repeatable -->
					<editor_specialty>string</editor_specialty>  <!-- optional -->
					<role>string</role>
					<name>  <!-- required if <editor> is used -->
						<name_prefix>string</name_prefix>  <!-- optional -->
						<given_name>string</given_name>  <!-- required -->
						<surname>string</surname>  <!-- required -->
						<name_suffix>string</name_suffix>  <!-- optional -->
						<display_name>string</display_name>  <!-- optional -->
					</name>
					<email>string@string</email>  <!-- optional -->
					<web_page>string</web_page>  <!-- optional -->
					<affiliation>  <!-- optional, repeatable -->
						<label>string</label>  <!-- optional -->
						<prof_title>string</prof_title>  <!-- optional -->
						<department>string</department>  <!-- optional -->
						<organization>string</organization>  <!-- optional -->
						<address>
							<address_line>string</address_line>  <!-- optional, repeatable -->
						</address>
						<phone>string</phone>  <!-- optional -->
						<fax>string</fax>  <!-- optional -->
					</affiliation>
			</editorial_board>
		</issue_data>

		<div label=""> <!-- optional, repeatable container for a group of 
records  -->

		<record lang="" type="frontmatter | backmatter | ARTICLE | review | 
index | other">  <!-- required, repeatable -->
			<identifiers>  <!-- required -->
				<identifier type="(required) doi | dpubs | jstorURL | pii | sici 
| url | other" other="">string</identifier>  <!-- required -->
			</identifiers>
			<title lang="" type="MAIN | alternative">  <!-- required, repeatable
					can use either of the following sets of tags: basically 
formatting +/- list -->
				<b></b> or <i></i> or <u></u> or <sub></sub> or 
<sup></sup>   <!-- optional, repeatable -->
				<ul><li><b></b><i></i><u></u><sub></sub><sup></sup></li></ul> 
<!-- optional, repeatable -->
			</title>
			<author>  <!-- optional, repeatable -->
					<name>  <!-- required if <author> is used -->
						see above (editor) for detailed list of sub-fields
					</name>
				<email>string</email>  <!-- optional -->
				<web_page>string</web_page>  <!-- optional -->
					<affiliation>  <!-- optional, repeatable -->
						see above (editor) for detailed list of sub-fields
					</affiliation>
			</author>
			<contributor order="">  <!-- optional, repeatable -->
				<role>string</role>  <!-- required, if <contributor> used -->
					<name>  <!-- required if <contributor> is used -->
						see above (editor) for detailed list of sub-fields
					</name>
				<email>string</email>  <!-- optional -->
				<web_page>string</web_page>  <!-- optional -->
					<affiliation>  <!-- optional, repeatable -->
						see above (editor) for detailed list of sub-fields
					</affiliation>
			</contributor>
			<abstract lang="default EN">  <!-- optional -->
				<p align="left | center | right">
					<ul><li><b></b><i></i><u></u><sub></sub><sup></sup></li></ul> 
<!-- optional -->
				</p>
			</abstract>
			<reviewed_items>  <!-- optional -->
				<citation>  <!-- optional -->
					<author>  <!-- optional, repeatable -->
						see above (author) for detailed list of sub-fields
					</author>
					<contributor>  <!-- optional, repeatable -->
						see above (contributor) for detailed list of sub-fields
					</contributor>
					<title>string</title>  <!-- required -->
					<add_desc_data>string</add_desc_data>  <!-- optional -->
					<identifiers>  <!-- optional -->
						<identifier type="(required) doi | dpubs | jstorURL | pii | 
sici | url | other" other="">string</identifier>
					</identifiers>
				</citation>
			</reviewed_items>
			<related_item>  <!-- optional -->
				<label>string</label>  <!-- required, if <related_item> used -->
				<citation>  <!-- required if <related_item> used -->
					see above (reviewed_items) for detailed list of sub-fields
				</citation>
				<record_filename>string</record_filename>  <!-- optional -->
			</related_item>
			<keywords>  <!-- optional -->
				<keyword lang="" rank="(required) primary | 
secondary">string</keyword>  <!-- required, if <keywords> used, repeatable -->
			</keywords>
			<subjects>  <!-- optional -->
				<subject lang="" rank="(required) primary | secondary" 
scheme="(required)">string</subject>  <!-- required, if <subjects> 
used, repeatable -->
			</subjects>
			<start_page>string</start_page>  <!-- optional -->
			<extent>string</extent>  <!-- optional -->
			<end_page>string</end_page>  <!-- optional -->
			<record_filename filetype="tif | mtif | gif | jpg | pdf | ps | 
txt" other="" anchor="">string</record_filename> <!-- either this or 
<record_filename_set> required -->
			<record_filename_set setID="(required)">
				<set_item seq="" filename="" filetype="tif | mtif | gif | jpg | 
pdf | ps | txt" n="" ftr=""/> <!-- required if <record_filename_set> used -->
			</record_filename_set>
		</record>
		</div>
	</issue>
<journal_issue>