Wikka Formatting Guide

NOTE
This feature is available since:
WikkaWiki 1.1.6.0


Note: Anything between 2 sets of double-quotes is not formatted.
 

Once you have read through this, test your formatting skills in the SandBox.

1. Text Formatting


**I'm bold**
I'm bold

//I'm italic text!//
I'm italic text!

And I'm __underlined__!
And I'm underlined!

##monospace text##
monospace text

''highlight text'' (using 2 single-quotes)
highlight text

++Strike through text++
Strike through text

Press #%ANY KEY#%
Press ANY KEY

@@Center text@@
Center text


2. Headers


Use between five = (for the biggest header) and two = (for the smallest header) on both sides of a text to render it as a header.

====== Really big header ======

Really big header



===== Rather big header =====

Rather big header



==== Medium header ====

Medium header



=== Not-so-big header ===

Not-so-big header



== Smallish header ==
Smallish header


3. Horizontal separator

----

4. Forced line break

---



5. Lists and indents


You can indent text using a ~, a tab or 4 spaces (which will auto-convert into a tab).

~This text is indented
~~This text is double-indented
    This text is also indented

This text is indented
This text is double-indented
This text is also indented

To create bulleted/ordered lists, use the following markup (you can always use 4 spaces instead of a ~):

Bulleted lists
~- Line one
~- Line two


Numbered lists
~1) Line one
~1) Line two

  1. Line one
  1. Line two

Ordered lists using uppercase characters
~A) Line one
~A) Line two

  1. Line one
  1. Line two

Ordered lists using lowercase characters
~a) Line one
~a) Line two

  1. Line one
  1. Line two

Ordered lists using roman numerals
~I) Line one
~I) Line two

  1. Line one
  1. Line two

Ordered lists using lowercase roman numerals
~i) Line one
~i) Line two

  1. Line one
  1. Line two

6. Inline comments


To format some text as an inline comment, use an indent ( ~, a tab or 4 spaces) followed by a &.

Example:

~& Comment
~~& Subcomment
~~~& Subsubcomment


7. Images


To place images on a Wiki page, you can use the image action.

Example:

{{image class="center" alt="DVD logo" title="An Image Link" url="images/dvdvideo.gif" link="RecentChanges"}}
dvd logo

Links can be external, or internal Wiki links. You don't need to enter a link at all, and in that case just an image will be inserted. You can use the optional classes left and right to float images left and right. You don't need to use all those attributes, only url is required while alt is recommended for accessibility.


To create a link to a wiki page you can use any of the following options:

  1. type a WikiName:

    FormattingRules
    FormattingRules

  1. add a forced link surrounding the page name by [[ | and ]] (everything after the first space will be shown as description):

    [[SandBox | Test your formatting skills]]
    Test your formatting skills

    [[SandBox | 沙箱]]
    沙箱

  1. add an image with a link (see instructions above).

