The Mailer Review/Volunteer/Remediating Articles: Difference between revisions

m (→‎Sourcing: Added note.)
 
(2 intermediate revisions by 2 users not shown)
Line 2: Line 2:
{{Large|A Guide for Volunteer Digital Editors}}
{{Large|A Guide for Volunteer Digital Editors}}
{{shortcut|PM:RA}}
{{shortcut|PM:RA}}
{{Byline|last=Lucas|first=Gerald R.|abstract=A digital editor’s guide for remediating print articles to digital for ''{{MR}}''.}}
{{Byline|last=Lucas|first=Gerald R.|abstract=A digital editor’s guide for remediating print articles to digital for ''{{MR}}''. |url=http://prmlr.us/remediate}}
{{TOC right}}
{{TOC right}}
Welcome, volunteer, or Assistant Digital Editor. We’re glad you decided to lend your expertise and time in helping to grow our Digital Humanities project. This guide is written specifically for volunteer digital editors who want to help in moving, or “remediating,” our print version of ''{{MR}}'' to the digital version here on Project Mailer. Please read this document in for specific directions on remediating your article to be used on the screen.
Welcome, volunteer, or Assistant Digital Editor. We’re glad you decided to lend your expertise and time in helping to grow our Digital Humanities project. This guide is written specifically for volunteer digital editors who want to help in moving, or “remediating,” our print version of ''{{MR}}'' to the digital version here on Project Mailer. Please read this document in for specific directions on remediating your article to be used on the screen.
Line 91: Line 91:
== Body ==
== Body ==
[[File:Mr-orig.jpg|thumb|400px|'''Fig 3'''. Original PDF. Copy the paragraph.]] [[File:Mr-errors.jpg|thumb|400px|'''Fig 4'''. Errors indicated.]] [[File:Mr-corrected.jpg|thumb|400px|'''Fig 5'''. Errors Fixed.]]
[[File:Mr-orig.jpg|thumb|400px|'''Fig 3'''. Original PDF. Copy the paragraph.]] [[File:Mr-errors.jpg|thumb|400px|'''Fig 4'''. Errors indicated.]] [[File:Mr-corrected.jpg|thumb|400px|'''Fig 5'''. Errors Fixed.]]
Here is where you remediate from PDF (essentially the printed page) to the wiki. Adding the body of the article will take the most effort and attention to detail, as many typos are introduced into the digital text as part of the PDF creation process. I recommend proceeding paragraph by paragraph.
Here is where you remediate from PDF (essentially the printed page) to the wiki. Adding the body of the article will take the most effort and attention to detail, as many typos are introduced into the digital text as part of the PDF creation process. I recommend proceeding paragraph by paragraph, as pasting the whole essay into the article and then trying to edit it will just be overwhelming. Take this a step at a time to maximize your attention to perfection.


Open the PDF, highlight and copy a paragraph, paste the paragraph into the editing window, and proofread for errors (see '''Figs. 3–5'''; click the images to enlarge). Common errors include hyphenated words (these will be broken words with a hypen and space), numbers, lack of necessary text decoration like italics, missing spaces, and superfluous print information like page numbers. All of these must be corrected. Use the original PDF as your guide. All text needs to be verbatim and look as much like the original document as possible.
Open the PDF, highlight and copy a paragraph, paste the paragraph into the editing window, and proofread for errors (see '''Figs. 3–5'''; click the images to enlarge). Common errors include hyphenated words (these will be broken words with a hypen and space), numbers, lack of necessary text decoration like italics, missing spaces, and superfluous print information like page numbers. All of these must be corrected. Use the original PDF as your guide. All text needs to be verbatim and look as much like the original document as possible.
Line 165: Line 165:


<blockquote>
<blockquote>
<code><nowiki>This novella was first published in ''New Short Novels 2'', 1956.{{sfn|Lennon|2018|p=25}}</nowiki></code>
<code><nowiki>. . . first published in ''New Short Novels 2'', 1956.{{sfn|Lennon|2018|p=25}}</nowiki></code>
</blockquote>
</blockquote>


This is a Wikipedia template. “Sfn” calls the template in the code; the author’s last name follows the first pipe (this must correspond with the name that follows <code><nowiki>|last=</nowiki></code> in the detailed citation in your works cited list); the year of the publication follows the next (exactly the same as <code><nowiki>|date=</nowiki></code> in the citation); and the page number(s) are put last. This will insert a footnote in the text; when a user clicks it, she is taken to the citation and if she clicks the citation, she is taken to the longer works cited entry. Notice its placement in the text: right up against the period with no space in between. Footnote indications should always come after punctuation; never before. Try it on the example article I linked above. Simple and elegant.
This is a Wikipedia template. “Sfn” calls the template in the code; the author’s last name follows the first pipe (this must correspond with the name that follows <code><nowiki>|last=</nowiki></code> in the detailed citation in your works cited list); the year of the publication follows the next (exactly the same as <code><nowiki>|date=</nowiki></code> in the citation); and the page number(s) are put last. This will insert a footnote in the text; when a user clicks it, she is taken to the citation and if she clicks the citation, she is taken to the longer works cited entry. Rendered on the page, it will look like:
 
: . . . first published in ''New Short Novels 2'', 1956.{{sfn|Lennon|2018|p=25}}
 
Notice its placement of the footnote code: '''right up against the period with no space in between'''. Footnote indications should always come ''after'' punctuation; never before. Try it on the example article I linked above. Simple and elegant.


See the [[w:Template:Sfn|Template:Sfn]] on Wikipedia for more options and explanation.
See the [[w:Template:Sfn|Template:Sfn]] on Wikipedia for more options and explanation.