Editing a Wiki Page is really simple. You can insert
WikiMarkup, standard
XHTML or use the integrated
Format Helper Toolbar. In all the cases, you can format the text and insert links, images and many other items in a simple and quick fashion.
1 - WikiMarkup
The
WikiMarkup is a particular set of prefixes and suffixes that allow to format the text and insert items, such as links and images. In this section you'll learn how to use the
WikiMarkup.
1.1 Basic Text Formatting
- Writing
'''bold'''
produces bold - Writing
''italic''
produces italic - Writing
__underlined__
produces underlined - Writing
--striked--
produces striked - You can use any combination, for example
--striked '' '''bold''' and italic''--
produces striked bold and italic
1.2 - Links
Links are identified with
[
and
]
.
Note: since version 1.0.10, links also work with 2 brackets, for example
[[Link]]
.
- To insert a link to an internal page just write
[PageName]
, that produces PageName (if the linked Page doesn't exist, the link will have a different color) - You can add a title to the link:
[PageName|This is a Link]
produces This is a Link - Email links are detected automatically, for example
[mail@server.com]
produces mail@server.com.
Obviously you can add a title: [mail@server.com|Contact us]
becomes Contact us - External links are marked with a special icon:
[http://www.screwturn.eu]
produces http://www.screwturn.eu - You can link to an internal file or subdirectory:
[blog/|Blog]
produces Blog and [GPL.txt|GPL]
produces GPL - If you add a
^
sign to the URL, the link will open in a new browser window, for example [^MyPage]
.
You can upload files using the
File Management interface.
1.2.1 - Notes
Links and Images share the same general syntax, but the number of fields changes.
1.2.2 - Categories
You can link a
Category by using the following syntax:
[c:CategoryName]
For example, you can link the
Help category or all the
uncategorized Pages (
[c:-|uncategorized Pages]
).
1.2.3 - Page Attachments
You can
attach a file to a Page using the following syntax:
[attachment:File.jpg]
Attachment are listed at the bottom of the Page. Please note that this function is still quite "raw", and the attached files are not real attachments, but just links to some
uploaded files.
1.3 - Headings
You can create headings using a sequence of equal (
=
) signs:
==Biggest Heading (H1)==
===Big Heading (H2)===
====Small Heading (H3)====
=====Smallest Heading (H4)=====
- The first 3 Headings work as separators, the latter is only a small heading (use it sparingly)
- H1 is not recommended because it's used for the Page Title and therefore may cause confusion
Note: headings must be placed at the beginning of lines.
1.3.1 - Horizontal Line
You can place a horizontal line using four hyphens
----
.
1.4 - Images
Images use
[
and
]
as delimiters.
Note: since version 1.0.10, images also work with 2 brackets, for example
[[image|Title|Url]]
.
There are several types of images:
[image|Title|Url|Big Url/Link Url (optional)]
inserts an inline image, without borders nor legend[imageleft|Title|Url|Big Url/Link Url (optional)]
and [imageright|Title|Url|Big Url (optional)]
insert images aligned respectively on the left and on the right, displaying borders and a description[imageauto|Title|Url|Big Url/Link Url (optional)]
inserts an image with automatic alignment, displaying borders and description- In all the cases, Big Url/Link Url is optional; when specified, it links the image with its big version or with any another document
You can upload images and files using the
File Management interface.
1.4.1 - Notes
Links and Images share the same general syntax, but the number of fields changes.
1.5 - Lists
A list is made by a sequence of lines starting with one or more asterisks (
*
) and/or diesis (
#
). You can create nested list using more than one asterisk or diesis.
* Element 1 * Element 2 produces
|
# Element 1 # Element 2 produces- Element 1
- Element 2
|
# Element 1 # Element 2 #* Element 2.1 #* Element 2.2 # Element 3 produces- Element 1
- Element 2
- Element 3
|
# Element 1 # Element 2 #* Element 2.1 #*# Element 2.1.1 #*#* Element 2.1.1.1 # Element 3 produces- Element 1
- Element 2
- Element 3
|
1.6 - Code and the NoWiki Tag¶
If you want to insert an inline piece of code, wrap it with
{{
and
}}
; for example
{{This is code}}
produces
This is code
.
If you want to insert a block of code, for example a C# class, wrap it with
{{{{
and
}}}}
, as in
using System;
namespace MyNamespace {
public class HelloWorld {
public static void Main(string[] args) {
Console.WriteLine("Hello World");
}
}
}
If you want to exclude a block of text from the WikiMarkup formatting, wrap it with
<nowiki>
and
</nowiki>
, for example
<nowiki>[MyPage]</nowiki>
produces [MyPage].
1.6.1 - The @@ Tag
If you need to place some code that contains, for example, XML and even WikiMarkup and you want it to be displayed exactly as is, wrap with with two
@:
@ @
<xml>
'''Bold'''
<bla z="b" />
</xml>
@ @
Removing the space between the
@ signs, the result is:
<xml>
'''Bold'''
<bla z="b" />
</xml>
1.7 - Line Breaks
Two line breaks are treated as they are. A single line break is ignored. If you want to insert a single line break, you can use the standard XHTML tag
<br />
or its
WikiMarkup alias
{BR}
(letter casing is ignored). It's not recommended to abuse single line breaks because they tend to create confusion in the page.
1.8 - Special Tags
The ScrewTurn Wiki engine provides a few special markers that are replaced automatically with specific content. All these tags ignore the letter casing.
{wikititle}
produces Yugopedia - La información silenciada de UE y EEUU sobre Yugoslavia (the title of the Wiki){up}
produces GetFile.aspx?File= (the file upload path){top}
produces Arriba (link to the top of the current Page){toc}
produces the Table of Contents of the Page, using Hx headers as titles{themepath}
produces Themes/Elegant/ (the current theme path){rsspage}
produces
(the link to the current Page's RSS feed, available only in Pages){wikiversion}
produces 3.0.5.640 (the version of the Wiki engine){mainurl}
produces http://www.yugopedia.org/wiki/ (the Main URL of the Wiki){pagecount}
produces 187 (the # of Pages in the Wiki)Invitado
inserts the Username of the current user{cloud}
inserts a Categories Cloud{searchbox}
inserts a Search Box (only one Search Box can be used at a time){clear}
to use when inserting images at the bottom of a Page
1.9 - Boxes
If you want to wrap some content inside a box, use triple brackets
(((
and
)))
. For example,
(((My box)))
produces
My box
1.10 - Text Indentation
The text can be
indented using one or more colons, at the
beginning of a line.
: Single indentation
:: Double indentation
results in
Single indentation
Double indentation
1.11 - Tables
The
WikiMarkup also supports tables. Since the tables offer many options, they are described in the dedicated section
Tables.
1.12 - User Signature
Users can sign their edits using four tildes:
~~~~
. The result is the following:
Dario Solera, 2007/02/15 10:391.13 - Snippets and Page Transclusion¶
To use the special features called
Snippets and
Page Transclusion, please go to the dedicated pages:
1.14 - Page Redirection
You can redirect a user automatically to another Page when he visits a Page. You can just add the following code
at the beginning of the Page:
>>> [PageName]
or
>>> PageName
When the user visits a Page containing a Redirection tag, the engine will display the destination Page. At the top of the destination Page Page, a message will be displayed, containing a link for visiting the origin Page without being redirected.
1.15 - XHTML Support and Escaping¶
ScrewTurn Wiki supports standard XHTML content. You can use any tag, except for
<script>
that might be disabled by the administrators.
XHTML comments are also supported:
<!-- -->
.
If you want to insert a block of HTML or XML displaying the tags, you can use the
<esc></esc>
tag. This tags escapes all the angular brackes making them visible.
<esc><strong>Your tag</strong></esc>
produces
<strong>Your tag</strong>
2 - Format Toolbar
In the editing page there is the toolbar reported in this picture:
 Format Toolbar |
The list of the buttons is reported below.
- Bold: sets/unsets selected text as bold
- Italic: sets/unsets selected text as italic
- Underlined: sets/unsets selected text as underlined
- Striked: sets/unsets selected text as
striked - H1: sets/unsets selected text as Header Level 1 (unrecommended)
- H2: sets/unsets selected text as Header Level 2
- H3: sets/unsets selected text as Header Level 3
- H4: sets/unsets selected text as Header Level 4 (use sparingly)
- Subscript: sets/unsets selected text as subscript
- Superscript: sets/unsets selected text as superscript
- Page link: allows to insert a link to a Wiki Page using a menu
- File link: allows to insert a link to an uploaded file
- External: allows to insert a link to an external destination
- Image: allows to insert an image using a simple Image Browser
- Anchors: shows two items, the first allows to inserts anchors in the text, the second allows to insert links to anchors in the text
- Inline Code: sets/unsets selected text as
code
- Block Code: sets/unsets selected text as a block of code
- Box: wraps/unwraps selected text with
(((...)))
- Line Break: inserts a single line break in the text
- Insert Snippet: allows to insert a Snippet using a menu
- Special Tags: shows a list of available special tags which, once clicked, insert a specific special tag in the text
- NoWiki: wraps/unwraps selected text with
<nowiwi>...</nowiwi>
tags - Comment: wraps/unwraps selected text with XHTML comment tags
- Escape: wraps/unwraps selected text with escape tags
3 - Other Codes using installed plugins
3.1 - {CategoryList
}
Displays a list of all of the categories in your wiki with links to the page that displays those category's pages. The list it produces is wiki text which is then interpreted by the main formatting engine. Example:
[AllPages.aspx?Cat=Community|Community]
[AllPages.aspx?Cat=Development|Development]
[AllPages.aspx?Cat=-|Uncategorized]
3.2 - {CategoryIndex:CategoryName
}
This class takes a parameter that is a category name. If left off, the category name will be assumed to be "*" (i.e. all categories). The category name Index will be automatically skipped in cases.
The list produced by this class is a list of all pages organized by category. If a page has more than one category, then it is listed more than once.
3.3 - {CurrentDateTime
}
Displays the current date/time in the format configured into the wiki on the admin page.
3.4 - {CurrentDay
}
Displays the current day of the week (Monday, Tuesday, etc.)
3.5 - {CurrentYear
}
Displays the current year (4 digits)
3.6 - {NewestPagesList : 7
}
(Without spaces between). Displays the most recently created pages. The parameter specifies the number of days (default=7). This means it will only display the pages created in the last 7 days.
3.7 - {PageArchiveIndex : CategoryName
}
(Without spaces between). Displays an index of all pages (filtered by category; default = "*"). The category "Index" is always skipped. This index is organized by Creation Date.
3.8 - {PageVersion
}
Displays a version number based on the last modification date (number of days since 1/1/2000).
3.9 - { PageModifyDate
}
Displays the date this page was last modified.
3.10 - {RandomLine : PageName
}¶
(Without spaces between). selects a random paragraph of text from the page indicated in the parameter and display it. Useful for a random quotes page or putting random quotes in the header. Will ignore blank lines in the target page.
3.11 - {Reference : Text of the reference here
}
(Without spaces between). Creates a reference link. Basically a linked number is display in the main text and then the reference text is displayed at the bottom of the page. If you want the reference to create a link to another page (such as a link to an Amazon page for the referenced book), code it like this:
:
{Reference : link | reference text
}3.12 - {ReferenceIndex
}
Creates an index of all of the references created using the ===
{Reference
}=== tag above.
3.13 - {TrackBack
}
Displays a link to all of the other pages in your wiki that directly reference this one.