Simple wiki editing examples: Difference between revisions

From OpenWetWare
Jump to navigationJump to search
No edit summary
 
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
This page will show you how to do 99% of the edits you're likely to do on the wikiThere are more complicated editing examples (tables, etc), which can be found on the [Help:Contents|help]] page.
==Editing==
The point of a Wiki is that all users can edit and update information and create new pages altogether.  On all pages of the Wiki (including this one), you will see an "edit" link at the very topIf you click on it, you will see the source code for that particular page (this one will seem very complicated at first -- don't worry about it).  To return to the real page, click on the "article" link, also at the top of each page.


This is how to [http://web.mit.edu/beboard link] to a website.
The rest of this page will contain the basic rules of editing and creating Wiki pages.  One easy way to get started is simply to copy the source code from one page, and paste it into another page before editing the text in it. The formatting will remain identical to the first page, but you can edit the contents if you only change the text paragraphs.


This is how to [[MIT Biological Engineering Graduate Student Board|link]] to a wiki page, or simply : [[MIT Biological Engineering Graduate Student Board]].
For further information on editing a Wiki, go to [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page this page].


#these
*To '''edit an existing page''', just click the "edit" link at the top.  Do your work, and then don't forget to '''save''' the page! 
#are
*To '''create a new page''', you should first [[Simple wiki editing examples#Links | make a link]] to the new page in an existing page (like the Wiki's main page, or from any other page).  The link will appear in red, indicating that the linked page doesn't exist yet.  If you click on any red link, you will be taken directly to the new page's "edit" section, so you can create the page.  It's perfectly reasonable to create links to nonexisting pages in your text without immediately creating the pages they point to.  Other people can then see the red links and create the pages themselves if they know what belongs there.
#*bullets
#**hooray


==Heading==
==Formatting a Page==
wow
Breaking up your page into different sections will make it much easier to read.  If you create enough different sections, a table of contents like the one at the top of this page will be created automatically.  This is very easy to do:
===Sub Heading===
this  
==Heading 2==
is
===See how easy?===
easy


{| border="1" cellpadding="5" cellspacing="1" align="center"
|-
|colspan="2" align="center"|'''Breaking the page into sections'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|
<nowiki>== New section ==</nowiki><br>
<nowiki>=== Subsection ===</nowiki><br>
Text written in subsection<br>
<nowiki>==== Sub-subsection ====</nowiki><br>
<nowiki>===== Sub-sub-subsection =====</nowiki>
|width="50%" valign="top"|
'''<font style="font-size:150%;color:black;">New section</font>'''


It makes the table of contents automatically!
'''<font style="font-size:130%;color:black;">Subsection</font>'''


This is '''bold''' and this is ''italic''
Text written in subsection
 
'''<font style="font-size:110%;color:black;">Sub-subsection</font>'''
 
'''<font style="font-size:100%;color:black;">Sub-sub-subsection</font>'''
|}
 
 
 
----
===Lists===
 
Lists make your page much more organized as well.  They are extremely simple to create:
 
{| border="1" cellpadding="5" cellspacing="1" align="center"
|-
|colspan="2" align="center"|'''Basic Bulleted List:'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|<nowiki>*first bullet</nowiki><p><nowiki>*second bullet</nowiki>
|width="50%" valign="top"|
*first bullet
*second bullet
|-
|colspan="2" align="center"|'''Basic Numbered List:'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|<nowiki>#first item</nowiki>
<nowiki>#second item</nowiki><br>
<nowiki>#third item</nowiki>
|width="50%" valign="top"|
#first item
#second item
#third item
|-
|colspan="2" align="center"|'''Bulleted List with sub-sections:'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|<nowiki>*first item</nowiki>
<nowiki>*second item</nowiki><br>
<nowiki>**subtopic</nowiki><br>
<nowiki>*third item</nowiki>
|width="50%" valign="top"|
*first item
*second item
**subtopic
*third item
|-
|colspan="2" align="center"|'''Numbered List with sub-sections:'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|<nowiki>#first item</nowiki>
<nowiki>#second item</nowiki><br>
<nowiki>##subtopic</nowiki><br>
<nowiki>##another subtopic</nowiki><br>
<nowiki>#third item</nowiki>
|width="50%" valign="top"|
#first item
#second item
##subtopic
##another subtopic
#third item
|-
|colspan="2" align="center"|'''Mixed List with sub-sections:'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|<nowiki>#first item</nowiki>
<nowiki>#second item</nowiki><br>
<nowiki>#*subtopic</nowiki><br>
<nowiki>#*another subtopic</nowiki><br>
<nowiki>#third item</nowiki>
|width="50%" valign="top"|
#first item
#second item
#*subtopic
#*another subtopic
#third item
|-
|colspan="2" align="left"|Lists like these can be customized with any number of subsections and sublists, using the same logic as above.  You can put a bulleted list within a numbered list within a bulleted list, etc.
|}
 
==Links==
 
Linking to other pages will allow people to follow referenced information more easily.  You can link to existing pages, and also to nonexisting pages.  A link to a nonexisting page will appear in <font color=red>red</font>, indicating that the page needs to be created. 
 
There are two types of links: internal links pointing to other pages of the Wiki, and external links pointing to other websites.  Here's how they work:
 
{| border="1" cellpadding="5" cellspacing="1" align="center"
|-
|colspan="2" align="center"|'''Internal Link (to a page on the Wiki):'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|<nowiki>[[Silver Lab]]</nowiki><br>
<nowiki>[[Silver Lab | Link to main Silver Lab page]]</nowiki><br>
(put the page name on the left, and then what you want the link to say on the right of the vertical bar)
|width="50%" valign="top"|
[[Silver Lab]]
 
[[Silver Lab | Link to main Silver Lab page]]
 
(the second link goes to the same page, but can say whatever you want it to say rather than just the page title)
|-
|colspan="2" align="center"|'''External Link (to another website):'''
|-
|width="50%" valign="top"|Typing '''this''' on the "edit" page:
|width="50%" valign="top"|Results in '''this''' on the final published page:
|-
|width="50%" valign="top"|<nowiki>http://www.harvard.edu</nowiki><br>
(just enter the page address, it will turn into a link automatically)<br>
|width="50%" valign="top"|
http://www.harvard.edu
 
|-
|<nowiki>[http://www.harvard.edu]</nowiki><br>
(or you can enter an address in brackets to make a short link)<br>
|[http://www.harvard.edu]
 
|-
|<nowiki>[http://www.harvard.edu Go to Harvard's website!]</nowiki><br>
(or you can give the link a different text)
|[http://www.harvard.edu  Go to Harvard's website!]
 
(the link goes to the same page, but can say whatever you want it to say rather than just the page address)
|}
 
==Other Formatting==
 
You can make any text bold or italicized.  Just highlight it (on the edit page) and click the '''B'''old or '''''I''''' talics button at the top of the editing box. 
 
In the editing box you can also find other useful formatting tools, including the tool to '''insert a picture'''.  To insert a picture, you first need to upload it to the Wiki server.  You can do this by clicking the "upload file" link, which is on the left of any Wiki page (near the top).  Once you've uploaded the file and given it a name, just click the "Embedded image" button at the top of the editing box of any page, and enter the new file's name. 
 
You can also easily insert a horizontal dividing line like the one below:
----
Just click the "horizontal dividing line" button at the top of the editing box.
 
To insert comments in the wiki source code that will be unseen when the page renders, use this format: <nowiki><!--Comment--></nowiki>
 
For further information on editing a Wiki, go to [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page this page].

Latest revision as of 17:37, 31 January 2011

Editing

The point of a Wiki is that all users can edit and update information and create new pages altogether. On all pages of the Wiki (including this one), you will see an "edit" link at the very top. If you click on it, you will see the source code for that particular page (this one will seem very complicated at first -- don't worry about it). To return to the real page, click on the "article" link, also at the top of each page.

The rest of this page will contain the basic rules of editing and creating Wiki pages. One easy way to get started is simply to copy the source code from one page, and paste it into another page before editing the text in it. The formatting will remain identical to the first page, but you can edit the contents if you only change the text paragraphs.

For further information on editing a Wiki, go to this page.

  • To edit an existing page, just click the "edit" link at the top. Do your work, and then don't forget to save the page!
  • To create a new page, you should first make a link to the new page in an existing page (like the Wiki's main page, or from any other page). The link will appear in red, indicating that the linked page doesn't exist yet. If you click on any red link, you will be taken directly to the new page's "edit" section, so you can create the page. It's perfectly reasonable to create links to nonexisting pages in your text without immediately creating the pages they point to. Other people can then see the red links and create the pages themselves if they know what belongs there.

Formatting a Page

Breaking up your page into different sections will make it much easier to read. If you create enough different sections, a table of contents like the one at the top of this page will be created automatically. This is very easy to do:

Breaking the page into sections
Typing this on the "edit" page: Results in this on the final published page:

== New section ==
=== Subsection ===
Text written in subsection
==== Sub-subsection ====
===== Sub-sub-subsection =====

New section

Subsection

Text written in subsection

Sub-subsection

Sub-sub-subsection



Lists

Lists make your page much more organized as well. They are extremely simple to create:

Basic Bulleted List:
Typing this on the "edit" page: Results in this on the final published page:
*first bullet

*second bullet

  • first bullet
  • second bullet
Basic Numbered List:
Typing this on the "edit" page: Results in this on the final published page:
#first item

#second item
#third item

  1. first item
  2. second item
  3. third item
Bulleted List with sub-sections:
Typing this on the "edit" page: Results in this on the final published page:
*first item

*second item
**subtopic
*third item

  • first item
  • second item
    • subtopic
  • third item
Numbered List with sub-sections:
Typing this on the "edit" page: Results in this on the final published page:
#first item

#second item
##subtopic
##another subtopic
#third item

  1. first item
  2. second item
    1. subtopic
    2. another subtopic
  3. third item
Mixed List with sub-sections:
Typing this on the "edit" page: Results in this on the final published page:
#first item

#second item
#*subtopic
#*another subtopic
#third item

  1. first item
  2. second item
    • subtopic
    • another subtopic
  3. third item
Lists like these can be customized with any number of subsections and sublists, using the same logic as above. You can put a bulleted list within a numbered list within a bulleted list, etc.

Links

Linking to other pages will allow people to follow referenced information more easily. You can link to existing pages, and also to nonexisting pages. A link to a nonexisting page will appear in red, indicating that the page needs to be created.

There are two types of links: internal links pointing to other pages of the Wiki, and external links pointing to other websites. Here's how they work:

Internal Link (to a page on the Wiki):
Typing this on the "edit" page: Results in this on the final published page:
[[Silver Lab]]

[[Silver Lab | Link to main Silver Lab page]]
(put the page name on the left, and then what you want the link to say on the right of the vertical bar)

Silver Lab

Link to main Silver Lab page

(the second link goes to the same page, but can say whatever you want it to say rather than just the page title)

External Link (to another website):
Typing this on the "edit" page: Results in this on the final published page:
http://www.harvard.edu

(just enter the page address, it will turn into a link automatically)

http://www.harvard.edu

[http://www.harvard.edu]

(or you can enter an address in brackets to make a short link)

[1]
[http://www.harvard.edu Go to Harvard's website!]

(or you can give the link a different text)

Go to Harvard's website!

(the link goes to the same page, but can say whatever you want it to say rather than just the page address)

Other Formatting

You can make any text bold or italicized. Just highlight it (on the edit page) and click the Bold or I talics button at the top of the editing box.

In the editing box you can also find other useful formatting tools, including the tool to insert a picture. To insert a picture, you first need to upload it to the Wiki server. You can do this by clicking the "upload file" link, which is on the left of any Wiki page (near the top). Once you've uploaded the file and given it a name, just click the "Embedded image" button at the top of the editing box of any page, and enter the new file's name.

You can also easily insert a horizontal dividing line like the one below:


Just click the "horizontal dividing line" button at the top of the editing box.

To insert comments in the wiki source code that will be unseen when the page renders, use this format: <!--Comment-->

For further information on editing a Wiki, go to this page.