======Wikka Formatting Guide======---<<===General Guidelines===If a markup sequence is not in these guidelines, then it is not officially supported. Use caution when implementing markup that is not officially supported by this document, as undocumented functionality may change with version updates.--- ---Unless otherwise stated in these guidelines, all markup is line based, that is, a newline character should not intervene. These are identified as 'inline' markup.<<::c::---===Escaping Markup===---Anything between 2 sets of double-quotes is not formatted. This is the equivalent of escaping a character(s):--- ---<< ~##""**two bold ""**"" stars**""## ~**two bold ""**"" stars** <~~This text is double-indented
This text is also indented""## <<::c::<< ~This text is indented ~~This text is double-indented ~This text is also indented <<::c::---To create bulleted/ordered lists, use the following markup (you can always use 4 spaces instead of a tilde):--- ---**Bulleted lists**---<< ##""~- Line one""## ##""~- Line two""## <<::c::<< ~- Line one ~- Line two <<::c::---**Numbered lists**---<< ##""~1) Line one""## ##""~1) Line two""## <<::c::<< ~1) Line one ~1) Line two <<::c::---**Ordered lists using uppercase characters**---<< ##""~A) Line one""## ##""~A) Line two""## <<::c::<< ~A) Line one ~A) Line two <<::c::---**Ordered lists using lowercase characters**---<< ##""~a) Line one""## ##""~a) Line two""## <<::c::<< ~a) Line one ~a) Line two <<::c::---**Ordered lists using uppercase Roman numerals**---<< ##""~I) Line one""## ##""~I) Line two""## <<::c::<< ~I) Line one ~I) Line two <<::c::---**Ordered lists using lowercase Roman numerals**---<< ##""~i) Line one""## ##""~i) Line two""## <<::c::<< ~i) Line one ~i) Line two <<::c::---===6. Inline comments===---To format some text as an inline comment, use an indent (tilde, tab, or four spaces) followed by a **""&""**.--- ---<< ##""~& Comment""## ##""~~& Subcomment""## ##""~~~& Subsubcomment""## <<::c::<< ~& Comment ~~& Subcomment ~~~& Subsubcomment <<::c::--- ---===7. Images===---To place images on a Wiki page, you can use the ##image## action.--- ---Image 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.--- ---<< ~##""{{image class="center" alt="DVD logo" title="An image link" url="images/dvdvideo.gif" link="RecentChanges"}}""## --- ~{{image class="center" alt="DVD logo" title="An image link" url="images/dvdvideo.gif" link="RecentChanges"}} <<::c::---===8. Links===---To create a ** link to a wiki page ** you can use any of the following options:--- --- ~- Type a ##""WikiName""## (works only for page names with no whitespace): --- --- ##""FormattingRules""## --- FormattingRules --- --- --- ~- Add a forced link surrounding the page name by ##""[[ target URL or page | description ]]""## (everything after the | will be shown as description): --- --- ##""[[SandBox | Test your formatting skills]]""## --- [[SandBox | Test your formatting skills]] --- --- ##""[[SandBox | 沙箱]]""## --- [[SandBox | 沙箱]] --- --- ##""[[http://docs.wikkawiki.org | Wikka documentation]]""## --- [[http://docs.wikkawiki.org | Wikka documentation]] --- --- ##""[[community@wikkawiki.org | Wikka community list]]""## --- [[community@wikkawiki.org | Wikka community list]] --- ------ ~- Add an image with a link (see instructions above) --- ---To ** link to external pages **, you can do any of the following:--- --- ~- Type a URL inside the page: --- --- ##""http://blog.wikkawiki.org""## --- http://blog.wikkawiki.org --- --- --- ~- Add an image with a link (see instructions above) --- ~- Add an interwiki link ([[InterWiki | browse the list of available interwiki tags]]): --- --- ##""WikiPedia:WikkaWiki""## --- WikiPedia:WikkaWiki --- --- ##""Google:CSS""## --- Google:CSS --- --- ##""Thesaurus:Happy""## --- Thesaurus:Happy --- --- --- ---===9. Tables===---<## 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. ::c:: ** Note: 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).--- --- ~##""%%(""{{color c="red" text="php"}}"")
<?php
echo "Hello, World!";
?>
%%""## --- %%(php) %% --- ---You can also specify an optional // starting line // number.--- ~##""%%(php;""{{color c="red" text="15"}}"")
<?php
echo "Hello, World!";
?>
%%""## --- %%(php;15) %% --- ---If you specify a // filename //, this will be used for downloading the code.--- ~##""%%(php;15;""{{color c="red" text="test.php"}}"")
<?php
echo "Hello, World!";
?>
%%""## --- %%(php;15;test.php) %% --- --- |?|List of available code formatters|| || |=|Language|=|Formatter|=|Language|=|Formatter|=|Language|=|Formatter|| |#| |=|Actionscript||##actionscript##|=|ABAP||##abap##|=|ADA||##ada##|| |=|Apache Log||##apache##|=|""AppleScript""||##applescript##|=|ASM||##asm##|| |=|ASP||##asp##|=|""AutoIT""||##autoit##|=|Bash||##bash##|| |=|""BlitzBasic""||##blitzbasic##|=|""Basic4GL""||##basic4gl##|=|bnf||##bnf##|| |=|C||##c##|=|C for Macs||##c_mac##|=|C#||##csharp##|| |=|C""++""||##cpp##|=|C""++"" (+QT)||##cpp-qt##|=|CAD DCL||##caddcl##|| |=|""CadLisp""||##cadlisp##|=|CFDG||##cfdg##|=|""ColdFusion""||##cfm##|| |=|CSS||##css##|=|D||##d##|=|Delphi||##delphi##|| |=|Diff-Output||##diff##|=|DIV||##div##|=|DOS||##dos##|| |=|Dot||##dot##|=|Eiffel||##eiffel##|=|Fortran||##fortran##|| |=|""FreeBasic""||##freebasic##|=|FOURJ's Genero 4GL||##genero##|=|GML||##gml##|| |=|Groovy||##groovy##|=|Haskell||##haskell##|=|HTML||##html4strict##|| |=|INI||##ini##|=|Inno Script||##inno##|=|Io||##io##|| |=|Java 5||##java5##|=|Java||##java##|=|Javascript||##javascript##|| |=|""LaTeX""||##latex##|=|Lisp||##lisp##|=|Lua||##lua##|| |=|Matlab||##matlab##|=|mIRC Scripting||##mirc##|=|Microchip Assembler||##mpasm##|| |=|Microsoft Registry||##reg##|=|Motorola 68k Assembler||##m68k##|=|""MySQL""||##mysql##|| |=|NSIS||##nsis##|=|Objective C||##objc##|=|""OpenOffice"" BASIC||##oobas##|| |=|Objective Caml||##ocaml##|=|Objective Caml (brief)||##ocaml-brief##|=|Oracle 8||##oracle8##|| |=|Pascal||##pascal##|=|Per (FOURJ's Genero 4GL)||##per##|=|Perl||##perl##|| |=|PHP||##php##|=|PHP (brief)||##php-brief##|=|PL/SQL||##plsql##|| |=|Python||##phyton##|=|Q(uick)BASIC||##qbasic##|=|robots.txt||##robots##|| |=|Ruby on Rails||##rails##|=|Ruby||##ruby##|=|SAS||##sas##|| |=|Scheme||##scheme##|=|sdlBasic||##sdlbasic##|=|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##|| |=|X""++""||##xpp##|=|""ZiLOG"" Z80 Assembler||##z80##|=| || --- ---===13. Mindmaps===---Wikka has native support for [[Wikka:FreeMind|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. ::c:: ---===14. Embedded HTML===---You can easily paste HTML in a wiki page by wrapping it into two sets of doublequotes.--- --- ~##""[html code]""## << ~##""y = xⁿ⁺¹""## ~""y = xⁿ⁺¹"" <<::c::<< ~##""CSS""## ~""CSS"" <<::c::---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