Difference between revisions of "Help:Guidelines for Editors"

From GAMEO
Jump to navigation Jump to search
 
(12 intermediate revisions by 2 users not shown)
Line 21: Line 21:
 
'''Date and Time''' - This is up to your preference.
 
'''Date and Time''' - This is up to your preference.
  
−
'''Editing''' - Accept the defaults until you are familiar enough with using MediaWiki to make changes. Please do not use external editors.
+
'''Editing''' - Accept the defaults until you are familiar enough with using MediaWiki to make changes. '''Please do not use external editors.'''
  
 
'''Recent Changes''' - This your preference, but you should probably start with default settings.
 
'''Recent Changes''' - This your preference, but you should probably start with default settings.
Line 36: Line 36:
 
[[Help:GAMEO Style Sheet|GAMEO Style Sheet]] – This tells you how we do things, e.g. spell out numbers under 10, then use numerals; style to use in bibliographic entries, etc. Although it’s boring reading, you need to be familiar with this, or a Reviewer may send an article back to you for correction.
 
[[Help:GAMEO Style Sheet|GAMEO Style Sheet]] – This tells you how we do things, e.g. spell out numbers under 10, then use numerals; style to use in bibliographic entries, etc. Although it’s boring reading, you need to be familiar with this, or a Reviewer may send an article back to you for correction.
  
−
[[Help:Common Abbreviations|Common Abbreviations]] – These are bibliographical sources frequently used in articles in the print Encyclopedia, as well as newer forms. You can use this information to “cut and paste” into your bibliography on occasion, especially if you’re helping to enter articles from volumes 1-5.
+
[[Help:Common Abbreviations|Common Abbreviations]] – These are bibliographical sources frequently used in articles in the print Encyclopedia, as well as newer forms. You can use this information to “cut and paste” into your bibliography on occasion.
  
 
== Article Guides ==
 
== Article Guides ==
 
There are a variety of article guides to consult when you’re writing a new article or extensively revising a current article.
 
There are a variety of article guides to consult when you’re writing a new article or extensively revising a current article.
  
−
[[Help:Biographies (Standard)|Biographies (Standard)]]
+
[[Help:Biographies (General)|Biographies (General)]]
  
−
[[Help:Biographies (Brief)|Biographies (Brief)]]
+
[[Help:Biographies (Brief Genealogical)|Biographies (Brief Genealogical)]]
 +
 
 +
[[Help:Books|Books]]
  
 
[[Help:Congregations|Congregations]]
 
[[Help:Congregations|Congregations]]
 +
 +
[[Help:Geographical Entities|Geographical Entities]]
  
 
[[Help:Institutions|Institutions]]
 
[[Help:Institutions|Institutions]]
Line 58: Line 62:
 
In the search field at top right fill in a “Title” in the approved form of entry, e.g. Darmstadt (Hesse, Germany); Derksen, John (1929-2010); Abbotsford (British Columbia, Canada), etc. The search should reveal there is no article by that name. It will offer for you to "Create the page "Your Title" on this wiki. When you click on this it will up a page creating the title you typed. Select a template for the type of article (generic/church/person/place) and load the template. This loads the appropriate structure for your article.
 
In the search field at top right fill in a “Title” in the approved form of entry, e.g. Darmstadt (Hesse, Germany); Derksen, John (1929-2010); Abbotsford (British Columbia, Canada), etc. The search should reveal there is no article by that name. It will offer for you to "Create the page "Your Title" on this wiki. When you click on this it will up a page creating the title you typed. Select a template for the type of article (generic/church/person/place) and load the template. This loads the appropriate structure for your article.
  
