======Wikka格式指南======

<<**注意：** 所有位于两对双写的英文双引号间的文字将会失去格式效果。<<::c::
你可以在[[SandBox|沙盒]]里测试并练习这些格式代码。
===1. 文本格式===

~##""**我是粗体**""##
~**我是粗体**

~##""//我是斜体//""##
~//我是斜体//

~##""我是 __下划线__!""##
~我是 __下划线__!

~##""##等宽字体##""##
~##等宽字体##

~##""''加亮文字''""## (使用两个单引号)
~''加亮文字''

~##""++删除线++""##
~++删除线++

~##""点击 #%按钮#%""##
~点击 #%按钮#%

~##""@@居中文字@@""##
~@@居中文字@@

===2. 标题===

最大号的标题需要在文本前后放六个##“=”##。最小号的标题需要在文本前后放两个 ##=##。

~##""====== 最大号标题 ======""##
~====== 最大号标题 ======

~##""===== 第二大标题 =====""##
~===== 第二大标题 =====

~##""==== 中等标题 ====""##
~==== 中等标题 ====

~##""=== 不太大的标题 ===""##
~=== 不太大的标题 ===

~##""== 小标题 ==""##
~== 小标题 ==

===3. 分割线===
~##""----""##
----

===4. 强制换行符===
~##123""---""123##
123---123

===5. 列表和缩进===

文本缩进，在段落前加入**~**, **<Tab>**或者**<四个空格>** （将自动转换成Tab）。

##""~缩进文字<br />~~双倍缩进<br />（TAB）这段文字也想缩进""##

~缩进文字
~~双倍缩进
	这段文字也想缩进

创建项目符号/有序列表，应使用下面的标记（推荐使用##**~**##，四个空格有时会失灵）：

**符号**
##""~- Line one""##
##""~- Line two""##

~- Line one
~- Line two

**数字序号**
##""~1) Line one""##
##""~1) Line two""##

~1) Line one
~1) Line two

**大写字母序号**
##""~A) Line one""##
##""~A) Line two""##

~A) Line one
~A) Line two

**小写字母序号**
##""~a) Line one""##
##""~a) Line two""##

~a) Line one
~a) Line two

**小写罗马数字序号**
##""~I) Line one""##
##""~I) Line two""##

~I) Line one
~I) Line two

**大写罗马数字序号**
##""~i) Line one""##
##""~i) Line two""##

~i) Line one
~i) Line two

===6. 内嵌注释===

内嵌注释，在段落前加入**~**, **<Tab>**或者**<四个空格>**然后再加一个**＆**。

**范例：**

##""~& 评论""##
##""~~& 子评论""##
##""~~~& 子子评论""##

~& 评论
~~& 子评论
~~~& 子子评论

===7. 图片===

在条目内插入图片需要用到##image##标签。

**范例：**

~##""{{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"}}

可以使用内部或外部链接。完整填入全部属性（class，title等）并非必要。可设定##class##的值为##left##和##right##以控制图片的对齐方式。若不需要多余的属性，只须设定##url##属性为图片地址即可插入图片。（推荐设定##alt##的值以便访问）

===8. 链接===

创建一个 **内部条目的链接** 你可以使用下列几种方式： ---
~1) 输入 ##""条目名""##：--- ---**范例：** --- ##""FormattingRules""##---[[FormattingRules]]--- ---
~1) 如果需要不同于条目名的文本作为链接点，可用 ##""[[""##A|B##""]]""##（A填条目名，B填链接文本）： --- ---**范例：**--- ##""[[SandBox|Test your formatting skills]]""## --- [[SandBox|Test your formatting skills]] --- --- ##""[[SandBox|沙箱]]""## --- [[SandBox|沙箱]] --- ---
~1) 添加一个图片链接（详见第7条）。

创建一个 **到外部页面的链接**你可以使用下列几种方式：---
~1) 输入一个URL: --- ---**范例：** ---  ##""http://www.example.com""## ---[[http://www.example.com]]--- --- 
~1) 如果需要不同于URL的文本作为链接点，可用 ##""[[""##A|B##""]]""## (A填URL，B填链接文本)： --- ---**范例：**---  ##""[[http://example.com/jenna/|Jenna's Home Page]]""## --- [[http://example.com/jenna/|Jenna's Home Page]] --- --- ##""[[mail@example.com|Write me!]]""## --- [[mail@example.com|Write me!]] --- ---
~1) 添加一个图片链接（详见第7条）；
~1) 添加外部Wiki条目的链接（浏览 [[格式规则]]）：--- ---**范例：**---  ##""WikiPedia:WikkaWiki""## ---[[WikiPedia:WikkaWiki]]--- --- ##""Google:CSS""## ---[[Google:CSS]]--- --- ##""Thesaurus:Happy""## ---[[Thesaurus:Happy]]--- ---

