F1 Self-Evaluation Project Explanations/pages 031-040

From DPWiki
Jump to navigation Jump to search

031 032 033 034 035 036 037 038 039 040


Without seeing this page in the context of its original project, it's impossible to know that it's the first regular page of the book "NORTH AMERICAN BIRDS." and that the line following it, "Family TURDIDÆ.--The Thrushes." is the title of the first chapter. So, interpreting the first heading as a chapter title and the second heading as a Section is a reasonable way to format them. In an actual project, knowing that it's the book title, you would format it as shown in the model.

The name in that second heading is in boldface, while the rest of the line is in small-caps. Mark each part separately: the boldface is not in small-caps. The first period goes OUTSIDE the tags because it belongs to the "sentence", which is partly in small-caps and partly in boldface. The second period goes INSIDE the tags, because "The Thrushes." is, for formatting purposes, a complete sentence. The em-dash goes outside all of the tags.

The note is in a smaller font, surrounded by extra white space (blank lines), and is a classic example of a Block Quote. The period after "Note" goes INSIDE the tags, as it is part of a one-word complete sentence. The em-dash goes outside the tags.


Quotation marks almost always go outside the in-line tags. The second line contains a rare exception to this: the name is in italics and the quotation marks may be part of that name; whether or not they are, keeping them outside the italics tags would result in an misleading result in Plain Text: _T._ "_parkmanni_" (the name is _T. "parkmanni"_). We would not want to have the opening quotation mark inside italics tags and the closing one outside.

"Habits." is in small-caps and the period is part of the one-word "sentence", so it goes INSIDE the tags.

"C. stellaris" is an italicized name, and the period, which indicates an abbreviation, is part of the first word of that name, so it belongs INSIDE the one set of tags.


"C. stellaris" (see 032 above).

The horizontal line represents a classic thought break: a change of subject within a single Section.

Several paragraphs mid-page are in a smaller font than the regular text, and surrounded by extra white space (blank lines), so they should be enclosed in (one) set of Block Quotes.

"Common Characters." is a complete sentence in small-caps, so the period goes INSIDE the tags.

The same principle applies to the boldface terms at the beginnings of the next two paragraphs.


This was formatted as one Illustration. "PLATE X." is right-justified, so it's tagged as no-wrap. It's in all upper-case, not small-caps.

The captions are in a list, so we make sure it's a one-column list, enclosed in a different set of no-wraps from the Plate number. There are several italicized abbreviations, and their periods go INSIDE the tags because they represent the omitted letters.

Ditto marks and indentation reproduce the appearance of the original text.

The gender symbols are represented by [F] and [M], probably in accordance with the original Project's Comments. They are not footnote anchors.

The closing bracket for the Illustration tag is on a line of its own, because nothing (except a DP [**note]) may be on the same line as a Block tag: /* */ /# #/


A Title page is a "Major Division," so it is preceded by 4 blank lines. (Although that is not explicitly shown in the Guidelines, it often is useful to the post-processors.) Just enclose the text in one set of no-wraps and mark whatever needs in-line formatting; the Post-Processor almost certainly will change whatever vertical spacing you provide, so just leave some blank lines to separate what appear to be the elements of the page.


A List of Illustrations is a "Major Division," so it is preceded by 4 blank lines; the heading is followed by 2 blank lines.

Enclose the list itself in no-wraps. This list was double-spaced for readability; single-spacing it would not be an error (unless the Project Comments specified something), but double-spacing will make final formatting easier for the Post-Processor.

The proofreaders kept or added two spaces between each number and the text. That wouldn't matter with wrappable text (extra spaces can be removed automatically during Post-Processing), but spacing does matter with text that's in no-wraps. The formatter changed them to single spaces, which matches the Table of Contents example in the Formatting Guidelines.


You have to examine this page carefully to find that it contains a paragraph break in which the [Illustration] tag can be placed.

The caption of the illustration is in all-caps, not in small-caps.

The text in italics is part of a sentence, not a complete sentence, so the trailing period belongs to the overall sentence, and goes OUTSIDE the tags.


There are no paragraph breaks on this page, so the [Illustration] tag has to be placed at the very top of the page, preceded by an asterisk and followed by a blank line.

The caption of the illustration is in all-caps, not in small-caps.

Semi-colons are separators; the ones after the first two italicized terms go OUTSIDE the tags.

The period after the third italicized term belongs to the sentence, not to the term, and goes OUTSIDE the tags.


A very simple Index. An Index is a "Major Division" so its heading is preceded by 4 blank lines and followed by 2 blank lines. The rest of the index is enclosed in one pair of no-wraps (per page). Each new letter of an index is considered to be a new Section, so the first entry of each letter should have two blank lines above it.

Even though the page numbers were right-justified, we format them according to our standard rules, and just use a comma and a space to separate them from the text.


This page contains two forms of small-caps: the first is all-caps small-caps like the "AARDVARKS" example in the Words in Small Capitals examples in the Formatting Guidelines (it is not plain all-caps because the letters are squat ... the same height as the regular text's lower-case); the second is mixed-case small-caps.

In both cases, the trailing commas are separators; they are not part of the tagged text and go OUTSIDE the tags.