Difference between revisions of "Quick Guide to Editing Wiki Pages"

From Linked Earth Wiki
Jump to: navigation, search
( Pages with a poll )
(Add a quick markup guide and link to internal pages table)
(Editing existing wiki pages: I added a little bit of introductory text to make this page more friendly for people getting started. Seeing so many different commands right away might be daunting, when in fact editing a wiki page is very easy.)
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Once you are [[Get Started with the LinkedEarth wiki registered]], you can start editing existing pages, creating new ones, and move/delete obsolete pages. The pages you are allowed to edit depends on your editorial level.  
+
Once you are [[Get Started with the LinkedEarth wiki | registered]], you can start editing existing pages, creating new ones, and move/delete obsolete pages. The pages you are allowed to edit depends on your [[User Privileges | editorial level]].  
  
 
This guide provides basic instructions on how to use the MediaWiki format. If you require more help, use this [https://www.mediawiki.org/wiki/Help:Contents Help] or [mailto:linkedearth@gmail.com contact us].  
 
This guide provides basic instructions on how to use the MediaWiki format. If you require more help, use this [https://www.mediawiki.org/wiki/Help:Contents Help] or [mailto:linkedearth@gmail.com contact us].  
Line 6: Line 6:
  
 
=Editing existing wiki pages=
 
=Editing existing wiki pages=
 +
 +
Once logged in to your account, you can edit most of the wiki pages by clicking on "edit" at the top of the page (figure 1).
 +
 +
[[File:Location_of_edit_button.png|thumb|none|700px|Figure 1: Location of the "Edit" Tab]]
 +
 +
To edit text, you can get started right away.  Once you click that "edit" button, just find the section you want to edit and type normally to add useful information or expand on a topic.  If you want to add a new section, format something, or add a poll or an image, use the remainder of this page as a reference.  You don't need to know everything right away--Just jump in.  You can always refer back to this page later on.
  
 
==Quick Markup Guide==
 
==Quick Markup Guide==
Line 27: Line 33:
 
'''''Bold and italic'''''
 
'''''Bold and italic'''''
 
|<pre>
 
|<pre>
'''Bold Text'''
+
'''''Bold Text'''''
 
</pre>
 
</pre>
 
|-
 
|-
Line 123: Line 129:
 
|Word-ending links, following so called "link trail rules"
 
|Word-ending links, following so called "link trail rules"
 
|
 
|
[[Marine Sediment]]s
+
[[Radioisotopes in Corals]]
 
| <pre>
 
| <pre>
[[Marine Sediment]]s </pre>
+
[[Radioisotopes in Corals]] </pre>
|-
+
| Redirect
+
| #REDIRECT [[Main Page]]
+
| <pre>
+
#REDIRECT [[Main Page]] </pre>
+
 
|-
 
|-
 
| Internal Link to the current page's talk page
 
| Internal Link to the current page's talk page
Line 146: Line 147:
 
| [[Special:MyPage]]
 
| [[Special:MyPage]]
 
|<pre>
 
|<pre>
[[Special:MyPage]]
+
[[Special:MyPage]]</pre>
</pre>
+
|-
 +
| Internal link to a category page
 +
| [[:Category:Working_Group]]
 +
|<pre>
 +
[[:Category:Working_Group]]</pre>
 +
|-
 +
| Internal link to a property page
 +
| [[:Property:HasUnits_(L)]]
 +
|<pre>
 +
[[:Property:HasUnits_(L)]]</pre>
 
|}
 
|}
 +
 +
