Most recent edit on 2006-06-18 16:08:32 by WikkaInstaller [Upgrading from 1.1.6.1 to 1.1.6.2]

Additions:

Wikka Formatting Guide

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
- 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
A) Line one
A) Line two
Ordered lists using lowercase characters
~a) Line one
~a) Line two
a) Line one
a) Line two
Ordered lists using roman numerals
~I) Line one
~I) Line two
I) Line one
I) Line two
Ordered lists using lowercase roman numerals
~i) Line one
~i) Line two
i) Line one
i) 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

• 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"}}

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.

8. Links

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

1. type a WikiName:
   
   FormattingRules
   FormattingRules
   
   
2. 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 沙箱]]
   沙箱
   
   
3. 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
   
   
2. 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
   
   [[mail@example.com Write me!]]
   Write me!
   
   
3. add an image with a link (see instructions above);
4. 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!";
?>
%%

echo "Hello, World!";
?>
You can also specify an optional //starting line// number.
~##""

(php;{{color c="red" text="15"}})<br /><?php<br />echo "Hello, World!";<br />?><br />

""##

(php;15)
echo "Hello, World!";
?>
If you specify a filename, this will be used for downloading the code.

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

%%(php;15;test.php)
echo "Hello, World!";
?>
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
C	c	C for Macs	c_mac	c#	csharp
C++	cpp	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
Inno Script	inno	Java 5	java5	Java	java
Javascript	javascript	Lisp	lisp	Lua	lua
Matlab	matlab	Microchip Assembler	mpasm	Microsoft Registry	reg
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	Python	phyton
Q(uick)BASIC	qbasic	robots.txt	robots	Ruby	ruby
SAS	sas	Scheme	scheme	sdlBasic	sdlbasic
Smarty	smarty	SQL	sql	TCL/iTCL	tcl
T-SQL	tsql	Text	text	VB.NET	vbnet
VHDL	vhdl	Visual BASIC	vb	Visual Fox Pro	visualfoxpro
WinBatch	winbatch	XML	xml

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:

• Open a FreeMind file with a text editor.
• Select all, and copy the data.
• Browse to your Wikka site and paste the Freemind data into a 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ⁿ⁺¹""
y = xⁿ⁺¹
""<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.

Deletions:

The Wiki Formatting Guide

Anything between 2 sets of double-quotes is ignored and presented exactly as typed (that means the formatting commands below are ignored whenever surrounded by double double-quotes.)
Once you've read through this, test your formatting skills in the SandBox.

Basic formatting:

**I'm bold text!**
I'm bold text!
//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

Headers:

====== 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

Horizontal separator:

----

Forced line break:

---

Lists / Indents:

Indent text using 4 spaces (which will auto-convert into tabs) or using "~". To make bulleted / ordered lists, use the following codes (you can use 4 spaces instead of "~"):
~- bulleted list:

• bulleted list
• Line two

~1) numbered list:

1. numbered list
2. Line two

~A) Using uppercase characters:

1. Using uppercase characters
2. Line two

~a) Using lowercase characters:

1. Using lowercase characters
2. Line two

~I) using uppercase roman numerals:

1. using Latin numbers
2. Line two

~i) using lowercase roman numerals:

1. using Latin numbers
2. Line two

Wiki Extensions:

Images:

To place images on a Wiki page, use:
{{image class="center" alt="DVD logo" title="An Image Link" url="images/dvdvideo.gif" link="RecentChanges"}}

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

Tables:

To create a table use this code:
{{table columns="3" cellpadding="1" cells="BIG;GREEN;FROGS;yes;yes;no;no;no;###"}} to give:

BIG	GREEN	FROGS
yes	yes	no
no	no

### means the cell is empty.

Coloured Text:

{{colour c="blue" text="This is a test."}} gives:
This is a test.
If you want to use hex values:
{{colour hex="#DD0000" text="This is another test."}} to give:
This is another test.

Left floated box - use two < signs before and after the block

Some text in a 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.
Right floated box, use two > characters before and after the block

Some text in a 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...

Code Formatters:

%%code%%:
int main(int arc,char argv)
{

printf("Hello, %s!

", (argc>1) ? argv[1] : "World");

return 0;

}

%%(ini) INI file contents%%:

; Menu specification file for Opera 7.0
[Version]
File Version=2
[Info]  #background info
Name=Munin++ Menu
Description=Munin++ Menu
Author=NonTroppo (originally by Rijk van Geijtenbeek)
Version=1.9
    ""

(php) PHP code

:""

(php)
phpinfo();
= "Hello, World!
";
print ;?>

 Email message

: %%(email) Hi! >>>> My Llama loves foot massage. >>> You really think so? >> Yes, I know he does. >Are you sure? Of course, yes! Mr. Scruff ===Forced links:=== http://wikka.jsnx.com [[http://wikka.jsnx.com]] My Wiki Site [[http://wikka.jsnx.com My Wiki Site]] ===Inter Wiki Links:=== See the InterWiki page for a full list of available engines. Here are some examples: WikiPedia:Perception CssRef:overflow Google:CSS Thesaurus:Dilate Dictionary:Dream ===FAQ:=== //Question: How do you un-WikiName a word ?// Answer: Add two pair of double-quotes around the word: WikiName //Question: How do you get a pair of double-quotes (without any text between them) to display properly ?// Answer: Use the entity literal ##&quot;## - ##&quot&quot;## //Question: How does Wakka Wiki know to what URL to send a visitor to if it wasn't specified ?// Answer: The link is to a forced WikiPage. That means a link to a page in this wiki is generated. //Question: So why does LALA_LELE send me to http://LALA_LELE ?// Answer: The underscore breaks things. LALALELE"" doesn't have this problem.

Back Links

CTRL

---

Oldest known version of this page was edited on 2004-12-03 17:10:55 by WikkaInstaller []

The Wiki Formatting Guide

Anything between 2 sets of double-quotes is ignored and presented exactly as typed (that means the formatting commands below are ignored whenever surrounded by double double-quotes.)

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

---

Basic formatting:

Headers:

Horizontal separator:

---

Forced line break:

---

Lists / Indents:

Indent text using 4 spaces (which will auto-convert into tabs) or using "~". To make bulleted / ordered lists, use the following codes (you can use 4 spaces instead of "~"):

~- bulleted list:

• bulleted list
• Line two

~1) numbered list:

1. numbered list
2. Line two

~A) Using uppercase characters:

1. Using uppercase characters
2. Line two

~a) Using lowercase characters:

1. Using lowercase characters
2. Line two

~I) using uppercase roman numerals:

1. using Latin numbers
2. Line two

~i) using lowercase roman numerals:

1. using Latin numbers
2. Line two

---

Wiki Extensions:

Images:

To place images on a Wiki page, use:
{{image class="center" alt="DVD logo" title="An Image Link" url="images/dvdvideo.gif" link="RecentChanges"}}

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

Tables:

To create a table use this code:
{{table columns="3" cellpadding="1" cells="BIG;GREEN;FROGS;yes;yes;no;no;no;###"}} to give:

BIG	GREEN	FROGS
yes	yes	no
no	no

### means the cell is empty.

Coloured Text:

{{colour c="blue" text="This is a test."}} gives:

This is a test.

If you want to use hex values:

{{colour hex="#DD0000" text="This is another test."}} to give:

This is another test.

---

Left floated box - use two < signs before and after the block

---

Code Formatters:

%%code%%:

---

Forced links:

---

Inter Wiki Links:

---

FAQ:

Question: How do you un-WikiName a word ?
Answer: Add two pair of double-quotes around the word: WikiName

Question: How do you get a pair of double-quotes (without any text between them) to display properly ?
Answer: Use the entity literal &quot; - &quot&quot;

Question: How does Wakka Wiki know to what URL to send a visitor to if it wasn't specified ?
Answer: The link is to a forced WikiPage. That means a link to a page in this wiki is generated.

Question: So why does [[LALA_LELE]] send me to http://LALA_LELE ?
Answer: The underscore breaks things. [[LALALELE]] doesn't have this problem.

Back Links

CTRL

---

CategoryWiki