Periodicals Guide/American Missionary

From DPWiki
Jump to navigation Jump to search

Introduction

About this Periodical

  • Project Manager - ArleneJoyce, Send PM
  • Link to UberProject Thread. As the project has evolved over the years, much of the material in this thread is out of date. The information in this wiki page supersedes the posts in the UberProject Thread.
  • The original source scans can be found here, and were supplemented with scans of the physical volumes where pages were missing from the original scans.
  • This periodical generally follows this format
  1. Title Page with Table of Contents
  2. Association Executives Page
  3. General Content. Single Columned pages generally averaging just over 3000 characters.
  4. Receipts Pages. Double Columned, See Specific Instructions Below on how to Proof/Format these.
  5. Advertisements. These are not in every issue, some issues have them closer to the front.
  • This Periodical is the official Publication of the American Missionary Association. Wikipedia page

Difficulty of Periodical

  • Proofing | Average
  • Formatting | Average (most pages are easy, the receipts and tables are more difficult until you learn the basic TEI markup used)
  • PPing | Average

Proofreading Rounds

  • As of June, 2011 all issues in the system have moved on to Formatting. As of August, 2016, Missing Pages Projects are moving through the rounds. These will add the covers missing from the original scans, as well as a few missed pages. It is possible that issues from years not processed through DP may be added in the future.
  • Available for Proofing
  • Waiting for Proofing
  • Do leave the 'columns' of executives on the second page of the issue as they appear in 'column' format. This makes proofreading easier. Any re-arrangement will take place in the F rounds.

Receipts

  • Do leave a blank line between each donation, but only if donations are on separate lines in the original. Some issues have donations in paragraph form; these should not be separated into individual lines.
  • It is not necessary to indent lines if the only reason they were indented in the original was due to wrapping to fit column width.
  • Do add the decimal point into numerical figures in the amount columns when these aren't present in the scan (e.g. 10 00 becomes 10.00). Do not add decimal places to the amounts in the text columns, but match the scan.
  • Do add leading zeros and the decimal point into numerical figures in the amount columns when the donation is less than one dollar (e.g., 50 becomes 0.50). Do not change the amounts in the text columns, but match the scan.
  • Remove any leading ... before amount columns. The preceding text column should end in a period only if it ends in an abbreviation. The 'c' for cents is not an abbreviation.
  • Some donations are items, not money. Not every entry will have a dollar amount.
Receipts Example

Using the above guidelines, a completed section of receipts should look like this at the conclusion of the P* Rounds.

Example of scanned image: (Note: figures do not add up as this was cobbled together from various pages to show different types of lines.)

Am tableexample forwiki 2.jpg


Proofed text for above image:

NEW YORK, $4,941.44.

Amsterdam. Mrs. Chandler Bartlett        0.50

Meriden. Sab. Sch. of First Cong. Ch.,
for Student Aid, Fisk U., and to const.
D. M. Lyman L. M.           20.00

----, "For the Indians,"      5.00

By Charles Marsh, Treas. Hampden Benev.
Ass'n.

Agawam         19.05

West Springfield. First         29.00

------     380.20

---------- 

$3,741.44

LEGACIES.

Medfield. Estate of Mrs. Abigail Cummings,
by Executor, for Atlanta U.               1,000.00

Worcester. Estate of Benj. W. Fletcher,
by Geo. Swan, Ex.                200.00

---------- 

$4,941.44
Receipt Punctuation Generalizations
  • Anything Abbreviated or Shortened has a full stop immediately after it. Common ones are
  1. Bbls. = Barrels
  2. Bbls. of C. = Barrels of Clothes
  3. U. = University
  4. const. = constituting
  5. L.M. = Life Member
  6. Rev. = Reverend
  7. Cong. = Congregational
  8. Sch. = School
  • Surnames finishing prior to the donation amount don't have a period immediately following.
  • Full stops are present after the name of the city at the start of the donation.

Advertisements

  • Use the Column Guideline. ie - left column first, right column following below.
  • Retain as much information as possible
  • Proof both pointing hand symbols as [hand]

Misc. Comments from Proofers Regarding this Periodical

  • When a new states donations begin it is generally in the format of <StateName>, $000.00. On a couple of occasions the comma between the State and $ missing. Flagging such instances with a [**note] explaining it is normally present but missing on this occasion is probably a good idea. Nick0252 06:30, 6 July 2007 (PDT)

