Difference between revisions of "Help:Wiki editing"

From Testiwiki
Jump to: navigation, search
(Design: tranlation)
(what you should know about Opasnet was copied from Category:DARM exercise)
Line 1: Line 1:
 
[[Category:Help]]
 
[[Category:Help]]
==Design==
+
:''This page used to have guidance for headings, lists, and font formatting. They were removed, because the same info is also available in [[Help:How to edit wikipages]] and [[Help:Quick reference for wiki editing]].
 
 
Right design of the text is important because then it's easy to read and understand the article's main point
 
 
 
===Headings===
 
 
 
Headings make the text more structured and they make it easier to read.
 
 
 
You can create headings by adding equal signs to boths sides of the desired heading.
 
 
 
<nowiki>=Heading=</nowiki>
 
 
 
If you want a smaller heading just add some more equal signs.
 
 
 
===Heading===
 
 
 
====A smaller heading====
 
 
 
===Text's appearance===
 
=====Bolding=====
 
'''Bolding''' brings out keywords or other important parts of the text. Bolding should not be overused, because it makes the text less clear and makes understanding of the text more difficult.
 
 
 
:Example:
 
 
'''Bolded text'''
 
 
<nowiki>'''Bolded text''', or <b>Bolded text</b></nowiki>
 
 
 
=====Italic=====
 
 
 
''Italics'' is a good way to attract attention to a part of the text. It is mainly used in quotes.
 
 
 
Example:
 
 
 
''Italic text''
 
 
<nowiki>''Italic text'', or <i>Italic text</i></nowiki>
 
 
 
=====Underlining=====
 
 
 
<u>Underlining</u> is a third option in emphasizing a part of the text.
 
 
 
Example:  
 
<u>Underlined word</u>
 
 
<nowiki><u>Underlined word</u></nowiki>
 
 
 
=====Indentations=====
 
 
 
Indentations make the text easier to read and they clarify the structure of the text. Indentations can be used to emphasize and clarify parts of the text.
 
 
 
Example:
 
This is normal text.
 
:This has been indented.
 
::This is a double indentation.
 
 
 
Code for indentations:
 
 
 
<nowiki>This is normal text.</nowiki>
 
<nowiki>:This has been indented.</nowiki>
 
<nowiki>::This is a double indentation.</nowiki>
 
 
 
===Lists===
 
 
 
It's easy to list facts in order using lists. You can also write lists without a specific order.
 
 
 
Listing goes like this:
 
 
 
=====Ordinary list:=====
 
 
 
*This is a thing.
 
*This is another thing.
 
**This is a corrective or a differentiation of the previous thing.
 
 
 
Code:
 
 
<nowiki>*This is a thing
 
*This is another thing
 
**This is a corrective or a differentiation for the previous thing.
 
</nowiki>
 
 
=====Numbered list:=====
 
 
 
#This is the first thing.
 
#This is the second thing
 
##This is the first correctice of the second thing.
 
 
 
Code:
 
 
<nowiki>#This is the first thing.
 
#This is the second thing
 
##This is the first corrective of the second thing.
 
</nowiki>
 
 
 
=====You can also combine lists like this:=====
 
 
 
*This is a thing
 
*#This is it's first clarification
 
*#*This is a corrective of the first corrective
 
 
 
Code:
 
 
 
<nowiki>*This is a thing
 
*#This is it's first clarification
 
*#*This is a corrective of the first corrective
 
</nowiki>
 
  
 
==Tables==
 
==Tables==
  
 
===Normal table===
 
===Normal table===
 +
 
