Skip to content

Course Element "Wiki"

Profile

Name Wiki
Icon
Available since Release 7.1 or earlier
Functional group Communication and collaboration
Purpose Collaborative content creation
Assessable no
Specialty / Note

Use a Wiki to easily create content together with participants. A wiki is suitable for group work, as a documentation tool and generally for writing texts together. The individual pages are linked to each other as hypertext.

In the course editor

With the "Wiki" course element, you integrate a wiki learning resource into your course. You will find the settings under:
Course > Administration > Course editor > Course element "Wiki" > Tab "Wiki learning content"

As long as no wiki is assigned, the tab "Wiki learning content" offers three ways: With "Select" you assign an existing wiki, with "Create" you create a new one, and with "Import" you import a wiki from a file.

If a wiki learning resource is already assigned, its name appears. To change the assignment later, click on "Replace" in the tab "Wiki learning content" and select another wiki. With the arrow next to "Replace" you create or import a new one instead.

In the "Wiki learning content" tab, you also define who may edit the wiki. Under "Edit Material" you allow coaches and participants, in addition to the owners, to edit wiki articles. By default all participants have read and write permission in a Wiki. A wiki page can be deleted by the person who created it, by the owners of the course and by the owners of the wiki learning resource.

Important

If you can't find the "Wiki" course element in your OpenOlat instance, the wiki resource is disabled system-wide. Administrators enable it in the system administration: Administration > Modules > Wiki, option "Enable wiki resource".

Working with Wiki (closed course editor)

In the course menu the expanded Wiki menu with all pages of the wiki, next to it the editor of the page Index with the tabs Article, Discussion, Edit page and Versions/authors

If a Wiki is embedded in a course, the "Wiki menu" and other Wiki links appear in the left course navigation. Use the "From A-Z" link to call up the table of contents with all Wiki pages. This way you see at a glance which pages already exist.

In the main area, you read the Wiki contributions (tab "Article"), edit the wiki pages (tab "Edit page"), hold discussions on the individual Wiki pages (tab "Discussion") and view the editing history (tab "Versions/authors"). You can also export the Wiki as a content package (CP) and be informed about changes.

Creating new Wiki pages

You create a new Wiki page with the "Create" button and then fill it with content. The page created in this way is not yet connected to any other page of the Wiki. So that readers find it, link the page in the "Wiki menu" or on the "Index" page of the Wiki.

Alternatively, create an internal link on the page where the link to the new Wiki page should appear. Use the "Internal link" button of the Wiki editor or enter the syntax directly: two opening square brackets, the page name and two closing square brackets, for example [[link name]].

OpenOlat creates the page automatically the first time the link is called.

Button "Internal link" in the toolbar marked, in the editor below the inserted placeholder [[Link text]], which you replace with the name of the new page

Change contents of a wiki page

To edit the content of a wiki page, select the "Edit page" tab of the desired wiki page:
Course > Course element "Wiki" > "Page name" > Tab "Edit page"

The Wiki editor appears with various formatting options. Here you also include images, media links, mathematical formulas as well as internal and external links in your wiki. In addition to the buttons in the editor, there are other formatting options that you insert directly in the text as syntax elements. The following section explains the wiki syntax.

Wiki Syntax

You can format your input using the following wiki syntax.

Attention

It is recommended to use special characters in Wikiwords with restraint. The colon (:) is not allowed. Also note that a space at the beginning of a line is interpreted as a formatting command (Preformatted Text).

Text design

Syntax Result (Formatting)
'''Bold text''' Bold text
''Italic text'' Italic text
==Level 2 Headline==

Level 2 Headline

* List
  • List
  • # Numbered list 1. Numbered list
    Syntax Result (Formatting)
    [[Internal link]] Internal link
    [[Link | Text]] Text
    External link [http://www.openolat.org] http://www.openolat.org
    [http://www.openolat.org The Website of OpenOlat] The website of OpenOlat

    OpenOlat automatically converts external addresses to a link if you provide the full address: http://www.openolat.org. If you want to specify a different term instead of the link, put the URL and the term together in square brackets, separated by a space.

    Tables

    Single Row

    {|
    |Cell 1
    |Cell 2
    |}| Cell 1 Cell 2
    

    Cell 1 Cell 2

    Multiple Rows

    {|
    |Cell 1
    |Cell 2
    |-
    |Cell 3
    |Cell 4
    |}|
    

    Cell 1 Cell 2
    Cell 3 Cell 4

    With frame

    {| border="1"
    |Cell 1
    |Cell 2
    |-
    |Cell 3
    |Cell 4
    |}
    
    Cell 1 Cell 2
    Cell 3 Cell 4

    Pictures and other files

    For example, to add images to the wiki, first upload them to OpenOlat with the "Upload file" button. As soon as the wiki contains at least one file, the drop-down menu "Insert file" appears, with which you insert images and other files.

    [[Image:openolat_logo_72.png]]

    OpenOlat Logo

    When inserting the image, the following optional formatting options are available:

    Caption

    [[Image:openolat_logo_72.png | This is the OpenOlat logo.]]|

    OpenOlat Logo
    This is the OpenOlat logo.

    Alignment

    Use the "left" or "right" addition to specify how the image should be aligned.

    [[Image:openolat_logo_72.png|right]]

    OpenOlat Logo

    Picture size

    Specify in pixels how large the image should be displayed.

    [[Image:openolat_logo_72.png|120px]]|

    OpenOlat Logo

    Miniature picture

    If you select the "thumb" addition and a small image size, the image will be inserted as a thumbnail. Clicking on the image will display it in full size.

    [[Image:openolat_logo_72.png|thumb|24px]]

    OpenOlat Logo

    Combined formatting

    Multiple formatting options can also be used simultaneously.

    [[Image:olat_logo.png|center|150px|thumb|Das ist das OpenOlat-Logo.]]

    OpenOlat Logo

    Other files: PDF

    [[Media:any.pdf]]

    Link to the file any.pdf

    Mathematical formulas (LaTeX)

    OpenOlat displays the formulas in the browser with MathJax.

    The syntax of the mathematical notation used in OpenOlat can be found at: http://meta.wikimedia.org/wiki/Help:Formula

    Syntax

    <math>Insert formula here</math>
    

    Inline Mode

    \(x^2\)

    x2

    Unformatted Text

    <nowiki>Insert the unformatted text here</nowiki>
    

    Insert the unformatted text here

    Note

    Further information on the wiki syntax of MediaWiki can be found here: https://www.mediawiki.org/wiki/Help:Formatting

    To attach a file, first upload it via "Upload file". Navigate to the location on the wiki page where you want the file to appear. Then select the file via "Insert file" and confirm with "Save". You create links to other wiki pages with "Insert link". The toolbar of the editor offers further formatting options.

    You create links to files in the "Folder" course element by clicking on the metadata icon Metadata symbol and then copying the link under "External link to this resource". You can only link to files that are in a subfolder of a "Folder" course element.

    With the link "Export as CP", all participants export the wiki as an IMS content package and save it. Authors can import an exported CP into OpenOlat as a CP learning resource, but not as a wiki.

    Important

    If a wiki is to be exported directly as a wiki, this is only possible for the owners of the wiki directly in the learning resource: Wiki > Administration > Copy or Wiki > Administration > Export content. Participants do not have this option.

    Attention

    If you delete a page, OpenOlat also deletes all its versions. Deleted pages cannot be restored.

    Further information

    Mentioned on this page
    MediaWiki: Help on formulas
    MediaWiki: Help on formatting

    Further reading
    Creating Wikis >
    Types of Course Elements >
    Using Group Tools >

    To the top of the page ^