Formatting Rounds

Tables

This project uses TEI markup for the Receipts table. Prior to August 2016, instructions were to use TEI for all tables with dollar values. Currently, standard table markup should be used for tables other than the Receipts. If TEI markup has been used for other tables formatted prior to this change, it is not necessary to change it.

Thought Breaks

  • Use <tb> markup wherever there is a horizontal line indicating one in the original text, including before section and article titles. Use the thought break as the last line of the previous article (blank line, thought break). Then treat major sections with 4/2 blank lines (as chapters) and preface the articles with two blank lines (as sections).

New Appointments

New Appointments are typically in the February issues. The New Appointments section is a major section with 4 blank lines before and 2 blank lines after. The hierarchy of the appointments list is:


The Missionary Field (2 blank lines before)

The State (2 blank lines before)
The City (2 blank lines before)
(where appropriate) school or institute (2 blank lines before)
(sometimes omitted) Job Title or Department, italicized (1 blank line before)


Note that there are typically horizontal lines before the major sections, before the missionary fields, before the states, and before the cities. Record these as thought breaks (<tb>). Include a thought break everywhere you see a horizontal line, even a small one. Sometimes a new column begins just before a new city (for example), and so there is an implied thought break. If it is clear to you that there would have been a horizontal line if the column had continued down the page, add it.

When adding thought breaks, consider the thought break to be the end of the preceding section, and separated from it by one blank line. The 2 or 4 lines preceding the next heading come after the thought break. This is exactly how thought breaks are handled in the rest of the project.

Under each job title or department are names with their respective cities. Enclose each list in nowrap markup, even when there is only one entry. Make the lists a single column. Separate the name and the city by at least 6 blank spaces. When the name and the job title are on the same line, keep the name and job title together in the first column, and the state and city together in the second column, with 6 spaces between the columns. An example of this can be found in at the very bottom of the complete example below.

(blank line)
(blank line)
(blank line)
(blank line)
NEW APPOINTMENTS.
(blank line)
1881-1882.
(blank line)
(blank line)
Here is an introductory paragraph that goes on for several lines.
(blank line)
(blank line)
THE SOUTHERN FIELD
(blank line)
<sc>Rev. J. E. Roy</sc>, D. D., Field Superintendent.
(blank line)
(blank line)
DISTRICT OF COLUMBIA.
(blank line)
(blank line)
WASHINGTON.
(blank line)
Theological Department, Howard University.
(blank line)
/*
Rev. W. W. Patton, D. D.,      Washington, D. C.
" J. G. Craighead, D. D.,      " "
Rev. J. E. Rankin, D. D.,      Washington, D. C.
" John G. Butler, D. D.      " "
*/
(blank line)
(blank line)
LINCOLN MEMORIAL CHURCH.
(blank line)
Pastor.
(blank line)
/*
Rev. S. P. Smith,      Chicago, Ill.
*/
(blank line)
Special Missionary.
(blank line)
/*
Mrs. C. B. Babcock,      Newburyport, Mass.
*/
(blank line)
<tb>
(blank line)
(blank line)
VIRGINIA.
(blank line)
(blank line)
HAMPTON.
(blank line)
Minister.
(blank line)
/*
Rev. H. B. Frissell,      New York City.
*/
(blank line)
(blank line)
NORMAL AND AGRICULTURAL INSTITUTE.
(blank line)
Instructors and Managers.
(blank line)
/*
Gen. S. C. Armstrong,      Hampton, Va.
Gen. J. F. B. Marshall, Treasurer,      " "
Mr. Albert Howe, Farm Manager,      " "
" F. C. Briggs, Business Agent,      " "
" J. B. H. Goff, Engineer,      " "
" C. W. Betts, Printing Office,      Wilmington, Del.
*/