===9. 表格===

<<1.2版的##表格##标签已被取消，新的语法如下。<<::c::
表格可以用两个（##""||""##）定义。每对定义符代表一个单元格。

**范例：**

##""||单元格1||单元格2||""##

||单元格1||单元格2||

标题单元格只须用 (##""|=|""##) 定义。

**范例：**

##""|=|标题1|=|标题2|=|""##
##""||单元格1||单元格2||""##

|=|标题1|=|标题2|=|
||单元格1||单元格2||

##x:## 和 ##y:##可以用来合并单元格，##x:## 和 ##y:##分别代表待合并的行数和列数。

**范例：**

##""|=| |=|(x:2)行||""##
##""|=|(y:2)列||单元格1||单元格2||""##
##""||单元格3||单元格4||""##

|=| |=|(x:2)行||
|=|(y:2)列||单元格1||单元格2||
||单元格3||单元格4||

表格还拥有许多额外的格式功能。更多功能请参考[[TableMarkup|表格格式]]。

===10. 彩色文本===

创建彩色文本需要使用 ##color## 标签：

**范例：**

~##""{{color c="blue" text="测试"}}""##
~{{color c="blue" text="测试"}}

还可以使用RGB颜色：

**范例：**

~##""{{color hex="#DD0000" text="测试"}}""##
~{{color hex="#DD0000" text="测试"}}

前景色和背景色使用 ##fg## 和 ##bg## 属性（可以使用RGB颜色）：

**范例：**

~##""{{color fg="#FF0000" bg="#000000" text="彩色文本+背景色"}}""##
~{{color fg="#FF0000" bg="#000000" text="彩色文本+背景色"}}

~##""{{color fg="yellow" bg="black" text="彩色文本+背景色"}}""##
~{{color fg="yellow" bg="black" text="彩色文本+背景色"}}


===11. 浮动框===

创建一个 **左浮动框**，需要输入两个 ##<## 。

**范例：**

~##""<<我是左浮动框里的填充文字，喵呜。<< 我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。""##

<<我是左浮动框里的填充文字，喵呜。<<我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。

创建一个 **右浮动框**，需要输入两个 ##>## 。

**范例：**

~##"">>我是右浮动框里的填充文字，喵呜。>> 我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。""##

>>我是右浮动框里的填充文字，喵呜。>>我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。我是填充文字，喵呜。

::c::使用##""::c::""##可以清除浮动框。

===12. 程序代码===

可以轻松地在条目内显示一段程序代码。所有在代码段内的字符都会原样显示。 
显示**未特指语言的程序代码**可用以下格式符号：

~##""%%这是一段代码。%%""##. 

%%这是一段代码。%%

显示**语法高亮的程序代码**，需要指定//语言格式符// （可用格式符见下表）。

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

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

可以指定 //起始行号//。

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

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

指定//文件名//用于下载此段代码。

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

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

**格式符列表**
{{table columns="6" cellpadding="1" cells="语言;格式符;语言;格式符;语言;格式符;ABAP;abap;Actionscript;actionscript;ADA;ada;Apache Log;apache;AppleScript; applescript;ASM;asm;ASP;asp;AutoIT;autoit;Axapta/Dynamics Ax X++;xpp;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;dot;dot;Eiffel;eiffel;Fortran;fortran;FOURJ's Genero 4GL;genero;FreeBasic;freebasic;GML;gml;Groovy;groovy;Haskell;haskell;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;Motorola 68000 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 (forms);per;Perl;perl;PHP;php;PHP (brief);php-brief;PL/SQL;plsql;Python;phyton;Q(uick)BASIC;qbasic;robots.txt;robots;Ruby;ruby;Ruby on Rails;rails;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. 思维导图===

Wikka原生支持思维导图（[[Docs:FreeMind|Mindmaps]]）。有两种方法在条目内插入思维导图。

**方法1：** 上传""思维导图""到服务器，然后把链接插入到wiki页面里。
##""http://yourdomain.com/freemind/freemind.mm""##
No special formatting is necessary.

**方法2：** 直接粘贴""思维导图""的数据到wiki页面里:
~- 用文本编辑器打开FreeMind的文件。
~- 全选，复制数据。
~- 浏览您的Wikka网站，把FreeMind数据粘贴到页面中。

===14. 嵌入HTML===

可以方便地在条目中嵌入HTML代码，方法是使用两对双写的英文双引号。

~##""[HTML代码]""##

**范例：**

~##""y = x<sup>n+1</sup>""##
~""y = x<sup>n+1</sup>""

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

在默认情况下，一些可能威胁系统稳定的HTML标签会被移除。这里可以看到被移除的标签： [[Docs:SafeHTML|SafeHTML]] 

关于可正常使用的HTML标签，请参阅文档[[Docs:UsingHTML]]。

----
CategoryWiki