−
In the blank text field then either type in the new content or paste it from your Word, or other word processing program. The toolbar above this form shows various editing features you can use, not unlike your word processor. A few may not be obvious – the “chain link” is for links to other GAMEO articles (you’ll use this a lot) or to external links (most often used in "Additional Information" to a church's website, etc. The “table” is to create tables. If you do need to create a table, use the defaults. The "picture" is for inserting illustrations. Remember the defaults for illustration.  
+
In the blank text field then either type in the new content or paste it from your Word, or other word processing program. The toolbar above this form shows various editing features you can use, not unlike your word processor. A few may not be obvious – the “chain link” is for links to other GAMEO articles (you’ll use this a lot) or to external links (most often used in "Additional Information" to a church's website, etc. The “table” is to create tables. If you do need to create a table, use the defaults. The "picture" to the right of the chain link is for inserting embedded files (primarily illustrations). Remember the defaults for illustrations. '''Do not''' use the "Picture Gallery" found under the "Advanced" drop down
  
 
=== Links ===
 
=== Links ===
  
−
You probably have a number of proper names, institutional names or geographic locations in your article. We encourage you to create links to other GAMEO articles as much as possible. There are three ways to do this.
+
You probably have a number of proper names, institutional names or geographic locations in your article. We encourage you to create links to other GAMEO articles as much as possible.  
−
Highlight the name or term you want to create a link from, e.g. “Palatinate” and click on the “chain link”. This brings up a search box. Fill in the term (perhaps you’ve copied it your clipboard and can paste it in). Hit the “Enter” key to start the search. Plone will give a list of terms that match the search. Look for the article that you want to link to – it may be somewhat further down the list, or the search may tell you that it found nothing. Click the term (the full title of the article will show up beneath the search box) and click OK if this is the desired article. The term is now a greenish color and is underlined. Follow the same procedure for any other links you want to create. (remove any paretheses in your term, or you will get an error message. The search box does accept letters with diacritics)
+
 
−
Sometimes a term is very common, e.g. Pennsylvania, Palatinate, Menno Simons, Canadian Conference of Mennonite Brethren Churches. You can also open another session of GAMEO and open “Common Links” (listed on the Tools page). This is a page of links to commonly used terms – mostly geographic places and institutions. You can then copy the appropriate link and paste over your term in the article. If necessary you can modify the spelling to match the way the term was used in your article.
+
To do this, highlight the name or term you want to create a link from, e.g. “Frank Epp” and click on the “chain link”. This brings up a search box. Fill in the term, and MediaWiki will try to find the article. '''Important:''' proper names of individuals should be searched in last name, first name order (e.g. Epp, Frank); institutions, churches, and most other links should be searched in direct order (e.g. Abbotsford, British Columbia....  
−
Alternatively, if the search result is too long, or the term includes a diacritic, open GAMEO in another browser session. If the results of your search in option 1 are too long, go to the encyclopedia and browse to find the article I am looking for. Once located it, simply note the file name, go back to option 1, and search for the file name instead of the article name. That is especially helpful when looking for articles with diacritics.
+
 
−
If you wish to insert an illustration into text (an illustration already in the database, or that has been uploaded by a managing editor), go the paragraph where the illustration is to be placed. Click on the table box. Indicate there will be two rows and one column in the table. Uncheck the box for "Create Heading." Then click "Add table." This will create an empty table above the paragraph where you wish the illustration. With the cursor in the top cell of the table, click on the "tree" to find an image. The search box will in the images folder -- search for the image, you can use the file name of the image if you know it. When you select the right image, it will give you a choice on the size of the image to be displayed in the picture. Our default is the "mini" 200 x 200 pixels. In the bottom cell of the table place the caption for the illustration. This usually also includes the source of the image. Highlight the caption, click on the dropdown edit box and select the style "Image subtext." This creates italicized in a slightly smaller font. Now click on the image that is in the top cell and click on the "chain" to create a link to the full size of the image. You should be able to search again for the image. Now you need to decide whether you want the image table to be on the left or on the right. Click on "htlm" and look for the line that reads "<table class="plain">". It should contain your caption and other html code. Now insert align="left" or align="right" just before the last angle, i.e.  <table class="plain" align="left">. Be sure there is a space between "plain" and "align". Click on "html" again and you should see the image where you want it! If not try again, or ask for help from a managing editor.
+
If you don't get link you think should be there, open the encyclopedia in another tab and search for the name. It could be a spelling issue, something to do with diacritics, etc.
−
Skip the Commentary box – this is used only with some large articles that are mounted by the managers.
+
 
−
Skip the check box for “Use Parent Bibliography.” This is used by Managers in creating Large Articles.
+
=== Illustrations ===
−
The Bibliography form is similar to the “Body Text” form. Make sure your bibliography follows the correct style. Again be sure "normal paragraph" is the format for entries on this page. If there is a reference to an online historical source, you may create an external link to that site. Highlight the term as you would for internal links, but click on the "tree." This brings up a place to fill in the web address for the site. You can check that it works, and then say OK.
+
 
−
Skip footnotes; this is only used in some “source” document. We do not use footnotes in regular articles.
+
If you wish to insert an illustration into the text, first check if an appropriate image is already in GAMEO. If so open the "Embedded File" link (not the Picture Gallery!) and fill in the file name and appropriate caption.
−
Skip the check box for “Use Parent Additional Information”
+
 
−
The Additional Information form will be where you might place a link to the website of the church or institution the article is about. For a congregation or institution you may provide “Directory Information” in this section (Address, phone, conference/professional affiliations, etc.). Use the form:
+
If the photo needs to be added from your computer, open "Upload file" (from the left menu) in another browser tab or window. Make sure the photo you are uploading is no more than 1200px on the long side. Choose the file from your computer, give it a relevant destination filename, e.g. Epp, Frank, 1983 (for a picture from 1983). In the summary provide a brief description, and the donor of the photograph.
 +
 
 +
===Maps===
 +
 
 +
For the present, if you want a map attached to your article, contact one of the Managing Editors with detailed information.
 +
 
 +
=== Bibliography ===
 +
 
 +
The Bibliography section should follow the correct style; see the [[Help:GAMEO Style Sheet|GAMEO Style Sheet]]. If there is no bibliography, remove the Bibliography heading.  
 +
 
 +
If there is a reference to an online historical source, you may create an external link to that site. Highlight the term, and click on the link chain. Fill in the web address for the website and save.
 +
 
 +
=== Additional Information ===
 +
 
 +
The Additional Information section includes information and links to the website of the church or institution the article is about. For a congregation or institution you may provide “Directory Information” in this section (Address, phone, conference/professional affiliations, etc.). Use the form:
  
 
Address: 32 Weber Street West, Kitchener, Ontario N2H 3Z2
 
Address: 32 Weber Street West, Kitchener, Ontario N2H 3Z2
Line 84: Line 102:
  
 
Other things you may wish to place in this area are:
 
Other things you may wish to place in this area are:
 +
 
A link to Worldcat for articles about books, hymnbooks or periodicals to provide information on where a book might be located. See Agape (Periodical) for an example. Instructions on making links to Worldcat can be found at: http://www.worldcat.org/links/.  If there are multiple editions of the work, you may want to use a title search. For an example see Alt-Evangelische Mennonitische Brüderschaft in Russland (1789-1910). Use the OCLC, ISSN or ISBN search if only one edition of an item has appeared.
 
A link to Worldcat for articles about books, hymnbooks or periodicals to provide information on where a book might be located. See Agape (Periodical) for an example. Instructions on making links to Worldcat can be found at: http://www.worldcat.org/links/.  If there are multiple editions of the work, you may want to use a title search. For an example see Alt-Evangelische Mennonitische Brüderschaft in Russland (1789-1910). Use the OCLC, ISSN or ISBN search if only one edition of an item has appeared.
 +
 
A link to an online copy of a work that is not part of the bibliography. This is similar to an external link to an organization relevant to the article. See Offer des Heeren for an example.
 
A link to an online copy of a work that is not part of the bibliography. This is similar to an external link to an organization relevant to the article. See Offer des Heeren for an example.
−
Skip the check box for “Use Parent Citing Information”; this is used only in large articles.
 
−
Fill in the Author boxes as indicated. This is the person who created the content. That’s you if you wrote the article, or the actual author if you are doing the inputting for them. If there is only one author, leave Author2 blank.
 
−
If there is only one author, and the author has a middle initial, do not put a period after the initial in the first box. If there are two authors, do use a period after middle initials. This information is copied into the “How to Cite this Article” at the bottom of the articles.
 
−
Fill in month and year in the “Last Written” box, e.g. December 2007. There is no comma between month and year. If you putting in an article from the print edition, if the article is from volume 1 use the year 1955; for volume 2 use 1956, for volume 3 use 1957, and for volume 4 use 1959. If the content clearly indicates it was written at another time you can use that year.
 
−
If you are entering an article from the print encyclopedia, check the “Use Herald Press Info” box, and also fill in the “Herald Press Citing Info” in the manner of:  Vol. 3, p. 76 (no period at the end) or Vol. 2, pp. 11-12
 
  
−
Otherwise leave these spaces blank.
+
=== GAMEO Footer ===
−
Click “Save”
 
−
Check over what you’ve done. You will see the State is “Draft” in the right end of the gold bar. If you need to make corrections, click edit and make your revisions. If you click “Sharing” do not change any settings, you will only restrict persons from seeing the article.
 
−
If you are satisfied with the draft, click on “State” and select “Submit for Review.”  One of the Reviewers will look over the article, and either “Publish” it to public view, or return it to you for further work, hopefully with comments.
 
−
 
  
−
If you wish to add an image to the article, you will need to forward the image to Richard Thiessen or Sam Steiner. Provide a full-size image (up to 800 pixels on the long side is fine) and the caption to go with the image. Give the source of the image if possible. There are instructions in 4.g for adding an illustration that already exists in GAMEO.
+
The footer is is where you fill in the Month and Year of the article (e.g. July 2013) (without parentheses) and the last name and first name of the author of the article. A second author can be entered if necessary. If you use an initial as part of the first name (e.g. John C, do put a period after the initial.  
  
−
If you go back to your Dashboard, you will see the new article listed among “recent changes.” Other registered users will see it as well. However, if you log out and search for the article as a public user you will not find it.
+
=== Save ===
 +
Click “Save” to finish your work. Check over what you’ve done. If you need to make corrections, click edit and make your revisions.  
  
−
Editing Current articles
+
=== Editing Existing Articles ===
  
−
1.      If you want to go back and edit an article that you created earlier, you can search for the article (when you are logged on) and see that its state is “Published” on the right end of the gold bar. You can click on “State” and select “Modify”. This will give you the option to edit; the fields will look the same as when you created the article. You then will "Submit for Review" again when you are ready.
+
If you want to edit an existing article, you can search for the article (when you are logged on). You can click edit and make the necessary changes. Before it is "approved" by a reviewer or managing editor, it will be a "pending" state, though it is still visible to visitors of the site.  
  
−
2.      If you want to edit an article you did not submit you will need to ask one of the moderators to make you the “owner” of the article. We can change the "Creator" to include your ID, thus allowing you to edit the article.
+
Major revisions of an existing article should be discussed with a managing editor before commencing work. Minor edits/corrections can be done at any time. Do not change author information on an article without discussion with a managing editor.

Latest revision as of 13:44, 18 August 2021

Becoming an Editor

To be a GAMEO editor, you need to be a registered user with a Login Name and a Password. These are initiated by GAMEO Managing Editor Richard Thiessen, Librarian at Columbia Bible College in Abbotsford, British Columbia, or Associate Managing Editor Sam Steiner, former Librarian & Archivist at Conrad Grebel University College, Waterloo, Ontario.

If you have been invited to serve as an editor, one of the managing editors will send you an email with your Login Name (which will be a combination of your first and last name) and a temporary password. After you log in for the first time, you should change your password to one of your choice. It should be at least ten characters long. We recommend that it be a combination of letters and numbers, and possibly even including a special character like a #, % or some such.

User Information and Preferences

User Page

When you login you will see your name on the righthand side near the top. Clicking on this link will bring you to your personal User Page. Here you can provide information about yourself, and upload a photo if you wish.

Talk Page

Immediately to the right of your name is a link to a "Talk" page. If you create this page, it is a place to communicate with other editors about things related to GAMEO, (or not, if you wish.)

Preferences

You should spend some time in the Preferences link.

User Profile - Here you see your user name and id number, as well as statistics about what you've done. Provide a Real Name and sure your email address is correct. Change your password if you've only had a temporary one.

Appearance - Accept the defaults, except to change image size limit to 1024x768px and thumbnail size to 300px.

Date and Time - This is up to your preference.

Editing - Accept the defaults until you are familiar enough with using MediaWiki to make changes. Please do not use external editors.

Recent Changes - This your preference, but you should probably start with default settings.

Watchlist, Search, Misc and Semantic MediaWiki - Start with the defaults; change when you have a reason to do so.

Available Help Pages

Help Pages That Are Available Include:

Guidelines for Editors – Guidelines for basic creation and editing of GAMEO articles. (This Help Page.)

Guidelines for Reviewers – Guidelines for reviewers to "publish" or "reject" articles, to add images, maps or other multi-media to articles.

GAMEO Style Sheet – This tells you how we do things, e.g. spell out numbers under 10, then use numerals; style to use in bibliographic entries, etc. Although it’s boring reading, you need to be familiar with this, or a Reviewer may send an article back to you for correction.

Common Abbreviations – These are bibliographical sources frequently used in articles in the print Encyclopedia, as well as newer forms. You can use this information to “cut and paste” into your bibliography on occasion.

Article Guides

There are a variety of article guides to consult when you’re writing a new article or extensively revising a current article.

Biographies (General)

Biographies (Brief Genealogical)

Books

Congregations

Geographical Entities

Institutions

Periodicals

Writing a New Article

Input text

To write a new article:

In the search field at top right fill in a “Title” in the approved form of entry, e.g. Darmstadt (Hesse, Germany); Derksen, John (1929-2010); Abbotsford (British Columbia, Canada), etc. The search should reveal there is no article by that name. It will offer for you to "Create the page "Your Title" on this wiki. When you click on this it will up a page creating the title you typed. Select a template for the type of article (generic/church/person/place) and load the template. This loads the appropriate structure for your article.

In the blank text field then either type in the new content or paste it from your Word, or other word processing program. The toolbar above this form shows various editing features you can use, not unlike your word processor. A few may not be obvious – the “chain link” is for links to other GAMEO articles (you’ll use this a lot) or to external links (most often used in "Additional Information" to a church's website, etc. The “table” is to create tables. If you do need to create a table, use the defaults. The "picture" to the right of the chain link is for inserting embedded files (primarily illustrations). Remember the defaults for illustrations. Do not use the "Picture Gallery" found under the "Advanced" drop down

Links

You probably have a number of proper names, institutional names or geographic locations in your article. We encourage you to create links to other GAMEO articles as much as possible.

To do this, highlight the name or term you want to create a link from, e.g. “Frank Epp” and click on the “chain link”. This brings up a search box. Fill in the term, and MediaWiki will try to find the article. Important: proper names of individuals should be searched in last name, first name order (e.g. Epp, Frank); institutions, churches, and most other links should be searched in direct order (e.g. Abbotsford, British Columbia....

If you don't get link you think should be there, open the encyclopedia in another tab and search for the name. It could be a spelling issue, something to do with diacritics, etc.

Illustrations

If you wish to insert an illustration into the text, first check if an appropriate image is already in GAMEO. If so open the "Embedded File" link (not the Picture Gallery!) and fill in the file name and appropriate caption.

If the photo needs to be added from your computer, open "Upload file" (from the left menu) in another browser tab or window. Make sure the photo you are uploading is no more than 1200px on the long side. Choose the file from your computer, give it a relevant destination filename, e.g. Epp, Frank, 1983 (for a picture from 1983). In the summary provide a brief description, and the donor of the photograph.

Maps

For the present, if you want a map attached to your article, contact one of the Managing Editors with detailed information.

Bibliography

The Bibliography section should follow the correct style; see the GAMEO Style Sheet. If there is no bibliography, remove the Bibliography heading.

If there is a reference to an online historical source, you may create an external link to that site. Highlight the term, and click on the link chain. Fill in the web address for the website and save.

Additional Information

The Additional Information section includes information and links to the website of the church or institution the article is about. For a congregation or institution you may provide “Directory Information” in this section (Address, phone, conference/professional affiliations, etc.). Use the form:

Address: 32 Weber Street West, Kitchener, Ontario N2H 3Z2 Phone: 519-578-4900 Website: Rockway Mennonite Church Denominational Affiliations: Mennonite Church Eastern Canada Mennonite Church Canada

We do not put email addresses in the directory fields. If you have tables for listing pastors, membership, board chairs or whatever, they also go into “Additional Information”

Other things you may wish to place in this area are:

A link to Worldcat for articles about books, hymnbooks or periodicals to provide information on where a book might be located. See Agape (Periodical) for an example. Instructions on making links to Worldcat can be found at: http://www.worldcat.org/links/. If there are multiple editions of the work, you may want to use a title search. For an example see Alt-Evangelische Mennonitische Brüderschaft in Russland (1789-1910). Use the OCLC, ISSN or ISBN search if only one edition of an item has appeared.

A link to an online copy of a work that is not part of the bibliography. This is similar to an external link to an organization relevant to the article. See Offer des Heeren for an example.

GAMEO Footer

The footer is is where you fill in the Month and Year of the article (e.g. July 2013) (without parentheses) and the last name and first name of the author of the article. A second author can be entered if necessary. If you use an initial as part of the first name (e.g. John C, do put a period after the initial.

Save

Click “Save” to finish your work. Check over what you’ve done. If you need to make corrections, click edit and make your revisions.

Editing Existing Articles

If you want to edit an existing article, you can search for the article (when you are logged on). You can click edit and make the necessary changes. Before it is "approved" by a reviewer or managing editor, it will be a "pending" state, though it is still visible to visitors of the site.

Major revisions of an existing article should be discussed with a managing editor before commencing work. Minor edits/corrections can be done at any time. Do not change author information on an article without discussion with a managing editor.

Retrieved from "https://gameo.org/index.php?title=Help:Guidelines_for_Editors&oldid=172191"