To link to external pages, you can do any of the following:

  1. type a URL inside the page:

    http://www.example.com
    http://www.example.com

  1. add a forced link surrounding the URL by [[ | and ]] (everything after the first space will be shown as description):

    [[http://example.com/jenna/ | Jenna's Home Page]]
    Jenna's Home Page

    [[[email protected] | Write me!]]
    Write me!

  1. add an image with a link (see instructions above);
  1. add an interwiki link (browse the list of available interwiki tags):

    WikiPedia:WikkaWiki
    WikiPedia:WikkaWiki

    Google:CSS
    Google:CSS

    Thesaurus:Happy
    Thesaurus:Happy


9. Tables


To create a table, you can use the table action.

Example:

{{table columns="3" cellpadding="1" cells="BIG;GREEN;FROGS;yes;yes;no;no;no;###"}}

BIG GREEN FROGS
yes yes no
no no


Note that ### must be used to indicate an empty cell.
Complex tables can also be created by embedding HTML code in a wiki page (see instructions below).

10. Colored Text


Colored text can be created using the color action:

Example:

{{color c="blue" text="This is a test."}}
This is a test.

You can also use hex values:

Example:

{{color hex="#DD0000" text="This is another test."}}
This is another test.

Alternatively, you can specify a foreground and background color using the fg and bg parameters (they accept both named and hex values):

Examples:

{{color fg="#FF0000" bg="#000000" text="This is colored text on colored background"}}
This is colored text on colored background

{{color fg="lightgreen" bg="black" text="This is colored text on colored background"}}
This is colored text on colored background


11. Floats


To create a left floated box, use two < characters before and after the block.

Example:

<<Some text in a left-floated box hanging around<< Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.

Some text in a left-floated box hanging around
Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.

 
To create a right floated box, use two > characters before and after the block.

Example:

>>Some text in a right-floated box hanging around>> Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.

Some text in a right-floated box hanging around
Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler. Some more text as a filler.

 
Use ::c:: to clear floated blocks.

12. Code formatters


You can easily embed code blocks in a wiki page using a simple markup. Anything within a code block is displayed literally.
To create a generic code block you can use the following markup:

%% This is a code block %%. 

 This is a code block


To create a code block with syntax highlighting, you need to specify a code formatter (see below for a list of available code formatters).

%%(php)
<?php
echo "Hello, World!";
?>
%%

<?php
echo "Hello, World!";
?>


You can also specify an optional starting line number.

%%(php;15)
<?php
echo "Hello, World!";
?>
%%

  1. <?php
  2. echo "Hello, World!";
  3. ?>


If you specify a filename, this will be used for downloading the code.

%%(php;15;test.php)
<?php
echo "Hello, World!";
?>
%%

test.php (line 15)
  1. <?php
  2. echo "Hello, World!";
  3. ?>


List of available code formatters:
LANGUAGE FORMATTER LANGUAGE FORMATTER LANGUAGE FORMATTER
Actionscript actionscript ADA ada Apache Log apache
AppleScript applescript ASM asm ASP asp
AutoIT autoit Bash bash BlitzBasic blitzbasic
BNF bnf C c C for Macs c_mac
c# csharp C++ cpp C++ (QT extensions) cpp-qt
CAD DCL caddcl CadLisp cadlisp CFDG cfdg
ColdFusion cfm CSS css D d
Delphi delphi Diff-Output diff DIV div
DOS dos Eiffel eiffel Fortran fortran
FreeBasic freebasic GML gml Groovy groovy
HTML html4strict INI ini IO io
Inno Script inno Java 5 java5 Java java
Javascript javascript LaTeX latex Lisp lisp
Lua lua Matlab matlab Microchip Assembler mpasm
Microsoft Registry reg mIRC mirc MySQL mysql
NSIS nsis Objective C objc OpenOffice BASIC oobas
Objective Caml ocaml Objective Caml (brief) ocaml-brief Oracle 8 oracle8
Pascal pascal Perl perl PHP php
PHP (brief) php-brief PL/SQL plsql Python phyton
Q(uick)BASIC qbasic robots.txt robots Ruby ruby
SAS sas Scheme scheme sdlBasic sdlbasic
SmallTalk smalltalk Smarty smarty SQL sql
TCL/iTCL tcl T-SQL tsql Text text
thinBasic thinbasic Unoidl idl VB.NET vbnet
VHDL vhdl Visual BASIC vb Visual Fox Pro visualfoxpro
WinBatch winbatch XML xml ZiLOG Z80 z80


13. Mindmaps


Wikka has native support for mindmaps. There are two options for embedding a mindmap in a wiki page.

Option 1: Upload a FreeMind file to a webserver, and then place a link to it on a wikka page:
http://yourdomain.com/freemind/freemind.mm
No special formatting is necessary.

Option 2: Paste the FreeMind data directly into a wikka page:

14. Embedded HTML


You can easily paste HTML in a wiki page by wrapping it into two sets of doublequotes.

""[html code]""

Examples:

""y = x<sup>n+1</sup>""
y = xn+1

""<acronym title="Cascade Style Sheet">CSS</acronym>""
CSS

By default, some HTML tags are removed by the SafeHTML parser to protect against potentially dangerous code. The list of tags that are stripped can be found on the Wikka:SafeHTML page.

It is possible to allow all HTML tags to be used, see Wikka:UsingHTML for more information.

CategoryWiki

CategoryEN - CategoryReview
Comments
Comment by anonymous
2008-02-22 04:56:22
How can I create something like the green 'note' at the top of this page ?
Comment by DarTar
2008-02-22 06:02:44
The green box is produced via an action called {{since}} and installed on this documentation server for internal use only. You may want to take a look at these user-contributed extensions for something similar:

http://wikkawiki.org/SidenoteActions
http://wikkawiki.org/SidenoteActionsTormodHaugen
Comment by anonymous
2008-02-22 07:20:17
ok, TY
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki