Difference between revisions of "The Mailer Review/Volunteer/Translating Articles"

From Project Mailer
Jump to navigation Jump to search
m (More detail.)
m (→‎Header: Added more. Tweaks.)
(One intermediate revision by the same user not shown)
Line 42: Line 42:
  
 
== Header ==
 
== Header ==
The first item added
+
Next, you need to insert the proper header for the volume, in the form of <code><nowiki>{{MRxx}}</nowiki></code> where “xx” is the two-number volume. For example, volume 12 would be <code><nowiki>{{MR12}}</nowiki></code>.
 +
 
 +
Anything surrounded with double brackets calls a [[w:Help:A quick guide to templates|template]] to be [[w:Wikipedia:Transclusion|transcluded]]. Basically, templates are bits of code or boilerplate that can be used on multiple pages. This saves us from having to repeat the same information on multiple pages.
 +
 
 +
This header should appear on the top of all ''Review'' content.
  
 
== Byline ==
 
== Byline ==

Revision as of 12:16, 30 June 2020

A Guide for Volunteer Digital Editors

Written by
Gerald R. Lucas
Abstract: A digital editor’s guide for translating print articles to digital for The Mailer Review.

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 “translating,” our print version of The Mailer Review to the digital version here on Project Mailer. Please read this document in for specific directions on translating your article to be used on the screen.

We use the word “translating” here to emphasize that reading on paper is a different activity than reading on the screen. In fact, we might say that we don’t really read articles on the screen at all: we use them. So, how do we translate a document from a medium that emphasizes a sit-back, passive activity to one that promotes a lean-forward, active one? Documents meant to be used on the screen should have different qualities than paper documents. This guide breaks down the qualities we should consider when creating a digital document on this site. We try to cover most items, but being a digital editor often requires us to make it up as we go along.

When we translate, we should always keep this question in mind: what is the most logical way to make this document fit the expectations of those who will be using it? Let’s try to detail our current approach.[a]

I will try to include everything you need on this document, but I will often link to Wikipedia for more detailed explanations of certain concepts and procedures. I hope that you will not need these additional resources, but they are there for further clarification if necessary. I recommend opening links in tabs, so you don’t get lost, and you can keep certain tabs open for reference.

Get Started

The first order of business is to request an account and get your first article for editing. These are both accomplished by sending an email to editor@projectmailer.net; they both could be done in the same email.

If you’re brand new to MediaWiki, the software that runs this web site, you should take a couple of tutorials to familiarize yourself with some of the basics. Begin with Wikipedia’s Help:Introduction which will take you through a series of tutorials designed to familiarize you with the essentials.[b] Take the tutorials on the source editor (not the visual) which uses wiki markup, as that is the only available editor on PM.

Get Your Account

First off, you need to request an account. If you have a particular user name in mind, let me know. Mine is Grlucas, but yours can be anything you’d like. I will create an account for you with a temporary password using the email address you sent the request with. You will need to confirm your account, log in, and change your password. Then, you’re ready to edit.

Get Your Article

Begin your journey by requesting an article from the editor. If you have no preference, just send an email to editor@projectmailer.net and ask for the next article, or request a red link article (meaning it needs to be added) from any volume available, being sure to give the volume number. I will send you the article as a PDF, including an abstract (if it has one) and writer biography.[c]

Before Editing

Fig 1. The editor.

An obvious way to approach this task would be to look at an example article to see how another digital editor translated it, like Andrew M. Gordon’s “Mailer’s Use of Wilhelm Reich,” or really any of the other available texts. If you go to the page, you can click the “Edit” tab to get to the editor and review all of the wiki coding that presents the usable text (see Fig 1).

The rest of this document breaks down each of the common elements that every article will use. You should keep your example article open in a tab so you can refer to it, if necessary.

Finally, go to the volume your article is in, and click on the title’s red link. This should bring up an editor, so that you are now editing the article.

Subpages

We have recently switched to using subpages for articles, so they fall into a hierarchical structure under the appropriate volumes. This should not really be an issue in your editing, but I just wanted to mention it in case you saw older articles that did not follow the same naming scheme. All articles assigned to volunteer editors will use the subpage structure.

Title

If you clicked on the red link to begin creating the article, the title has been chosen for you. However, we want to italicize The Mailer Review, so we have to use a code called {{DISPLAYTITLE}}. With this element, you can insert necessary text formatting, like italics:

{{DISPLAYTITLE:''The Mailer Review''/Volume 12, 2018/Reflections}}

Putting two apostrophes ('') on both sides of The Mailer Review will italicize the journal name in the published document; like from our example above. Once you’ve entered your title, click the “Show preview” button under the editor window to see the results.[d] Note that the title must otherwise be exactly the same, or the system will ignore the code and spit out an error. If it does, just review your code carefully and fix what’s needed.

Header

Next, you need to insert the proper header for the volume, in the form of {{MRxx}} where “xx” is the two-number volume. For example, volume 12 would be {{MR12}}.

Anything surrounded with double brackets calls a template to be transcluded. Basically, templates are bits of code or boilerplate that can be used on multiple pages. This saves us from having to repeat the same information on multiple pages.

This header should appear on the top of all Review content.

Byline

Author Bio

Block Quotations

Images

End Notes

This section houses an author’s explanatory footnotes, like the “Notes” section at the bottom of this page. Notes may be inserted in the body of the text, using {{efn}}, for example:

. . .opportunity with a "lady's magazine",{{efn|In ''Double Life'', Lennon explains that Pearl Kazin, an editor at ''Harper's Bazaar'' had invited Mailer to write something for the magazine, to which Mailer replied: "I'm still too young and too arrogant to care to write the kind of high-grade horseshit you print in ''Harper's Bazaar''" (142–43).}} Mailer conceived . . .

Sourcing

There are two approaches to sourcing, depending on the complexity of the author’s citations. If the article has just a handful of sources, you might just include them in the body of the article and will just use a “Citations” section at the end of the document. If there are many sources, say over-ten, you should have a “Citations” section and a “Works Cited” section and use the shortened footnotes approach.

Citations

Works Cited

Footer

Add the Review footer with the code {{Review}} on a line by itself. This will insert the volume navigation information box.

Categories

Notes

  1. Like with any other digital document, there are no strict rules for what makes the best digital document. We are still in an incunabular stage when it comes to the digital. So think of these as guidelines on how we might approach our work here. There may be a better way. If so, we may change our approach. But for now, this is how we do it.
  2. This will suggest you make a Wikipedia account to continue. This step is optional.
  3. PDF is how I get the final digital form of the journal, which is made for print, so it always contains digital errors. Part of our job is to be sure we catch and correct these errors.
  4. Get into the habit of clicking this button with every bit that you add to the article. It allows you to quickly see if you’ve made a mistake, so you can fix it before saving.