Normative Reference Processing
Jenny Seifert (Unlicensed)
Introduction
eXtyles Standards Reference Processing will perform two functions: (1) identify the reference type (e.g., journal, standard, book) and (2) identify and character style the semantically distinct elements of the reference entry. The character styles that are applied are color-coded for easy visual identification. In this way, an editor can quickly see the varius distinct parts of the reference, which will facilitate efficient copyediting (see “Character Styling of References” further on for more information).
Paragraphs that are styled as Applicable Documents, Normative References, or Bibliographic Reference are processed during this step. After running Cleanup and applying the correct paragraph styles from the Style Paragraphs palette, select Advanced Processing > Standards Reference Processing from the eXtyles menu.
The following sections describe the Standards Reference Processing behavior for both standard references and other references (e.g., references to journals, books, and so on).
Automatic Processing of Standards References
The Standards Reference Processing feature processes standards that may appear in bibliographic reference lists. It also processes references to standards in normative reference lists. For example
Normative References (Applicable Documents)
<std>ISO 4254-1:2008, Agricultural machinery—Safety—Part 1: General requirements</std>
Bibliography
<std>[1] ISO 5725-2, Accuracy (trueness and precision) of measurement methods and results—Part 2: Basic method for the determination of repeatability and reproducibility of a standard measurement method</std>
A standard reference in a bibliography or non-normative reference list (Applicable Documents) will be wrapped in the eXtyles tag <std>, indicating a standard citation.
In all cases, no reformatting is done to avoid introducing errors in designations. Bibliographies and normative reference lists will still need the careful attention of a copy editor to ensure that your organization’s editorial style is enforced.
Each element in a standard reference is character-styled by eXtyles Standards Reference Processing. The following table includes some examples of common reference components and their element names.
Element | Example Text |
---|---|
std_publisher | ISO |
std_docNumber | 4254 |
std_docPartNumber | 1 |
std_year | 2008 |
std_docTitle | Agricultural machinery—Safety—Part 1: General requirements |
Automatic Processing of Other References
The generic examples in this documentation are intended to illustrate various eXtyles features and will not exactly reproduce your organization’s editorial style.
Standards Reference Processing acts on all properly styled references in addition to standards. For example, after Standards Reference Processing, a typical journal reference looks like this:
<jrn>[1] Klingensmith, G. J., et al. “Glucocorticoid treatment of girls with congenital adrenal hyperplasia: Effects on height, sexual maturation, and fertility.” Journal of Pediatrics 90 (1977): 996–1004.</jrn>
And a typical book reference looks like this:
<bok>Gibbs, A. J., et al. Molecular Basis of Virus Evolution. Cambridge University Press, Cambridge, UK. 1995</bok>
Non-journal and non-book references include conferences, working papers, unpublished theses, and other works. In these cases, eXtyles Standards Reference Processing will not fully character-style the reference; only a few key components of the reference will be identified: the author names(s), the publication year, and the reference number (if present). As with standard, journal, and book references an editor will have to carefully edit these reference types to ensure conformance with your organization’s editorial style.
Each component of the reference is identified and color-coded to facilitate efficient copy editing. The first item is the reference type tag, which specifies the type of reference that eXtyles has identified. Possible types are:
- <jrn> Journal references
- <bok> Book references
- <edb> Edited book or book chapter references
- <conf> Conference proceeding
- <eref> Reference to a website
- <lgl> Citation of a legal case or statute
- <ths> Reference to a thesis/dissertation
- <other> References to working papers, patents, maps, and other documents
- <unknown> Unsupported or otherwise unknown reference type
Reference types might occasionally be incorrectly identified as <bok> or <unknown>. Misidentification is usually the result of a punctuation error by the author or a pattern that eXtyles does not support.
Each element in a reference entry is identified and tagged appropriately by eXtyles during Standards Reference Processing. The following table includes some examples of common reference components and their element names:
Element | Example Text |
---|---|
bib_surname | Klingensmith |
bib_fname | GJ |
bib_article | Glucocorticoid treatment... |
bib_journal | Journal of Pediatrics |
bib_year | 1977 |
bib_volume | 90 |
bib_fpage | 996 |
bib_lpage | 1004 |
Viewing References
If necessary, use the Hide Tags function to turn off and on the display of reference type tags (<jrn>, <bok>, etc.).
Do not delete the tags because they carry important information used by other functions on the Advanced Processing menu.
Reference Processing Query Insertion
If eXtyles adds queries (which appear as Word comments) during Standards Reference Processing, an alert will appear after processing is complete to indicate the number of queries added. No alert is shown when queries have not been added. You can view or hide queries via the Review ribbon > Show Markup > Comments.
Manual Editing and Reference Reprocessing
Once a reference has been tagged with a type (e.g., <std>, <jrn>), it will not be reprocessed if you rerun Advanced Processing > Standards Reference Processing. eXtyles ignores tagged entries on successive passes of this function. If you wish to reprocess a reference after making some changes to it, you can remove the reference type tag. For example, the following reference failed to process correctly because of the double punctuation after the volume number:
<unknown>Janmey, A.A. “Protein regulation by phosphatidylinositol lipids.” Chemistry & Biology 2;:1 (1995): 61–65.</unknown>
You can fix the punctuation manually—that is, delete the extra colon after the volume number—and then remove the reference type tags (by backspacing over the tag, or by selecting the tag and cutting it with Control-X) so that the reference looks like this:
Janmey, A.A. “Protein regulation by phosphatidylinositol lipids.” Chemistry & Biology 2;1 (1995): 61–65.
After selecting the Standards Reference Processing menu item again, the reference will be properly restructured as shown here:
<jrn>Janmey, A.A. “Protein regulation by phosphatidylinositol lipids.” Chemistry & Biology 2, no. 1 (1995): 61-65</jrn>
Hiding the reference type tags is not the same thing as deleting them. To reprocess a reference, you must actually delete the tags at the start and end of a reference. Hiding them with the Hide Tags menu item will make the tag disappear on screen, but it will not cause a reference to be reprocessed.
Do not copy reference type tags from one reference and paste them onto another reference. These tags may be applied only automatically by Standards Reference Processing or by using the Insert Tags option on the eXtyles menu. Copying and pasting these tags may cause failures in other Advanced Processing operations.
Errors can be fixed even without removing the colored highlights and styles. Standards Reference Processing removes all highlighting before reprocessing a reference. Colored highlights and styles are reapplied before the results of the Standards Reference Processing function are displayed on screen.
Character Styling of References
When references are processed by eXtyles, Word character styles such as bib_article, bib_journal, and so on are automatically applied to each part of the reference text. If you manually edit a reference after reference processing, be sure that the character styles are correctly applied to the edited text. These character styles can be applied just like any other character styles in Word; that is, via Word’s Styles feature (in Word 2016, access this menu on the Home tab or press Control + Alt + Shift + S).
In some unusual cases, even when a reference is correctly copyedited, eXtyles may fail to process it correctly. In such cases, you should edit the reference by hand and then apply the character styles directly from the Word Style feature.
The character styles should be applied only to the actual content that is typically highlighted, not to surrounding punctuation. For example, if your organization’s style includes parentheses around the year of publication, apply the bib_year character style to just the year itself, such as (1995), and not to the surrounding punctuation.
Styles that may be used for reference entries include the following:
Style | Use |
---|---|
std_publisher | The standard publisher |
std_docNumber | The standard document number |
std_docPartNumber | The part number of the standard document |
std_year | The standard date (year) |
std_docTitle | The standard title |
bib_number | The reference number |
bib_etal | “et al.” when it appears in the reference |
bib_surname | An author’s surname |
bib_fname | An author’s given name or initials |
bib_suffix | An author’s suffix (e.g., Jr., Sr.) |
bib_organization | An organization name as an author |
bib_article | The article title |
bib_journal | The journal name |
bib_year | The year of publication |
bib_volume | The volume of publication |
bib_issue | The issue of publication |
bib_month | The month or season of publication |
bib_suppl | The publication supplement |
bib_fpage | The first page of publication |
bib_lpage | The last page of publication |
bib_unpubl | Pre-publication information such as “in press” |
bib_comment | A comment, such as [Abstract] |
bib_url | A URL included in a journal reference |
bib_doi | A DOI inclded in a journal reference |
Related content
© 2019 Inera Incorporated. All Rights Reserved.