Citation Matching automates the process of comparing and matching citations with their references/objects, including:

• bibliographic reference entries

• objects (such as figures, tables, boxes, equations, and appendices that called out within the text)

Citation Matching also automatically:

• Identifies all bibliographic citations that have no matching reference entry

• Identifies all reference entries that do not have at least one citation

• Identifies all figure, table, box, section, and appendix callouts with no matching figure, table, box, section or appendix title/caption

• Identifies all figure legends, box legends, table titles, and footnotes (unlinked and plain text) that do not have at least one callout

• Identifies all section numbers that do not have at least one callout

Each of these issues, if it occurs, is automatically indicated in your document with the insertion of an author query. The actual citations and callouts in the manuscript are indicated with a color-coded character style both to aid in proofing and to generate cross-reference markup in the XML.

How to use

To use Citation Matching:

1. Run eXtyles up through Convert/Clean Numbered Citations.

2. Look at the body of the document and determine the citation style that now appears in the document (e.g., name-date, numbers in brackets, etc.).

1. Select eXtyles > Advanced Processing > Citation Matching. You will see a dialog asking you to select the bibliographic citation style used in the document. Select the appropriate style and click OK.

   

Citation Matching Queries

If eXtyles adds queries during Citation Matching, an alert will appear after processing is complete to indicate the number of queries added.

Likewise, an alert is shown when queries have not been added to indicate that Citation Matching completed successfully.

To view the different reasons Citation Matching might insert a query, see the following section “Common Causes of Query Insertion.”

Reference Citation Matching Failures

Citation Matching automatically applies the character style cite_bib to all reference citations in the document and generally this is a very accurate process. Occasionally, however, eXtyles will fail to automatically apply this style during Citation Matching; or, it may incorrectly apply the style to text that is not a reference citation. Common reasons for citation matching misfires and how to resolve them follow.

The Citation Is Ambiguous

Occasionally, both numbered (Vancouver) and name-date (Harvard) citations are presented in such a way as to make programmatic identification by eXtyles difficult. For numbered citations this can include scenarios where the citation too closely resembles part of a formula (however, see “Math and Superscript Citation Matching” below).

For example, eXtyles may not identify 23 as a reference citation because it resembles a formula or mathematical notation:

Refer to the DSM-5²³ for more information.

For name-date citations this can include circumstances where a non-citation name and date closely resemble a citation. For example, the following may be incorrectly identified as a reference citation even though it refers to a hurricane:

As seen with previous super-storms (Katrina 2015) weather patterns are changing.

In these cases it is unlikely that making editorial changes to the text will result in better automated processing. Instead, the correct citation style cite_bib should be hand applied or removed (using the Ctrl + Space shortcut).

The Citation Is a Word Field

If reference citations are formatted as Word fields (through the use of, e.g., reference-management software such as EndNote) eXtyles Citation Matching will not identify them. eXtyles Advanced Processes are not able to read within Word fields and so it is important to ensure that previous eXtyles processes that take care to convert fields to plain text (e.g., Cleanup) are run prior to Citation Matching.

The Character Styling of References Is Incorrect or Incomplete

If Citation Matching warns that a reference citation does not have a corresponding reference entry and yet one exists, check to make sure that the reference paragraph has been correctly character-styled by Bibliographic References Processing. Citation Matching will struggle if important elements of the reference have not been styled correctly. For example, in the following reference the author names have not been correctly styled:

If not corrected, Citation Matching will produce a warning:

In such cases, the correct character styles can be hand-applied from the Word Styles menu to either (or both) the citation or reference.

Active Citations

Active citations in the text—such as “Smith and Jones, 1999, proved in their experiment”—will not be matched. Either the entire citation or the year must be enclosed in parentheses (or [brackets] if nested inside parentheses).

Common Causes of Query Insertion

Similarly, Citation Matching automatically applies the character styles cite_fn (for footnotes), cite_fig (for figures), cite_box (for boxes) and cite_tbl (for tables) to all callouts in the text. Occasionally, eXtyles will fail to automatically apply these styles during Citation Matching. In such cases, the appropriate style must be applied by hand from the Word Styles menu to the callout. Citation Matching can then be run again to ensure the accuracy of these hand-applied styles.

Figure and Table Matching

Citation to another article: Citation Matching incorrectly sees citations to figures and tables in other articles, such as “See figure 1 in Smith (1999)”, as part of the current article. Queries about such citations are incorrect and should be removed by deleting the Word comment containing them.

Incorrect styling: Citation Matching relies on correct styling of paragraphs. Please make sure the figure legends and table titles are styled correctly if you see erroneous queries.

Object Citation Matching Failures

Citation Matching also automatically applies the character styles cite_fn (for footnotes), cite_fig (for figures), cite_box (for boxes) and cite_tbl (for tables) to all callouts in the text. However, occasionally eXtyles will fail to automatically apply these styles during Citation Matching. Common reasons for object citation matching misfires and how to resolve them follow.

The Citation Is to Another Article

Citation Matching incorrectly sees citations to figures and tables in other articles, such as “See figure 1 in Smith (1999)”, as part of the current article. Queries about such citations are incorrect and should be removed by deleting the Word comment or by removing the character style (Ctrl + Space) that eXtyles may have incorrectly applied.

The Object Caption Is Incorrectly Styled

Citation Matching relies on correct styling of paragraphs; that is, it will rely on the presence of table, figure, or box captions and appendix titles to successfully match citations to them. If Citation Matching queries a citation to an object that exists in the document, check to make sure that the object title/caption is styled with the correct paragraph style.