=== External Link===
 +
 +
{| class="wikitable"
 +
! style="width: 33%" | Description
 +
! style="width: 33%" | What it looks like
 +
! style="width: 34%" | What you type
 +
|-
 +
|External link
 +
| https://www.wikipedia.org
 +
| <pre>  https://www.wikipedia.org </pre>
 +
|-
 +
|External link with different label
 +
| [https://www.wikipedia.org Wikipedia]
 +
| <pre>  [https://www.wikipedia.org Wikipedia]</pre>
 +
|-
 +
| Numbered external link
 +
| [https://www.wikipedia.org]
 +
| <pre>  [https://www.wikipedia.org] </pre>
 +
|-
 +
|Mailto link
 +
| [mailto:linkedearth@gmail.com email us]
 +
| <pre> [mailto:linkedearth@gmail.com email us] </pre>
 +
|}
 +
 
==Images==
 
==Images==
  
If you want to add an image or document to your a wiki page ('''Not a LiPD file, use the special page described in this tutorial to upload your LiPD file'''), click on the "upload files" button that can be seen on the left of any wiki page (see Figure 23).
+
To insert an image into an article ('''For a LiPD file, use this [[Special:WTLiPD | page]]'''), click on the "Upload file" button in the lefthand menu (Figure 2).
  
[[File:TutorialFig23.png|thumb|none|700px|Figure 23: uploading an image or document to the Linked Earth wiki.]]
+
[[File:TutorialFig23.png|thumb|none|700px|Figure 2: uploading an image or document to the Linked Earth wiki.]]
  
After you are done selecting the document you want to upload, just hit the "Upload file" button at the bottom of the page. Now you may reference to this file using brackets (e.g., [ [ File:File.png ] ]). You can see the different options for showing files in this page: [https://www.mediawiki.org/wiki/Help:Images https://www.mediawiki.org/wiki/Help:Images]
+
First select the document you want to upload, then just hit the "Upload file" button at the bottom of the page.  
  
 +
'''Be Specific in the name file''': If you wish to upload a picture of your archive, do NOT name the file 'MyArchive.jpg'. Read the [[Best Practices]] guide to learn how to properly name your file.
  
=Creating a new wiki page=
+
This file can then be referenced using an internal link described [[#Internal Links | above]].
  
Just go to [http://wiki.linked.earth/New_Page http://wiki.linked.earth/New_Page]
+
== Tables and Equations ==
  
Replace "New Page" above to the name that you want for the page.
+
Tables and equations are more complicated. For a more thorough explanation, see Wikipedia's pages on [https://en.wikipedia.org/wiki/Help:Displaying_a_formula formulas] and [https://en.wikipedia.org/wiki/Help:Table tables].
  
Then, either select a category for this page (Figure 16):
+
===Tables===
  
[[File:TutorialFig16.png|thumb|none|300px|Figure 16: Selecting a category for a new page]]
+
The  following code
  
or, just click on the "Create" link to create a page without any category (Figure 17)
+
<pre>
 +
{| class="wikitable"
 +
|-
 +
|+Table 1.
 +
|-
 +
! Header text 1 || Header text 2 || Header text 3
 +
|-
 +
| Example 1 || Example 2 || Example 3
 +
|-
 +
| Example A || Example B || Example C
 +
|-
 +
| Example ! || Example @ || Example #
 +
|}
 +
</pre>
  
[[File:TutorialFig17.png|thumb|none|200px|Figure 17: create page button, located on the bottom right of the page]]
+
results in:
  
Alternatively, you can search for the page you are looking for (remember that the wiki is case sensitive). If the page does not exist, you will be prompted to create it.  
+
{| class="wikitable"
 +
|-
 +
|+Table 1.
 +
|-
 +
! Header text 1 || Header text 2 || Header text 3
 +
|-
 +
| Example 1 || Example 2 || Example 3
 +
|-
 +
| Example A || Example B || Example C
 +
|-
 +
| Example ! || Example @ || Example #
 +
|}
  
=Deleting an existing wiki page=
+
===Equations===
  
Go to [http://wiki.linked.earth/Name_of_Page http://wiki.linked.Earth/Name_of_Page]
+
Equations use the LaTex markup language and are bounded by <nowiki><math></nowiki> and <nowiki></math></nowiki> tags. For instance, <nowiki><math> \delta^{18}O_{SMOW} = 1.03091 (\delta^{18}O_{PDB}) +30.91 </math></nowiki> results in:
Replace "Name of Page" above to the name of the page to delete, as shown in Figure 18.
+
  
[[File:TutorialFig18.png|thumb|none|300px|Figure 18: Wiki page option menu]]
+
<math> \delta^{18}O_{SMOW} = 1.03091 (\delta^{18}O_{PDB}) +30.91 </math>
  
Then click on the "Delete" link, and delete the page. Figure 19 shows an example:
+
==References==
  
[[File:TutorialFig19.png|thumb|none|500px|Figure 19: Deleting menu]]
+
All references consist of a citation and an actual reference. The citation is a tag that contains a shorthand form of the reference, and is followed, on first use in an article, by the completed reference.
 +
 
 +
The LinkedEarth wiki uses APA style for citation
 +
 
 +
To create a reference:
 +
* First citation in the article:
 +
<pre>Khider et al. <ref name = Khider_2014> Khider, D., Jackson, C. S., & Stott, L. D. (2014). Assessing millennial-scale variability during the Holocene: A perspective from the western tropical Pacific. Paleoceanography, 29(3), 143-159. doi:10.1002/2013pa002534 </ref></pre>
 +
 
 +
becomes Khider et al. <ref name = Khider_2014> Khider, D., Jackson, C. S., & Stott, L. D. (2014). Assessing millennial-scale variability during the Holocene: A perspective from the western tropical Pacific. Paleoceanography, 29(3), 143-159. doi:10.1002/2013pa002534 </ref>
 +
 
 +
*Subsequent citations
 +
<pre> Khider et al.<ref name = Khider_2014 /></pre>
 +
 
 +
will automatically create a footnote marker that will link to the original reference: Khider et al. <ref name = Khider_2014 />
 +
 
 +
== Earth Science specific items ==
 +
 
 +
Nuclides are readily expressed using the SimpleNuclide2 extension. See [[NuclideExamples]].
 +
 
 +
== Adding a poll ==
 +
 
 +
The LinkedEarth wiki has [https://www.mediawiki.org/wiki/Extension:AJAXPoll polling capabilities]. To create a poll use the following code:
 +
 
 +
<pre>
 +
<poll>
 +
Question
 +
Choice1
 +
Choice2
 +
Choice3
 +
Choice4
 +
</poll>
 +
</pre>
 +
 
 +
For instance,
 +
 
 +
<pre>
 +
<poll>
 +
Are you a LinkedEarth member?
 +
Yes
 +
No
 +
</poll>
 +
</pre>
 +
 
 +
returns:
 +
 
 +
<poll>
 +
Are you a LinkedEarth member?
 +
Yes
 +
No
 +
</poll>
 +
 
 +
<div class="isa_error">
 +
  <i class="fa fa-times-circle"></i>
 +
Use different questions/answer for polls on the wiki. Otherwise, the system would automatically vote for all of the polls containing the same question. So be very specific if you need to be!
 +
However, if you think a poll can apply to multiple pages, you can copy and paste the same poll on multiple pages. For instance, if you create a poll on a common nomenclature for expressing d18O on the Speleothem working group, the same poll can be posted on the Marine Sediment, MARPA, Ice Core working group pages.
 +
</div>
 +
 
 +
=== Editing an existing poll ===
 +
 
 +
<div class="isa_error">
 +
  <i class="fa fa-times-circle"></i>
 +
  Editing an exiting poll will '''reset the votes'''. If you need to edit a poll, make sure you keep the results of the previous poll.
 +
</div>
 +
 
 +
For instance,
 +
<pre>
 +
<poll>
 +
Are you a recent LinkedEarth member?
 +
Yes
 +
No
 +
</poll>
 +
This poll was edited by ~~~~ and had 2 No and 1 Yes answer before editing.
 +
</pre>
 +
 
 +
returns this on the wiki:
 +
 
 +
<poll>
 +
Are you a recent LinkedEarth member?
 +
Yes
 +
No
 +
</poll>
 +
This poll was edited by [[User:Khider|Deborah Khider]] ([[User talk:Khider|talk]]) 13:53, 18 October 2016 (PDT) and had 2 No and 1 Yes answer before editing.
 +
 
 +
== Signing your name ==
 +
 
 +
If you wish to sign your name on a page when making an edit, such as in the example above, use: <pre> ~~~~ </pre> [[User:Khider|Deborah Khider]] ([[User talk:Khider|talk]]) 13:55, 18 October 2016 (PDT)
 +
 
 +
=Creating a new wiki page=
 +
 
 +
To create a new page, type the link into your browser: [http://wiki.linked.earth/New_Page http://wiki.linked.earth/New_Page] and replace "New Page" above by the name that you want for the page.
 +
 
 +
Then, either select a category for this page (Figure 2):
 +
 
 +
[[File:TutorialFig16.png|thumb|none|300px|Figure 2: Selecting a category for a new page]]
 +
 
 +
or, just click on the "Create" link to create a page without any category (Figure 3)
 +
 
 +
[[File:TutorialFig17.png|thumb|none|200px|Figure 3: create page button, located on the bottom right of the page]]
 +
 
 +
Alternatively, you can search for the page you are looking for (remember that the wiki is case sensitive). If the page does not exist, you will be prompted to create it. You should '''always''' try to look for the term you want to define before creating a new page to avoid duplicate pages of similar concepts.
 +
 
 +
=Deleting an existing wiki page=
  
== Searching existing wiki pages==
+
Go to the page you want to delete and select "Delete" from the drop down menu as shown in Figure 4.
Before creating any page, it is recommended to search if they already exist. Searching a page can be done by entering the terms on the search bar located on the top right of any page (see Figure 20).
+
  
[[File:TutorialFig20.png|thumb|none|500px|Figure 20: Search bar for finding existing wiki pages]]
+
[[File:TutorialFig18.png|thumb|none|300px|Figure 4: Wiki page option menu]]
  
Any page containing the word introduced in the search bar will be returned.
+
Click on the "Delete" link, and delete the page. You will be prompted to give a reason for the deletion.
  
 +
[[File:TutorialFig19.png|thumb|none|500px|Figure 5: Deleting menu]]
  
 
= Renaming wiki pages =
 
= Renaming wiki pages =
  
Wiki pages may need to be renamed. For example, due to typos in the page name or community agreement to rename a term in the LinkedEarth ontology. In order to rename an existing page without losing any of its contents, you should click on the "Move" button under the "More" menu on the top of the page. An example is shown in Figure 21.
+
Wiki pages may need to be renamed because of typos in the page name or community agreement to rename a term in the LinkedEarth ontology. In order to rename an existing page without losing any of its contents, you should click on the "Move" button under the "More" menu on the top of the page (Figure 6)
  
[[File:TutorialFig21.png|thumb|none|500px|Figure 21: Moving an existing wiki page]]
+
[[File:TutorialFig21.png|thumb|none|500px|Figure 6: Moving an existing wiki page]]
  
By clicking on the Move button, the page showed in Figure Figure 22 will ask for the new page name, as well as a reason of the change.  
+
You will be prompted to enter the new name for the page and a reason for the change.
  
[[File:TutorialFig22.png|thumb|none|700px|Figure 22: Moving a wiki page form.]]
+
[[File:TutorialFig22.png|thumb|none|700px|Figure 7: Moving a wiki page form.]]
  
After hitting the "Move page" button, your page will be renamed.
+
=References=

Latest revision as of 17:35, 29 June 2017

Once you are registered, you can start editing existing pages, creating new ones, and move/delete obsolete pages. The pages you are allowed to edit depends on your editorial level.

This guide provides basic instructions on how to use the MediaWiki format. If you require more help, use this Help or contact us.

The quickest way to figure out how to do something is to find and example of what you want to do from another page, or on Wikipedia, and copy the source code from there.

Editing existing wiki pages

Once logged in to your account, you can edit most of the wiki pages by clicking on "edit" at the top of the page (figure 1).

Figure 1: Location of the "Edit" Tab

To edit text, you can get started right away. Once you click that "edit" button, just find the section you want to edit and type normally to add useful information or expand on a topic. If you want to add a new section, format something, or add a poll or an image, use the remainder of this page as a reference. You don't need to know everything right away--Just jump in. You can always refer back to this page later on.

Quick Markup Guide

What it looks like What you type

Italic Text

''Italic Text'' 

Bold Text

'''Bold Text'''

Bold and italic

'''''Bold Text'''''

strike text

<strike> strike text </strike>

Section Headings and Lists

Description What it looks like What you type

Headings

  • Skip Level 1, it is page name level.
  • An article with 4 or more headings automatically creates a Table of Contents.

Level 2

Level 3

Level 4

Level 5
Level 6
==Level 2==
=== Level 3===
====Level 4 ====
===== Level 5 =====
====== Level 6 ======

Bullet List

  • Level 1
    • Level 2
      • Level 3
* Level 1
** Level 2
*** Level 3
Numbered List
  1. Level 1
    1. Level 2
      1. Level 3
# Level 1
## Level 2
### Level 3
Comment

Comments are visible only in the edit zone

<!-- This is a comment -->
Comments are visible only in the edit zone

Links

Internal Links

Description What it looks like What you type

Internal Link

Main Page

[[Main Page]] 
Piped Link

Use different text for the link

Go to the Main Page

[[Main Page|Go to the Main Page]]
Word-ending links, following so called "link trail rules"

Radioisotopes in Corals

[[Radioisotopes in Corals]] 
Internal Link to the current page's talk page

Discussion

[[{{TALKPAGENAME}}|Discussion]] 
Internal link to an image or a file of other types media:PSM.jpg
[[media:PSM.jpg]]
Internal link to the user's user page Special:MyPage
[[Special:MyPage]]
Internal link to a category page Category:Working_Group
 [[:Category:Working_Group]]
Internal link to a property page Property:HasUnits_(L)
 [[:Property:HasUnits_(L)]]

External Link

Description What it looks like What you type
External link https://www.wikipedia.org
  https://www.wikipedia.org 
External link with different label Wikipedia
  [https://www.wikipedia.org Wikipedia]
Numbered external link [1]
  [https://www.wikipedia.org] 
Mailto link email us
 [mailto:linkedearth@gmail.com email us] 

Images

To insert an image into an article (For a LiPD file, use this page), click on the "Upload file" button in the lefthand menu (Figure 2).

Figure 2: uploading an image or document to the Linked Earth wiki.

First select the document you want to upload, then just hit the "Upload file" button at the bottom of the page.

Be Specific in the name file: If you wish to upload a picture of your archive, do NOT name the file 'MyArchive.jpg'. Read the Best Practices guide to learn how to properly name your file.

This file can then be referenced using an internal link described above.

Tables and Equations

Tables and equations are more complicated. For a more thorough explanation, see Wikipedia's pages on formulas and tables.

Tables

The following code

{| class="wikitable"
|-
|+Table 1.
|-
! Header text 1 || Header text 2 || Header text 3
|-
| Example 1 || Example 2 || Example 3
|-
| Example A || Example B || Example C
|-
| Example ! || Example @ || Example # 
|}

results in:

Table 1.
Header text 1 Header text 2 Header text 3
Example 1 Example 2 Example 3
Example A Example B Example C
Example ! Example @ Example #

Equations

Equations use the LaTex markup language and are bounded by <math> and </math> tags. For instance, <math> \delta^{18}O_{SMOW} = 1.03091 (\delta^{18}O_{PDB}) +30.91 </math> results in:

 \delta^{18}O_{SMOW} = 1.03091 (\delta^{18}O_{PDB}) +30.91

References

All references consist of a citation and an actual reference. The citation is a tag that contains a shorthand form of the reference, and is followed, on first use in an article, by the completed reference.

The LinkedEarth wiki uses APA style for citation

To create a reference:

  • First citation in the article:
Khider et al. <ref name = Khider_2014> Khider, D., Jackson, C. S., & Stott, L. D. (2014). Assessing millennial-scale variability during the Holocene: A perspective from the western tropical Pacific. Paleoceanography, 29(3), 143-159. doi:10.1002/2013pa002534 </ref>

becomes Khider et al. [1]

  • Subsequent citations
 Khider et al.<ref name = Khider_2014 />

will automatically create a footnote marker that will link to the original reference: Khider et al. [1]

Earth Science specific items

Nuclides are readily expressed using the SimpleNuclide2 extension. See NuclideExamples.

Adding a poll

The LinkedEarth wiki has polling capabilities. To create a poll use the following code:

<poll>
Question
Choice1
Choice2
Choice3
Choice4
</poll>

For instance,

<poll>
Are you a LinkedEarth member?
Yes
No
</poll>

returns:

Are you a LinkedEarth member?
You are not entitled to vote.
You are not entitled to view results of this poll.
There was one vote since the poll was created on 22:07, 23 September 2016.
poll-id 474C627E9B15778DB48641DEF721D3C1

  
Use different questions/answer for polls on the wiki. Otherwise, the system would automatically vote for all of the polls containing the same question. So be very specific if you need to be!
However, if you think a poll can apply to multiple pages, you can copy and paste the same poll on multiple pages. For instance, if you create a poll on a common nomenclature for expressing d18O on the Speleothem working group, the same poll can be posted on the Marine Sediment, MARPA, Ice Core working group pages. 

Editing an existing poll

  
 Editing an exiting poll will reset the votes. If you need to edit a poll, make sure you keep the results of the previous poll. 

For instance,

<poll>
Are you a recent LinkedEarth member?
Yes
No
</poll>
This poll was edited by ~~~~ and had 2 No and 1 Yes answer before editing. 

returns this on the wiki:

Are you a recent LinkedEarth member?
You are not entitled to vote.
You are not entitled to view results of this poll.
There were 0 votes since the poll was created on 20:52, 18 October 2016.
poll-id DDA943190EA4DE67DE6D049904B6D0CD

This poll was edited by Deborah Khider (talk) 13:53, 18 October 2016 (PDT) and had 2 No and 1 Yes answer before editing.

Signing your name

If you wish to sign your name on a page when making an edit, such as in the example above, use:
 ~~~~ 
Deborah Khider (talk) 13:55, 18 October 2016 (PDT)

Creating a new wiki page

To create a new page, type the link into your browser: http://wiki.linked.earth/New_Page and replace "New Page" above by the name that you want for the page.

Then, either select a category for this page (Figure 2):

Figure 2: Selecting a category for a new page

or, just click on the "Create" link to create a page without any category (Figure 3)

Figure 3: create page button, located on the bottom right of the page

Alternatively, you can search for the page you are looking for (remember that the wiki is case sensitive). If the page does not exist, you will be prompted to create it. You should always try to look for the term you want to define before creating a new page to avoid duplicate pages of similar concepts.

Deleting an existing wiki page

Go to the page you want to delete and select "Delete" from the drop down menu as shown in Figure 4.

Figure 4: Wiki page option menu

Click on the "Delete" link, and delete the page. You will be prompted to give a reason for the deletion.

Figure 5: Deleting menu

Renaming wiki pages

Wiki pages may need to be renamed because of typos in the page name or community agreement to rename a term in the LinkedEarth ontology. In order to rename an existing page without losing any of its contents, you should click on the "Move" button under the "More" menu on the top of the page (Figure 6)

Figure 6: Moving an existing wiki page

You will be prompted to enter the new name for the page and a reason for the change.

Figure 7: Moving a wiki page form.

References

  1. 1.0 1.1 Khider, D., Jackson, C. S., & Stott, L. D. (2014). Assessing millennial-scale variability during the Holocene: A perspective from the western tropical Pacific. Paleoceanography, 29(3), 143-159. doi:10.1002/2013pa002534