Title/Cover Page
On this page
- 1 Cover Elements
- 2 Example 1: Cover Page
- 2.1 Word Sample
- 2.2 XML Samples
- 2.2.1 Document Details
- 2.2.2 Dates
- 2.2.3 Superseding Document
- 2.2.4 Document Title
- 2.2.5 Specification Information
- 3 Example 2: Cover Page
- 3.1 Word Sample
- 3.2 XML Samples
- 3.2.1 Document Details
- 3.2.2 Document Title
- 3.2.3 Authorization and Subject Group
- 3.2.4 Publisher Information
- 3.2.5 Agency Information
In this section
Cover Elements
Document Details
Measurement is applied to the paragraph indicating the measurement units used throughout the document.
If a specified unit of measurement is not applicable to the document, then this style may be applied to the text “NOT MEASUREMENT SENSITIVE” or synonymous string.
DocID is applied to the standard’s ID or designation string.
Date is applied to the specification date (see Example 1).
Superseding Document
Documents that supersede earlier standards include the label “SUPERSEDING,” which takes the Supersedes paragraph style.
Supersedes Designation is applied to the designation (or ID) of the standard that is superseded by the document.
Supersedes Date is applied to the date of the superseded document (see Example 1).
Document Title
Title Prefix is applied to the prefix of the title, which usually indicates the type of document or specification.
Report Title is applied to the primary title of the document.
The subtitle of the document, if any, appears as a separate paragraph after the main title, and it takes the Report Subtitle paragraph style (see Example 1).
Specification Information
Distribution Info is applied to the paragraph describing the intended audience of the document.
Contact Info is applied to paragraphs containing the contact information associated with the document (see Example 1).
Example 1: Cover Page
Word Sample
The following example shows the correct title page styling in the Word document from the (possible) styles available on the Title tab of the eXtyles style palette.
XML Samples
The following XML samples are derived from the previous Word example. All of this content is located in <std-doc-meta> in the <front> of the document.
Document Details
Measurement
<custom-meta-group>
<custom-meta><meta-name>Units</meta-name><meta-value>INCH-POUND</meta-value></custom-meta>
</custom-meta-group>
Document ID (DocID)
<std-ref type="dated">MIL-DTL-11484/327A</std-ref>
Dates
For standards documents, dates associated with the publication process are generally included in the Word file to be rendered in print. So long as they are correctly styled, eXtyles will automatically identify the various dates associated with the publication and apply the appropriate attribute to the date in the XML file. All of this identification can be done without any special markup in the Word file. The key to this process is the consistent use of wording to identify each date.
Example:
The previous Word document image has a date styled as “Release Date” following the document ID:
MIL-PRF-39012F
29 May 2018
The following XML is generated; note the iso-8601-date attribute:
<release-date date-type="other" iso-8601-date="2018-05-29">29 May 2018</release-date>
eXtyles automatically parses the date into an attribute in the <release-date> element (e.g., iso-8601-date="2017-05-18"). This process is most robust if months are spelled out as words or as abbreviations and years are given as four digits.
Dates given in the form XXXX-XX-XX (e.g., 2012-05-11) will be parsed as YYYY-MM-DD (i.e., 11 May not 5 November). If months are given as digits (e.g., 12-08-2010 or 12-08-10), by default, eXtyles will identify the date as MM-DD-YY(YY) (i.e., U.S. date format; December 8, 2010) and will warn that the date is ambiguous.
The character used to separate the various elements of the date is reasonably flexible: slashes, colons, hyphens, or periods all enable dates to parse correctly.
If particular dates are not available at the time that the XML is exported, eXtyles will allow either X (e.g. XX-XX-XXXX) or two or more Ys, Ms, and Ds (e.g. MM-DD-YYYY) as placeholders that can later be replaced in the XML once the date is known.
Superseding Document
Document Title
Specification Information
Distribution
Example 2: Cover Page
Another example of the proper use of the (possible) styles available on the Title tab of the eXtyles style palette.
Word Sample
XML Samples
The following XML samples are derived from the above Word example (Example 2). With the exception of agency and agent information, all of this content is located in <std-doc-meta> in the <front> of the document.
Document Details
Document ID (DocID) and Edition
Release Date
Document Title
Authorization and Subject Group
Publisher Information
Publisher Location
Agency Information
Agency and agent information is placed after <std-doc-meta> in the <front>.
Agent and Agency
Copyright © 2022 Atypon Systems, LLC. All Rights Reserved.