In tagging a book or product review, there are two parts to the material to be captured:
All information in <article-meta>, other than within the <product> element, describes the review article itself, not the book (or other product) being reviewed. While the text below primarily describes a book or product review, reviews for software, websites, journal articles, issues of journals, laboratory or electronic equipment, DVDs, or other things can be tagged similarly.
On the <article> element, the @article-type attribute should identify the article as a product review, with a value such as “book-review”, “software-review”, etc. (Note: An article that reviews research findings in a particular domain should be tagged article-type="review-article".)
There are several common styles of article title (<article-title>) for reviews. The title of the article may be:
Even if the title of the article is the same as the title of the book, that information is recorded in two different places, once as the <article-title> in the article metadata and once as the <source> inside <product>.
For some journals, the generic phrase like “Book Reviews” may be an article category or eyebrow title rather than part of the title of the article. Such titles are tagged as <subject>s inside <article-categories>. In these cases, the <subject> does not take the place of an <article-title>.
The author of the review should be tagged as the author of the article (<contrib>). The authors of the product being reviewed should be included only within <product>, using <name>, <person-group>, or <string-name> as appropriate. For more guidance, see Tagging Names in Citations. Since <product> element has textual content, it is very like a <mixed-citation>, and the same type of considerations apply.
In many book or product reviews, the <product> element commonly includes:
The attribute @product-type names the type of product being reviewed, for example, “book”, “software”, “article” (journal article), “issue” (journal issue), “website”, “film”.
Note: Since the metadata specified within the <product> element applies to the book or product being reviewed, information concerning other products (for example, products the author might mention for comparison to the primary product), should not be mentioned within the <product> element, but only in the actual body of the review.
<article article-type="product-review" dtd-version="3.0" xml:lang="en" xmlns:xlink="http://www.w3.org/1999/xlink"> <front> <journal-meta> <journal-id>Worm-Runner’s Journal</journal-id> <issn>978-999-999-998X</issn> </journal-meta> <article-meta> <title-group> <article-title>Software package solves everything</article-title> </title-group> <contrib-group> <contrib> <name> <surname>Piez</surname> <given-names>Wendell A.</given-names> </name> </contrib> </contrib-group> <pub-date> <year>2002</year> </pub-date> <product> <name><surname>Mxytlpk</surname> <given-names>Abelard Q.</given-names> </name> <source>Conflagration</source> <year>2002</year> <publisher-name>Venusian Codewrights, Inc.</publisher-name> <price>$3.95</price> </product> <abstract> <p>A software review</p> </abstract> </article-meta> </front> <body> <p>This program will answer all your genome questions. It searches the Web for genetic information of all kinds, correlates it with all other information available anywhere, and reports all functions of a particular genome segment in all known species. And, it’s only $3.95.</p> </body> </article>
<article article-type="book-review" dtd-version="3.0" xml:lang="en" xmlns:xlink="http://www.w3.org/1999/xlink" > <front> <journal-meta> <journal-id>Wildflower Reviews</journal-id> <issn>978-999-999-999X</issn> </journal-meta> <article-meta> <title-group> <article-title>New book walks you through Washington’s vegetation</article-title> </title-group> <contrib-group> <contrib> <name> <surname>Gaylord</surname> <given-names>Tonya R.</given-names> </name> </contrib> </contrib-group> <pub-date> <year>2000</year> </pub-date> <volume>318</volume> <issue>7187</issue> <fpage>837</fpage> <lpage>841</lpage> <product> <name> <surname>Lapeyre</surname> <given-names>Deborah A.</given-names> </name> <name> <surname>Usdin</surname> <given-names>B. Tommie</given-names> </name> <source>Wildflowers of the Washington Area</source> <year>2002</year> <publisher-name>Lippman, Ltd.</publisher-name> <publisher-loc>Bethesda, MD</publisher-loc> <isbn>0-23-8675-309</isbn>, includes a CD-ROM, <price>$19.95</price> (Used 12.50 when available) </product> <history> <date date-type="accepted"> <day>29</day><month>01</month> <year>1999</year> </date> </history> <abstract> <p>A glowing book review</p> </abstract> </article-meta> </front> <body> <p>A must read. Far better than <mixed-citation> <person-group> <name> <surname>Aristotle</surname> </name> </person-group>’s <source>Politics, Poetics, and Wildflowers, Illustrated</source> </mixed-citation>.</p> </body> </article>
When a brief review is provided for a book or article as part of a bibliographic citation (within an <element-citation> or <mixed-citation>), the text is not tagged as a review or as a product, but should instead be tagged as an <annotation>.