Normal table or a "pretty table" is table which is used to present facts clearly in a table. These tables don't have any special properties and they can be used only in presenting facts. By pressing '''Table''' in the edit screen you can bring out the '''Table generator''', which lets you change the number of rows and columns of the table. By pressing '''Insert table code''' the table generator creates the code of the table on the page:
 
Normal table or a "pretty table" is table which is used to present facts clearly in a table. These tables don't have any special properties and they can be used only in presenting facts. By pressing '''Table''' in the edit screen you can bring out the '''Table generator''', which lets you change the number of rows and columns of the table. By pressing '''Insert table code''' the table generator creates the code of the table on the page:
  
Line 149: Line 45:
  
 
===Data table===
 
===Data table===
'''Datatable''' is a table which has some special properties. Datatables can be used as information for predictions and to count probabilites.
+
 
 +
'''Datatable''' is a table which has some special properties. The content of a datatable is stored in the [[Opasnet Base]] database, and it can be retrieved from there for modelling and other purposes.
  
 
<t2b  index="index1" Locations="Location0,Location1,Location2" unit="nro">
 
<t2b  index="index1" Locations="Location0,Location1,Location2" unit="nro">
Line 218: Line 115:
 
==Rating bar==
 
==Rating bar==
 
Arvostelupalkki on tärkeä osa artikkelia, sillä sen avulla on helppo havainnoida tai arvostella artikkelin tiedon laatua.
 
Arvostelupalkki on tärkeä osa artikkelia, sillä sen avulla on helppo havainnoida tai arvostella artikkelin tiedon laatua.
 +
 +
==What you should know about editing in Opasnet==
 +
 +
# Introduction to Opasnet
 +
#* purpose and history of Opasnet
 +
#* technical foundation: Mediawiki, same as in Wikipedia
 +
#* openness, transparency, collective knowledge creation/learning
 +
# Guided tour to structure, content and functionalities of Opasnet
 +
#* browsing, searching and reading Opasnet content
 +
#* structure of Opasnet
 +
#** English (open), Finnish (open), password protected Heande (project use)
 +
#* content: text, styling, tables, images, documents
 +
#* page history (no need to fear making mistakes!)
 +
#* creating a user account / logging in
 +
#* creating a new page
 +
#* page (object) types? &rarr; templates
 +
#* categorization
 +
#* ways of contributing to Opasnet
 +
#** commenting (no login required)
 +
#** discussion on talk page (login required)
 +
#** structured argumentation on talk page (login required)
 +
#** editing of the article page (login required)
 +
#** uploads (login required)
 +
#* help & examples
 +
#* edit conflict
 +
#** what is it?
 +
#** how to avoid?
 +
#** what to do if happens?
 +
#* wiki-markup vs. wikiwyg
 +
#* different browsers
 +
#* special pages
 +
# Practical exercises
 +
#* create a user account for yourself
 +
#** think of a good, descriptive user name for yourself
 +
#** add user information
 +
#** adjust your "my preferences"
 +
#* create a page for the topic you are working on
 +
#** choose a page type?
 +
#** give a good descriptive name for your page
 +
#** categorize your page
 +
#** page structure
 +
#** content?
 +
#* Browsing, searching, commenting, and discussing information in Opasnet
 +
#** find an assessment on "Farmed salmon" in Opasnet and see what it contains and how it is structured
 +
#** find out how many "variables" there are in Opasnet
 +
#** find out what kind of objects "methods" in Opasnet are, find at least one (representative) example
 +
#** find an interesting page in Opasnet and comment on it
 +
#*** with the comment box
 +
#*** by editing the discussion page

Revision as of 15:16, 16 December 2012

This page used to have guidance for headings, lists, and font formatting. They were removed, because the same info is also available in Help:How to edit wikipages and Help:Quick reference for wiki editing.

Tables

Normal table

Normal table or a "pretty table" is table which is used to present facts clearly in a table. These tables don't have any special properties and they can be used only in presenting facts. By pressing Table in the edit screen you can bring out the Table generator, which lets you change the number of rows and columns of the table. By pressing Insert table code the table generator creates the code of the table on the page:

{|{{prettytable}}
! Column title 0
! Column title 1
|-----
| element 0.1
| element 1.1
|-----
| element 0.2
| element 1.2
|}
Column title 0 Column title 1
element 0.1 element 1.1
element 0.2 element 1.2

If you untick PrettyTable-style the table looks like this:

Table topic
Column title 0 Column title 1
element 0.1 element 1.1
element 0.2 element 1.2

Data table

Datatable is a table which has some special properties. The content of a datatable is stored in the Opasnet Base database, and it can be retrieved from there for modelling and other purposes.

Difference between revisions of "Help:Wiki editing"(nro)
ObsLocation0Location1Location2
1Location0.1Location1.1Location2.1
2Location0.2Location1.2Location2.2

Code:

<t2b  index="index1" Locations="Location0,Location1,Location2" unit="nro">
Location0.1|Location1.1|Location2.1
Location0.2|Location1.2|Location2.2
</t2b>

Links

Links are ment to ease integrating external sources of information to an existing Opasnet page. You don't have to rewrite the page to Opasnet, and it is easy to link the existing information to Opasnet.

Internal links

Internal links guide you to an existing page in Opasnet:

Example: Opasnet user skills

Code:

[[Name of the page]]
e.g. [[Opasnet user skills]]

External links

External links take you to a page which is not a page in Opasnet:

Example: http://www.wikipedia.fi

Code:

 [Page's URL Page's name] or [Page's URL]
 [http://www.wikipedia.fi Wikipedia] or [http://www.wikipedia.com]
 
Wikipedia or [1]

You can also add a link by typing the URL of the page:

e.g. http://www.wikipedia.fi
http://www.wikipedia.fi

Files

You can add different kinds of files into Opasnet to add information or to clarify the message of the page. You can add a file by pressing Embedded file button on the editing screen.

File:Editing example.jpg

[[File:Example.jpg]]

Categories, categorizing

Categorizing eases finding the right pages. You create a cathegory by placing a page to the desired cathegory. By clicking the name of the category at the end of the page you will get to the class-page which lists all the pages of the category. There is also a short description of the cathegory.

[[Category:Name of the Category]]

If the page pelongs to more cathegories than one it should be written like this:

[[Category:Name of the Category]]
[[Category:Name of the Category]]
[[:Category:Name of the Category]] 

is a link to te cathegory which can be placed to the text.

Rating bar

Arvostelupalkki on tärkeä osa artikkelia, sillä sen avulla on helppo havainnoida tai arvostella artikkelin tiedon laatua.

What you should know about editing in Opasnet

  1. Introduction to Opasnet
    • purpose and history of Opasnet
    • technical foundation: Mediawiki, same as in Wikipedia
    • openness, transparency, collective knowledge creation/learning
  2. Guided tour to structure, content and functionalities of Opasnet
    • browsing, searching and reading Opasnet content
    • structure of Opasnet
      • English (open), Finnish (open), password protected Heande (project use)
    • content: text, styling, tables, images, documents
    • page history (no need to fear making mistakes!)
    • creating a user account / logging in
    • creating a new page
    • page (object) types? → templates
    • categorization
    • ways of contributing to Opasnet
      • commenting (no login required)
      • discussion on talk page (login required)
      • structured argumentation on talk page (login required)
      • editing of the article page (login required)
      • uploads (login required)
    • help & examples
    • edit conflict
      • what is it?
      • how to avoid?
      • what to do if happens?
    • wiki-markup vs. wikiwyg
    • different browsers
    • special pages
  3. Practical exercises
    • create a user account for yourself
      • think of a good, descriptive user name for yourself
      • add user information
      • adjust your "my preferences"
    • create a page for the topic you are working on
      • choose a page type?
      • give a good descriptive name for your page
      • categorize your page
      • page structure
      • content?
    • Browsing, searching, commenting, and discussing information in Opasnet
      • find an assessment on "Farmed salmon" in Opasnet and see what it contains and how it is structured
      • find out how many "variables" there are in Opasnet
      • find out what kind of objects "methods" in Opasnet are, find at least one (representative) example
      • find an interesting page in Opasnet and comment on it
        • with the comment box
        • by editing the discussion page