Spring 2020: HTML Proofing

Spring 2020: HTML Proofing

These are the updated instructions for HTML proofing the final contextual material for the February project launch party.

We are using this HTML Proofing Project Board to track each item's progress.

Tips for Using the Project Board:

• Each column scrolls vertically when you hover over it.
• Sometimes when you first open a Project Board, there is a large green panel obscuring the screen; you can "X" out of this for improved visibility.
• Please move each item to the next column when you have completed a task. (Click and drag the card to move between columns.)
• Be mindful of not moving cards between columns accidentally.

Preparing to Proof

1. Download HTML file to be proofed from the "Proofing Materials" link on the item's Project card.

   • Be sure that the file has a .html filename extension.

2. Have the facsimile images + .docx transcription of the original document ready to view (from "Proofing Materials" link, or on Dropbox).

3. Download main.css in the same folder where you downloaded the HTML.

   • The CSS file must be in the same folder as the HTML file in order for you to see the proofing styles.**
   • Be sure that the file has a .css filename extension.
   • See Downloading Files on GitHub if you need a refresher.

Note: If you have HTML proofed in the past, you may notice that this step has been simplified: you will no longer need to edit any lines of the HTML.

Proofing HTML

1. Open the HTML file that you downloaded in your web browser (Chrome, Firefox, etc.) by double-clicking on it, or by right clicking on the file, choosing Open With and select your web browser.

2. Check for the following aspects in the HTML reading view in your browser:

1️⃣ Reference the .docx transcription and facsimile image(s) to confirm that all components of the document are represented (dates, signatures, postscripts, etc.)

2️⃣ Reference the .docx transcription and facsimile image(s) to confirm that paragraph breaks are accurate

3️⃣ Reference the .docx transcription to confirm that all translator and editor notes are appearing

4️⃣ Check people and place tags (hover over text in green to confirm that tags are correct, i.e. Paris is not tagged as "Dresden" etc.; also note if anything should be tagged that isn't)

5️⃣ Confirm that all tagged people, strikethroughs, etc. are present in both original and translation

6️⃣ Look for general typos and errors

7️⃣ Review header information

8️⃣ Check for any encoder comments in the XML file

3. Mark any errors or questions on the Spring 2020 Archival HTML Proofing spreadsheet.

   • Each item has its own sheet at the bottom of the spreadsheet page.

4. If you are comfortable editing XML, make corrections directly to the XML file on GitLab (linked to directly on the Project Board). Still mark the error on the spreadsheet, along with how you corrected it under "Change Made and By Whom."

   • If you would rather someone else correct the XML, just fill in the green columns and under "Needs Further Attention From" mark Encoder.
   • If you have encountered an issue that needs Caroline's attention, write Caroline under "Needs Further Attention From."

5. Move item to next stage on the Encoding Project Board.

** Please note that you will not make any changes to the HTML file. The HTML file is a disposable simulation of how the item will appear on the website; the only file that will be updated is the XML file on GitLab. **

Feel free to review Git/GitHub or encoding instructions on the Fall 2019 EL Class Page here.