Wikihost.org System Wiki - Page wiki:syntax

---

Home || Edit wiki:syntax || History of wiki:syntax || Discuss (0)

include || User manual || Macros || Namespaces || Special links || Wiki formatting syntax || Templates || Uploading files & images ||

---

The syntax of wiki pages

Here is a short explanation of the wiki syntax.
To turn off the wiki syntax interpretion for a certain area in your text you can use the |# and #| signs to mark it.

Simple text formatting

By enclosing a text with ** you can make it appear in bold.

If you prefer it to be underlined you better use the __ tags.

For those who think twice is better than once, it is of course possible to combine **__both tags__**.

Once, it was shown in italic style by simply being surrounded by two //slashes//.

In case you want to show that some part of a text area not uptodate anymore you just need to use -- before and after.

Sometimes it is really useful to have monospaced fonts because then especially the illustration of programming source code is easy to handle.
To do so, simply enclose your code by two ~~ pairs.


Preformatted text blocks can be achieved

by
simply adding
   two or more blanks in front
        of the
line.

This is interesting for simple tables or source codes.
Preformatted texts won't be processed any further.

---

Lists

One can easily instruct GeboGebo to display an unordered as well as an ordered list by simply beginning the line with either a * or a # followed by a blank.

• This is the very first item
• in the list, this is the second
• and we are unnumbered

A hierarchical list like this:

1. A list automatically ends
2. when it is followed by an empty line,
   • hierarchical lists
   • work, too
     1. if ever needed
   • a headline or
3. the end of the page

Is made by inserting a single extra space in front of each additional level of indentation, like this:

# A list automatically ends
# when it is followed by an empty line,
 * hierarchical list
 * works, too
  # if ever needed
# a headline or
# the end of the page

Two extra spaces at a time result in preformatted text (the way the example code for the list appears), rather than additional levels of indentation.

---

Headlines

There are 5 different levels of headlines possible. A headline is signaled by having two to six = signs at the beginning of a new line.
The headline then reaches from the first character after the last (maximum 6th) = sign to the end of the line. No other GeboGebo-tags within a headline are interpreted.

====== is a maximum level 5 headline

===== is a headline one level below

==== is a headline one level below

=== is a headline one level below

== is a headline of the lowest possible level

Rulers

A ruler can be accomplished by placing four - minus at the beginning of a new line.

----

---

References

Wikihost.org knows 3 types of references (= links to items, images and files). Items are regular wiki pages and special action links.

Links

There are two types of links: Internal links to other pages and external links pointing to other web sites.
External links always open the targeted page in a new browser window.
Pages can be organized in namespaces (img:, gebo:, file:, talk: and user: are resevered special namespaces!) by dividing the name with a colon. Example: [[wiki:namespace]] is the same as [[namespace]]

Read this separate overview of special internal links.

The tag [[ signals the beginning of a link. It is closed again by ]]. Between those tags it is possible to define a target page name or an URL beginning with http://, https:// or ftp://.
If another text than the target name or the given URL shall appear for the link, it is possible to add an alternative link text after a | (= pipe) sign.

[[syntax]] becomes syntax whereas [[syntax|Syntax explanation]] becomes Syntax explanation

Both links point to the very same page. (the one you are reading at the moment)
Most of the times, depending on the wiki design used, a red link indicates that there is not yet any content at the targets pages name.

[[http://www.wikihost.org]] becomes http://www.wikihost.org whereas [[http://www.wikihost.org|wikihost.org]] becomes wikihost.org

External links are always shown with a symbol indicating that the link will open an external address in a new browser window.

Images

Images are also divided into two categories: internal and external.
Internal images have to be uploaded. This is only possible if the administrator of your GeboGebo installation enabled image upload. Read about uploading for more details.

Images are referenced by {{ and }} tags. The name of an image must start with img:.

{{img:sample}} is the reference to an internal stored image named img:sample:
As long as no image has been uploaded under that name into GeboGebo, it will appear a small image showing a landscape and the name of the missing image page as red colored link.

{{img:sample2}} points to an existing image img:sample2 now:
The images appears as expected now.

An external image (= any image you can reach on the web) can be inserted as follows:
{{http://www.gebogebo.org/sample3.gif}} and should then easily appear on your page:

By adding a seconds sequence indicated by an | (= pipe) you can define new values for the width and height of the image to display. This works for both, internal and external images.

{{http://www.gebogebo.org/sample3.gif|100x50}} causes

{{http://www.gebogebo.org/sample3.gif|100x}} causes

{{img:sample2|x40}} causes

For the professionals of you there is the possibility of a third sequence to be used.
It is again indicated by | (= pipe) and may contain 200 character long style sheet definitions.
This can be very useful if you want to let text flow around your image as shown here by {{img:sample2|x40|float:left;margin:10px;}}

Internal images are always clickable and lead to the [[img:name]] page. If you want to set a link to an internal image page without showing the image itself, simply use [[img:sample2]] instead of {{img:sample2}}: img:sample2




If an internal image not yet exists, it will be shown a placeholder image, already using optional styling parameters:

Files

File upload must be enabled on your GeboGebo installation. If you are in doubt, ask the administrator. If you are the administrator, set the corresponding option in your gebogebo.conf file to 1.
Read about uploading for more details.

---

Tables

Tables	are easy
work almost identically as for mediawiki (wikipedia)
1st column	2nd Columng

This table is achieved by this code sequence:

{| border=1; style="border:solid 1px; border-collapse:collapse;"
|Tables
|are easy
|- bgcolor=red
|:colspan=2:|work almost identically as for mediawiki (wikipedia)
|-
|:bgcolor=silver:|1st column
|2nd Column
|}

Tables, table rows and table cells always start with the very first character in a line.
The table beginning is signalled with a {| and the end with |}.
Each cell is initiated with either a | (=pipe) or a ! .
Rows are switched by using |- .

Cell formattings can be placed in a special tag in front of the cell:

|:bgcolor=silver:|1st column

Formatting on whole rows are done like here:

|- bgcolor=red

Please keep in mind that each cell has to start in a new line.

---

Boxes

You can create boxes for organizing a pages content in almost any way you like. A box can contain any other formatting and is styleable with CSS.



[box|style="width:33%;border:1px solid green;float:right;background-color:silver;padding:10px;"] **Box headline** My **Box** Content [/box]
creates a box as seen on the right.

---

Comments

You can place comments inside a wiki page which are only visible to editors, not to readers. /* indicates the beginning of a comment and */ marks its end.
The comment can be of any length. The text between the comment markers won't be processed by the wiki render engine and it won't make it into the HTML output.

Content inclusion

You can include the content of other pages with two << at the very beginning of a new line followed by the name of the page to include. If a page to include belongs to a certain namespace, you will have to fully qualify the name.

<<include

will include the content of wiki:include. The dashed box signals that the content is from another page.

wiki:include

Maximum recursion depth is currently 10 times.

Macros

Wikihost.org wikis can make use of some predefined macros that provide dynamic/special content. A macro needs to be placed within two ''apostrophs'' and then will be evaluated during the page rendering.