Receipts

  • Receipts tables are to be processed using TEI markup.
  • Each state should be treated as a separate table.
  • It isn't necessary to open and close tables per page (it's not like /* */ markup). Open and close per state or section.
  • Most rows will have a text column and an amount column, and so will have 2 cells. Most of of the text cells contain 1-5 lines. Some of the issues format the receipts in very long paragraphs rather than as individual lines. Format them with TEI markup in the same manner, enclosing each paragraph in <cell></cell> markup. Some of these cells will be very, very long.
  • Not all rows will have an amount column. If the donation is something other than money, the column where the amount would be is blank. Create one cell for the text. There is no cell for the empty amount. See the By Charles Marsh.... line in the example below.
  • If the left side entry on a particular line is indented (the WHOLE entry, not just the second line of a line wrap ... (see the Agawam and West Springfield entries in the example below), then use two spaces after the <cell> tag to indicate this. Do not use additional spaces at the beginning of wrapped lines of this cell, if it continues onto multiple lines. The last page of the Receipts normally has several tables with subtotals and totals that are indented from the left margin. Replicate the indentions with spaces as we do for poetry. It is not necessary to replicate with an exact number of spaces, but just to show relative indentation, using 2, 4, 6, or 8 spaces after the <cell> markup and before the text.
  • If a dollar amount is indented back from the right edge, use <cell rend="left">, as in Agawam and West Springfield entries in the example below.
  • If the column does not represent a donation, but instead extends across both columns, use cols="2" to cause it to span both columns. If it also is to be centered, center it using both rend="center" and cols="2" as shown in the LEGACIES line in the below. If the text is to be right shifted, with nothing in the left column, use both rend="right" and cols="2". See the final underline and total in the example below.
  • You can use this page to preview the results of your TEI markup. Note that the cells marked with rend="left" will not match the original alignment, but this is fine; the "left" will be converted to correct final markup during PPing. If you want to check whether you remembered to open and close each tag, you can use the W3Schools XML Validator to check, although you will need to add extra surrounding tags and handle any mismatched <table> tags. This is absolutely not required, but listed here only as a help.
Receipts Example

Example of scanned image: (Note: figures do not add up as this was cobbled together from various pages to show different types of lines.)

Am tableexample forwiki 2.jpg


Proofed text from example in proofing section above (except that an extra line has been added after West Springfield to improve the formatting example):

NEW YORK, $4,941.44.

Amsterdam. Mrs. Chandler Bartlett        0.50

Meriden. Sab. Sch. of First Cong. Ch.,
for Student Aid, Fisk U., and to const.
D. M. Lyman L. M.           20.00

----, "For the Indians,"      5.00

By Charles Marsh, Treas. Hampden Benev.
Ass'n.

Agawam         19.05

West Springfield. First        
Cong. Ch.                           29.00

------     380.20

----------

$3,741.44

LEGACIES.

Medfield. Estate of Mrs. Abigail Cummings,
by Executor, for Atlanta U.               1,000.00

Worcester. Estate of Benj. W. Fletcher,
by Geo. Swan, Ex.                200.00

----------

$4,941.44

Formatted text for example above:

<table>
<head>NEW YORK, $4,941.44.</head>

<row>
<cell>Amsterdam. Mrs. Chandler Bartlett</cell>
<cell rend="right">0.50</cell>
</row>

<row>
<cell>Meriden. Sab. Sch. of First Cong. Ch.,
<i>for Student Aid, Fisk U.</i>, and to const.
<sc>D. M. Lyman</sc> L. M.</cell>
<cell rend="right">20.00</cell>
</row>

<row>
<cell>----, "For the Indians,"</cell>
<cell rend="right">5.00</cell>
</row>

<row>
<cell>By Charles Marsh, Treas. Hampden Benev.
Ass'n.</cell>
</row>

<row>
<cell>  Agawam</cell>
<cell rend="left">19.05</cell>
</row>

<row>
<cell>  West Springfield. First
Cong. Ch.</cell>
<cell rend="left">29.00</cell>
</row>

<row>
<cell rend="left">----</cell>
<cell rend="right">380.20</cell>
</row>

<row>
<cell rend="right" cols="2">------</cell>
</row>

<row>
<cell rend="right" cols="2">$3,741.44</cell>
</row>


<row>
<cell rend="center" cols="2">LEGACIES.</cell>
</row>

<row>
<cell>Medfield. Estate of Mrs. Abigail Cummings,
by Executor, <i>for Atlanta U.</i></cell>
<cell rend="right">1,000.00</cell>
</row>

<row>
<cell>Worcester. Estate of Benj. W. Fletcher,
by Geo. Swan, Ex.</cell>
<cell rend="right">200.00</cell>
</row>

<row>
<cell rend="right" cols="2">------</cell>
</row>

<row>
<cell rend="right" cols="2">$4,941.44</cell>
</row>
</table>

Advertisements

For standard projects finishing the rounds, separate each advertisement, regardless of size, with a thought break, surrounded as usual by blank lines. For the missing pages projects, please use the standard guidelines of 4 lines before full- and half-page ads, and two lines before smaller ads.

Post Processing Guidelines

  • ArleneJoyce has PPed many of these issues and will be happy to help anyone who wishes to try one. PM her She also has a program which converts the TEI markup for the Receipts section into text appropriate for the utf8 text version. Until this program is generally available, she can create the text of the Receipts section if the post-processor finds that task tedious.
  • Both a text and an html version are required. The purpose of this style guide is to ensure a consistent look across all remaining issues of American Missionary, and to document tried-and-true methods of formatting which work for browsers, epub, and Kindle versions. This guide was developed for projects with guiguts. Projects using other tools (e.g. ppgen) may use different CSS to achieve the same visual effects.
  • The first posted issues to use this CSS template and formatting guidelines are the January 1878 and February 1878 issues. These, and issues posted later, can be used to see how the CSS is used. As the template and standards continue to evolve, these early issues may not implement all of the guidelines.


Unicode Notes

Use utf8 characters to provide curly quotes, use the mdash for dashes in both the text and html versions. Use the left- and right-pointing hand characters in the text version, but small inline illustrations in the html version.

Page Numbers

Page numbers run consecutively from issue to issue for the entire year. The first two images (generally the table of contents and the list of officers) are not paginated. Neither are the last two images, which represent the inside and outside of the back cover.

Standard CSS Template

Begin the construction of the html version with the following CSS, which is used in the examples in these guidelines:

  <style type="text/css">

    body {margin-left: 10%; margin-right: 10%;}
    h1,h2,h3,h4,h5 {text-align: center;}

    div.center table  {margin: 0 auto; text-align: left;}
    div.advertisement {margin-top: 2em; margin-bottom: 2em; margin-left: 10%; width: 80%;}
    div.article {page-break-before: always;}
    div.half {display: inline-block; width: 49%; vertical-align: top;}
    div.third {display: inline-block; width: 32%; vertical-align: top;}
    div.tthirds {display: inline-block; width: 60%; vertical-align: top;}
    div.quarter {display: inline-block; width: 24%; vertical-align: top;}

    hr         {margin-top: 1em; margin-bottom: 1em;}
    hr.full    {width: 98%; margin-left : 1%; margin-right: 1%; margin-top: 0em; margin-bottom: 0em;}
    hr.chap    {width: 65%; margin-left: 17.5%; margin-right: 17.5%;}
    hr.tb      {width: 45%; margin-left: 27.5%; margin-right: 27.5%;}
    hr.quarter {width: 26%; margin-left: 37%; margin-right: 37%;}
    hr.tenth   {width: 10%; margin-left: 45%; margin-right: 45%;}
    hr.tiny    {width: 10%; margin-left: 45%; margin-right: 45%;  margin-top: .5em; margin-bottom: .5em;}
    hr.top     {margin-bottom: .25em;}
    hr.bottom  {margin-top: .25em;}
		
    img {max-width: 100%; height: auto;}

    p {text-align: justify; margin-top: .51em; margin-bottom: .49em;}
    p.amrole {text-align: center; font-style: italic; margin-top: 1em; margin-bottom: .5em;}
    p.nomargin {margin-top: 0em; margin-bottom: 0em;}
    p.indent {text-indent: 1em;}
    p.drop-cap {text-indent: 0em;}
    p.drop-cap:first-letter {
      float: left;
      margin: 0em 0.1em 0em 0em;
      font-size: 250%;
      line-height:0.85em;
   }

    table             {margin-left: auto; margin-right: auto;}
    table.receipts    {width: 85%; border: none;}
    table.toc         {margin-left: 10%; width: 85%; border: none;}
    table.sigs        {margin-right: 10%; margin-left: auto; border: none; font-variant: small-caps;}
    table.sigs td     {padding-left: 10px; padding-right: 10px;}
    table.subtab      {margin: 0%; width: 90%;}

    td.statehead      {text-align: center;  padding-top: 1em; padding-bottom: .6em;}
    td.sub1           {margin-left: 1em; padding-left: 1em; text-indent: -1em;}
    td.sub2           {margin-left: 1em; padding-left: 2em; text-indent: -1em; }
    td.total          {margin-left: 1em; text-indent: 2em;}
    td.ramt           {text-align: right; vertical-align: bottom;}
    td.tdpr           {padding-right: 10px; vertical-align: top;}

    ul { list-style-type: none; padding-left: 20px;}

    .xxxlarge {font-size: 200%;}
    .xxlarge  {font-size: 170%;}
    .xlarge   {font-size: 140%;}
    .large    {font-size: 120%;}
    .larger   {font-size: 110%;}
    .medium   {font-size: 80%;}
    .small    {font-size: 65%;}
    .xsmall   {font-size: 50%;}

    .blockquot   {margin-left: 5%; margin-right: 10%;}
    .box         {border-color: black; border: solid; }
    .caption     {font-weight: bold;}
    .center      {text-align: center;}
    .centerline  {text-align: center; display: inline-block;}
    .chapline    {font-variant: small-caps; padding-left: 2em; text-indent: -1em;}
    .chaplinei   {font-variant: small-caps; padding-left: 5em;  text-indent: -1em;}
    .chaplinen   {font-variant: normal; font-size: small;}
    .conthead    {text-align: center; line-height: 3em;}
    .figcenter   {margin: auto; text-align: center;}
    .figmargin   {margin-bottom: 2em; margin-top: 2em;}
    .float-left  {display: inline-block; text-align: left; width: 49%;}
    .float-right {display: inline-block; text-align: right; width: 49%;}
    .forty       {width: 39%;}
    .hang        {padding-left: 3em; text-indent: -2em;}
    .inline      {display: inline-block; vertical-align: top;}
    .left        {text-align: left;}
    .linenum     {text-align: right; vertical-align: bottom;}
    .normal      {font-variant: normal; font-weight: normal; font-style: normal;}
    .organ-left  {display: inline-block; vertical-align: top; width: 39%; margin: auto; max-width: 40%;}
    .organ-right {display: inline-block; vertical-align: top; width: 59%; margin: auto; max-width: 60%;} 
    .p1          {margin-top: 1em;}
    .pagenum     {position: absolute; left: 91%; right: 1%; font-size: smaller; text-align: right;}
    .position    {font-variant: small-caps; font-size: 70%; text-align:center; }
    .right       {text-align: right;}
    .section     {font-weight: bold; text-align: center;}
    .secauth     {font-size: 70%; text-align: center;}
    .sixty       {width: 59%;}
    .smcap       {font-variant: small-caps;}
    .toc-chapter {line-height: 2em;}
    .wrap        {text-align: center;}
    .vtop        {vertical-align: top;}

    .gesperrt   {letter-spacing: 0.2em; margin-right: -0.2em;}
    em.gesperrt {font-style: normal;}

    .footnote         {margin-left: 10%; margin-right: 10%; font-size: 0.9em;}
    .footnote .label  {position: absolute; right: 84%; text-align: right;}
    .fnanchor         {vertical-align: super; font-size: .8em; text-decoration: none;}

    .poem          {margin-left:10%; margin-right:10%; text-align: left;}
    .poem br       {display: none;}
    .poem .stanza  {margin: 1em 0em 1em 0em;}
    .poem span.i0  {display: block; margin-left: 0em; padding-left: 3em; text-indent: -3em;}
    .poem span.i1  {display: block; margin-left: 0.5em; padding-left: 3em; text-indent: -3em;}
    .poem span.i2  {display: block; margin-left: 1em; padding-left: 3em; text-indent: -3em;}
    .poem span.i4  {display: block; margin-left: 2em; padding-left: 3em; text-indent: -3em;}
    .poem span.i12 {display: block; margin-left: 6em; padding-left: 3em; text-indent: -3em;}
    .poem span.i14 {display: block; margin-left: 7em; padding-left: 3em; text-indent: -3em;}
    .poem span.i16 {display: block; margin-left: 8em; padding-left: 3em; text-indent: -3em;}

    @media handheld {
      p.drop-cap:first-letter {float: none; margin: 0; font-size: 100%;}
      div.advertisement {page-break-inside: avoid;}
      table.receipts {width: 100%; border: none;}
      table.singer {margin-left: 25%;}
      .organ-left  {display: block; text-align: center;  margin: auto; min-width: 100%;}
      .organ-right {display: block; text-align: center;  margin: auto; min-width: 100%;} 
   }

  </style>

Eliminate any unused CSS at the end of formatting. If new CSS is required for more than a single issue, or a better formatting solution is found, please PM Arlene so we can add it to the standard template.

Front Matter

There is an outside and an inside cover for most issues. The outside cover typically contains a header with a stylized "American Missionary" heading, followed by the table of contents, and the publishing information. The table of contents consists of several major sections with articles, following by sections without articles. The inside cover typically lists the officers for the American Missionary Association, but is sometimes replaced by an illustration.

Outside Cover: Text Version

Center text from all the decorative headings, followed by the table of contents. Center the CONTENTS header. Major sections (EDITORIAL, THE FREEDMEN, etc.) should be preceded by two blank lines and followed by one blank line. Major sections in the table of contents should be indented two spaces from the left, with articles below them indented two more spaces and single-spaced. Page numbers should be moved to the right margin and right-aligned.

Outside Cover: HTML Version

Using the cover image, remove all the extra space between the sections to reduce the height so that the cover can be produced at 600x800px. Use this colored cover for the mobile versions. Duplicate this information in textual format at the beginning of the html file, matching spacing and approximate relative font sizes.

Produce the text-based table of contents in a single column rather than duplicating the two-column format of the cover. As in the original, major headings with articles below them are centered; major headings without articles are left-justified. Link the table of contents page numbers to the correct page numbers in the text. Major headings will have an "h2" level and articles will have an "h3" level. This ensures that the table of contents generated by for the mobile files will reflect the correct structure of the document.

Inside Cover: Text Version

Separate each position title with two blank lines above and one below. Indent the position titles two spaces and the individual names 4 spaces. The individual's names are single-spaced lists, one column wide.

Inside Cover: HTML Version

Duplicate as much as possible the layout of the page, using two and three columns as in the original. The "position" class is for formatting the position headings. Using tables with the "tdpr" class results in good formatting for smaller screens in browsers, and also in the epub version. For example:

<p class="position">EXECUTIVE COMMITTEE.</p>

<table><tr>
<td class="tdpr">
  <span class="smcap">Alonzo S. Ball</span>,<br />
  <span class="smcap">A. S. Barnes</span>,<br />
  <span class="smcap">Edward Beecher</span>,<br />
  <span class="smcap">Geo. M. Boynton</span>,<br />
  <span class="smcap">Wm. B. Brown</span>,
</td>
<td class="tdpr">
  <span class="smcap">Clinton B. Fisk</span>,<br />
  <span class="smcap">A. P. Foster</span>,<br />
  <span class="smcap">Augustus E. Graves</span>,<br />
  <span class="smcap">S. B. Halliday</span>,<br />
  <span class="smcap">Sam’l Holmes</span>,
</td>
<td class="tdpr">
  <span class="smcap">S. S. Jocelyn</span>,<br />
  <span class="smcap">Andrew Lester</span>,<br />
  <span class="smcap">Chas. L. Mead</span>,<br />
  <span class="smcap">John H. Washburn</span>,<br />
  <span class="smcap">G. B. Willcox</span>.
</td></tr>
</table>

Issue Banner: Text Version

The first actual page of each issue begins with a banner documenting the date and issue. The text version should be surrounded with thought break lines, and centered:

                *       *       *       *       *

       VOL. XXXII.     JUNE, 1878.      No. 6.

                *       *       *       *       *

Issue Banner: HTML Version

The first actual page of each issue begins with a banner documenting the date and issue. The following markup (using the CSS above) will result in an issue banner that is compatible with epub and Kindle formats, and will look like the text banner in the previous section.

<hr class="full" />
<div>
<div class="third" style="padding-left: 2%"><span class="smcap">Vol.</span> XLI.</div>
<div class="third center">JULY, 1887.</div>
<div class="third right">No. 7.</div>
</div>
<hr class="full" />

Articles and Sections

Major sections are those listed in the table of contents as major headings, typically including EDITORIALS, AFRICA, COMMUNICATIONS, THE CHILDREN'S PAGE, and RECEIPTS, among others. The Contents and Transcriber's notes are also major sections. See the section on Advertisements for the handling of breaks between them.

Text Version

Precede each major section with four blank lines before the major section title, and two blank lines after. Precede each article, and each titled section within an article, with two blank lines before the title. Follow each major section and each article, except the Transcriber's notes, with a blank line and a row of thought-break asterisks. Use a thought break for each breaking line in each article.

HTML Version

Precede each major section with a full-width horizontal rule (<hr class="full" />). Precede each article with a 65%-width horizontal rule (<hr class="chap" />). Use a 45%-width horizontal rule (<hr class="tb" />) for dividing lines within articles. The "tenth", "quarter", and "tiny" classes may be needed for dividing lines in lists, tables, or advertisements.

Enclose the title for each major section in <h2> tags. Enclose each article title in <h3> tags, even when articles are combined on the same lines in the table of contents. Article divisions should use <h4>, then <h5>, and even <h6> tags if necessary to duplicate the structure of the article. The use of these tags, rather than markup which duplicates the formatting, allows ePub to create the appropriate navigable document outline.

Enclose each article, including its title, in <div class="article"></div> tags. This helps to prevent unexpected and unwanted page breaks in the ePub version.

The classes noted here apply when using the standard CSS template.

Illustrations

Receipts

The Receipts section is a major section. Treat its heading in the same manner as any other major section.

Text Version

Each state heading is preceded by two blank lines and indented two spaces. The first line of each entry is indented four spaces. If the entry continues onto multiple lines, subsequent lines are indented 6 spaces, creating a "hanging" effect. The text column of the entries must be separated from the amounts column by at least 6 spaces. The amounts are right-aligned, ending in column 67. Unicode mdash characters are used to create underlines. Total labels indented in the original text are indented 8 spaces.

HTML Version

Enclose each state in its own <table class="receipts"></table> tags. Enclose each state heading in <td class="statehead" colspan="2"></td> tags. The left text column has a class of "sub1" and the right amount column has a class of "ramt". Totals and other indented entries can use the class "sub2". There are sometimes extra non-state tables at the end of the state receipts which can be treated in the same manner. A short example:

<table class="receipts">
<tr>
<td class="statehead" colspan="2">MAINE, $5725.</td>
</tr>

<tr>
<td class="sub1">Andover. Mrs. E. P.</td>
<td class="ramt">1.00</td>
</tr>

<tr>
<td class="sub1">Bangor. First Parish Sab. Sch.</td>
<td class="ramt">6.00</td>
</tr>

<tr>
<td class="sub1">Bath. “Friend” $50; Mrs. J. C. 25c</td>
<td class="ramt">50.25</td>
</tr>
</table>

Advertisements: Text Version

Separate the advertisements with thought breaks surrounded by two blank lines above and two blank lines below. Avoid using thought breaks inside the advertisements, using an extra blank line to separate sections if needed. Duplicate the general look of the ad, centering and right-shifting text as necessary. Very heavily marked up text may need to have the markups removed to be readable. If this is necessary, add an entry to the Transcriber's Notes to indicate this change.

Advertisements: HTML Version

Surround each advertisement with some extra white space and a full-width horizontal rule. Using the CSS from the standard template above:

<div class="advertisement"></div>

and separate them with

<hr class="full" />

Format the ads similarly to the original, centering and shifting text, using different font sizes, and bold as needed. Use small illustrations for left- and right-pointing hands. Include all images, but generally provide the text as actual text. A few of the ads (e.g. Marvin's Safes) are better represented completely as images, as the presentation of the text is artwork designed to express the character of the company or the product. Use this technique only when the image contributes an important part of the marketing message, as it is desirable that the text and html versions be as identical as possible.

Transcriber's Notes

Transcriber's notes are a major section, and treated as such. The notes should begin with a comment similar to : "Punctuation, spelling and grammar were changed only where the error appears to be a printing error. The punctuation changes are too numerous to list; the others are as follows:". This is followed by each correction made, listing the original text, corrected text, original page, and enough context to search for the correction. In the html version, the context should be linked back to the location in the text, for example:

<p>“aud” changed to “and” on page 160 (<a href="#Err_4">Hall Chairs and Hanging Glasses</a>).</p>

Mobile tips

  • The Standard CSS Template concludes with a @media handheld section that adjusts the CSS for ePub and Kindle versions.
  • Kindle does not support colspan, so centered table-headings (e.g. the State headings in the Receipts) will appear left-aligned.
  • Kindle does not support the right-aligning of text, so receipt amounts will be left-aligned, although they will remain in their own column.
  • Avoid using float. The Standard CSS Template uses float for drop-caps, but uses the @media handheld section at the end of the CSS to remove the float.
  • The inline-block attribute often causes page breaks in ePub and Kindle versions. Surrounding the separated elements with a div will often solve the problem.
  • Poetry and signatures at the end of an article often cause unwanted page breaks in ePub and Kindle versions. Enclose the entire article or section in a div to control the breaking. A page break will then likely occur where the div begins.

Completed Issues