Difference between revisions of "Contributor's Guide"

From The May Day Mystery
Jump to: navigation, search
(Linking Policy)
 
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
  
Thank you for agreeing to help with the May Day Mystery Wiki! I really appreciate your contribution, and look forward to working with you! Hyacinth
+
Thank you for agreeing to help with the May Day Mystery Wiki! I really appreciate your contribution, and look forward to working with you! If you have any questions or issues please don't hesitate to contact me.
 +
 
 +
--Hyacinth
  
 
==Basic Information==
 
==Basic Information==
 
The May Day Mystery Wiki was established in 2017 to centralize, digitize, and analyze clues and information related to the May Day Mystery. We are not affiliated with Bryan Hance, Robert Truman Hungerford, The University of Arizona, or The Orphanage.
 
  
 
Our Wiki is powered by [https://www.mediawiki.org/wiki/MediaWiki MediaWiki], the same platform that powers Wikipedia.  
 
Our Wiki is powered by [https://www.mediawiki.org/wiki/MediaWiki MediaWiki], the same platform that powers Wikipedia.  
  
==Formatting==
+
It also uses the MediaWiki formatting markup, which you can refer to and bookmark '''[https://www.mediawiki.org/wiki/Help:Formatting HERE]'''.
  
Everything you need to know about formatting pages can be found [https://www.mediawiki.org/wiki/Help:Formatting HERE].
+
==Uploading Images and Media==
Here are a few basics:
+
  
===Text Formatting===
+
When logged in, click the "Upload file" link on the left sidebar to upload.
  
<nowiki>'''Bold text'''</nowiki>
+
Images can be inserted into pages and formatted using MediaWiki's image formatting markup documented '''[https://www.mediawiki.org/wiki/Help:Images HERE]'''.
  
 +
==Embedding External Media==
  
<nowiki>''Italic text''</nowiki>
+
Wikimedia Commons images can be imported by clicking "Use this file on a wiki" from any Wikimedia Commons file detail page. This can be used for adding images to infoboxes, as well as regular sections. Copy the code snippet and paste into an MDM Wiki page to import the image and its metadata. Here's an example snippet:
  
 +
<pre>
 +
[[File:Lucas Cranach d.Ä. - Martin Luther, 1528 (Veste Coburg).jpg|thumb|Lucas Cranach d.Ä. - Martin Luther, 1528 (Veste Coburg)]]
 +
</pre>
  
<nowiki>'''''Bold & italic text'''''</nowiki>
+
YouTube videos can be embedded, when appropriate, by using the following template. The start time can be changed and is defined in seconds.
 +
<pre>
 +
{{#ev:youtube|https://www.youtube.com/watch?v=kytt0_cfYIA|||||start=451}}
 +
</pre>
  
 +
==General Section Formatting==
  
<nowiki><u>Underlined text</u></nowiki>
+
<pre>
 +
==Lv. 2 Headline Text==
  
 +
Used for Page Sections, like ==Ad Interpretation==
 +
</pre>
  
<nowiki><s>Struck out text</s></nowiki>
+
<pre>
 +
===Lv. 3 Headline Text===
  
 +
Used for Page Subsections, like ===Historical References===
 +
</pre>
  
<nowiki><blockquote>Block Quote</blockquote></nowiki>
+
<pre>
 +
====Lv. 4 Headline Text====
  
 +
Very rarely used.
 +
</pre>
  
===Section Formatting===
 
  
<nowiki>== Lv. 2 Headline Text ==</nowiki>
+
==Formatting Templates==
  
Used for Page Sections, like <nowiki>==Ad Interpretation==</nowiki>
+
Templates will allow us to maintain a consistent layout across the Wiki. I've tried to include many types of pages that may be created, but this section will continue to grow as the wiki does. Some templates use infoboxes—Please refer to Wikipedia's [https://en.wikipedia.org/wiki/Template:Infobox Infobox Documentation] to learn more about them.
  
 +
===Ad Pages===
 +
Use the following template to create and format an ad page. Copy and paste the below code into a new page and fill in the appropriate information.
  
<nowiki>=== Lv. 3 Headline Text ===</nowiki>
+
Please try to mirror the formatting (including bolding, italicizing, and spacing) of the original ad when digitizing the ad transcript.
 
+
Used for Page Subsections, like <nowiki>===Historical References===</nowiki>
+
 
+
 
+
<nowiki>====Lv. 4 Headline Text====</nowiki>
+
 
+
<nowiki>Very rarely used.</nowiki>
+
 
+
 
+
'''Bullets and Lists'''
+
 
+
Use asterisks to create a bulleted lists:
+
 
+
<nowiki>*Bullet 1</nowiki>
+
 
+
<nowiki>*Bullet 2</nowiki>
+
 
+
<nowiki>**Deeper level</nowiki>
+
 
+
 
+
Use number signs to create numbered lists:
+
 
+
<nowiki># First item</nowiki>
+
 
+
<nowiki># Second item</nowiki>
+
 
+
<nowiki># Third item</nowiki>
+
 
+
<nowiki>## Deeper level list</nowiki>
+
 
+
 
+
 
+
===Formatting Ad Pages===
+
 
+
Ad Pages are titled
+
Use the following template to create and format an ad page. Copy and paste the below code.
+
  
 
<pre>
 
<pre>
Line 123: Line 104:
  
 
</pre>
 
</pre>
 +
 +
===Formatting Biographical Pages===
 +
Use the following template to create and format an biographical page. Copy and paste the below code into a new page and fill in the appropriate information.
 +
 +
<pre>
 +
{{Infobox
 +
|title = FULL NAME
 +
|subheader = SUBHEADER
 +
|image = [[File:FILENAME.jpg|200px|CAPTION]]
 +
|label2 = Born
 +
|data2 = MONTH DD, YYYY
 +
|label3 = Died
 +
|data3 = MONTH DD, YYYY (age XX)
 +
|label4 = Nationality
 +
|data4 = NATIONALITY
 +
|label5 = Occupation
 +
|data5 = OCCUPATION, YYYY-YYYY
 +
|label6 = Religion
 +
|data6 = RELIGION, IF RELEVANT
 +
|label7 = Known For
 +
|data7 = LIST OF ACCOMPLISHMENTS
 +
|label8 = Wikipedia
 +
|data8 = [https://en.wikipedia.org/wiki/XX_XX WIKI PAGE TITLE]
 +
}}
 +
 +
INTRODUCTORY TEXT
 +
 +
==SECTION TITLE==
 +
 +
==SECTION TITLE==
 +
 +
</pre>
 +
 +
==Linking Policy==
 +
 +
Everything you need to know about linking in the MediaWiki ecosystem can be found here: [https://www.mediawiki.org/wiki/Help:Links MediaWiki Links]. However, there are a few specific pointers and guidelines to keep in mind when linking on the MDM Wiki.
 +
 +
===Internal Links===
 +
Link to other pages on this wiki when appropriate! If it's a person, place, or thing that is commonly mentioned in May Day clues, link it! Link by using double brackets like this: <pre>[[PAGE NAME]]</pre>. If you are unsure whether to link, ask a friend. Good examples of pages that should always be linked when mentioned: <pre>[[Martin Luther]], [[Summer Tour]], and [[Pelagian Devils]]</pre>.
 +
 +
Sometimes, the same person, place, or thing is referred to in a different way or abbreviated. A good example is G.A., an abbreviation for Gustavus Adolphus. Instead of linking G.A., use the pipe trick to make sure the link goes to the correct place. The Page Title before the pipe will be the link destination, but the text after the pipe will be displayed on your page.
 +
 +
<pre> [[Gustavus Adolphus|G.A.]] </pre>
 +
 +
Another method would be to use a redirect page (which we've done in some places), but overall, the pipe trick is much simpler and cleaner.
 +
 +
===External Links===
 +
Link to external sources when necessary! Always link to MayDayMystery.org if you've sourced an image or idea from that site. External links can be constructed like this:
 +
 +
<pre> [www.maydaymystery.com The May Day Mystery Wiki] </pre>
 +
 +
==Facts Vs. Theories==
 +
Since this wiki is so new, we'll have to work hard to strike the right balance between facts, suspicions, rumors, and theories. I'm open to ideas on how to do this, but for now, let's limit theories to the "Ad Interpretation," "Theories," or "Talk" sections of any page. Before putting forward a theory, try to present and document the facts that support it!
 +
 +
==Edits, Corrections, and Deletions==
 +
Please don't delete anything! If you find inaccurate information or a section that needs updating, feel free to update it as long as the page is not currently being worked on by another person. If you'd like to expand on a page or topic's analysis with your own findings, go ahead.

Latest revision as of 21:28, 4 August 2017

Thank you for agreeing to help with the May Day Mystery Wiki! I really appreciate your contribution, and look forward to working with you! If you have any questions or issues please don't hesitate to contact me.

--Hyacinth

Basic Information

Our Wiki is powered by MediaWiki, the same platform that powers Wikipedia.

It also uses the MediaWiki formatting markup, which you can refer to and bookmark HERE.

Uploading Images and Media

When logged in, click the "Upload file" link on the left sidebar to upload.

Images can be inserted into pages and formatted using MediaWiki's image formatting markup documented HERE.

Embedding External Media

Wikimedia Commons images can be imported by clicking "Use this file on a wiki" from any Wikimedia Commons file detail page. This can be used for adding images to infoboxes, as well as regular sections. Copy the code snippet and paste into an MDM Wiki page to import the image and its metadata. Here's an example snippet:

[[File:Lucas Cranach d.Ä. - Martin Luther, 1528 (Veste Coburg).jpg|thumb|Lucas Cranach d.Ä. - Martin Luther, 1528 (Veste Coburg)]]

YouTube videos can be embedded, when appropriate, by using the following template. The start time can be changed and is defined in seconds.

{{#ev:youtube|https://www.youtube.com/watch?v=kytt0_cfYIA|||||start=451}}

General Section Formatting

==Lv. 2 Headline Text==

Used for Page Sections, like ==Ad Interpretation==
===Lv. 3 Headline Text===

Used for Page Subsections, like ===Historical References===
====Lv. 4 Headline Text====

Very rarely used.


Formatting Templates

Templates will allow us to maintain a consistent layout across the Wiki. I've tried to include many types of pages that may be created, but this section will continue to grow as the wiki does. Some templates use infoboxes—Please refer to Wikipedia's Infobox Documentation to learn more about them.

Ad Pages

Use the following template to create and format an ad page. Copy and paste the below code into a new page and fill in the appropriate information.

Please try to mirror the formatting (including bolding, italicizing, and spacing) of the original ad when digitizing the ad transcript.


{{Infobox
|title = X/X/XX Ad
|subheader = MAY DAY XXXX
|label2 = Publication Date
|data2 = MONTH X, XXXX
|label3 = Ad Source
|data3 = [http://www.maydaymystery.org/mayday/texts/xx-xxxx.html MM Site]
|label4 = Smiley Type
|data4 = [[Smiley with X hairs]]
}}

== Ad Transcript ==


==Ad Border==


==Ad Image==
[[File:NAME.jpg]]


==Leitmotiv==


==Ad References==
*

===Religious References===
*

===Historical References===
*

===Scientific References===
*

===Literary References===
*

===Translations===
*

Formatting Biographical Pages

Use the following template to create and format an biographical page. Copy and paste the below code into a new page and fill in the appropriate information.

{{Infobox
|title = FULL NAME
|subheader = SUBHEADER
|image = [[File:FILENAME.jpg|200px|CAPTION]]
|label2 = Born
|data2 = MONTH DD, YYYY
|label3 = Died
|data3 = MONTH DD, YYYY (age XX)
|label4 = Nationality
|data4 = NATIONALITY
|label5 = Occupation
|data5 = OCCUPATION, YYYY-YYYY
|label6 = Religion
|data6 = RELIGION, IF RELEVANT
|label7 = Known For
|data7 = LIST OF ACCOMPLISHMENTS
|label8 = Wikipedia
|data8 = [https://en.wikipedia.org/wiki/XX_XX WIKI PAGE TITLE]
}}

INTRODUCTORY TEXT

==SECTION TITLE==

==SECTION TITLE==

Linking Policy

Everything you need to know about linking in the MediaWiki ecosystem can be found here: MediaWiki Links. However, there are a few specific pointers and guidelines to keep in mind when linking on the MDM Wiki.

Internal Links

Link to other pages on this wiki when appropriate! If it's a person, place, or thing that is commonly mentioned in May Day clues, link it! Link by using double brackets like this:
[[PAGE NAME]]
. If you are unsure whether to link, ask a friend. Good examples of pages that should always be linked when mentioned:
[[Martin Luther]], [[Summer Tour]], and [[Pelagian Devils]]
.

Sometimes, the same person, place, or thing is referred to in a different way or abbreviated. A good example is G.A., an abbreviation for Gustavus Adolphus. Instead of linking G.A., use the pipe trick to make sure the link goes to the correct place. The Page Title before the pipe will be the link destination, but the text after the pipe will be displayed on your page.

 [[Gustavus Adolphus|G.A.]] 

Another method would be to use a redirect page (which we've done in some places), but overall, the pipe trick is much simpler and cleaner.

External Links

Link to external sources when necessary! Always link to MayDayMystery.org if you've sourced an image or idea from that site. External links can be constructed like this:

 [www.maydaymystery.com The May Day Mystery Wiki] 

Facts Vs. Theories

Since this wiki is so new, we'll have to work hard to strike the right balance between facts, suspicions, rumors, and theories. I'm open to ideas on how to do this, but for now, let's limit theories to the "Ad Interpretation," "Theories," or "Talk" sections of any page. Before putting forward a theory, try to present and document the facts that support it!

Edits, Corrections, and Deletions

Please don't delete anything! If you find inaccurate information or a section that needs updating, feel free to update it as long as the page is not currently being worked on by another person. If you'd like to expand on a page or topic's analysis with your own findings, go ahead.