关于此页面的任何问题请联系PrimsparK

本网站的任何页面都存在者两种形式：源代码（source code）和编译码（compiled code）。源代码是你用来编辑以及描述页面内容。当你浏览页面时，源代码会被编译为XHTML码以传送给浏览器使用。Wiki语法用来是编辑源代码，以创建页面内容。

如果你想寻找已写好的程式码片段（code snippet）以复制／贴上／修改，请参见程式码片段网站。

文字格式

部分内置类

快捷使用说明

基础格式：##e 效果名|内容##，效果名即为内置类名称，不同效果名间可插入空格分隔，亦可直接相连。
示例：

• ##e blur hovershow|内容##
• ##e dblock folder|内容##

注意事项：

• 开头的"e"不能省略，位置亦不可改变
• 快捷使用仅在行内生效，不可跨行使用
• 快捷使用不可嵌套

字体大小

段落及换行

段落之间以两个“换行”来间隔。一个“换行”就如其名，只会换一行。

这是第一段。内容是什么并不重要，只是凑成一段文字而已。

这是第二段。同样地，别在意内容到底写了什么，只是凑成另一段文字而已。
这只是换一行。
这是再换一行。

这是第一段。内容是什么并不重要，只是凑成一段文字而已。

这是第二段。同样地，别在意内容到底写了什么，只是凑成另一段文字而已。
这只是换一行。
这是再换一行。

标点符号

如果你很在意标点符号的效果，这里有些方法来改善：

纯文字

如果你希望某段文字以纯文字方式显示，跳过语法的效果，就把该段文字用两个「@」号夹住。

这段 //文字// 受到 语法效果。

@@这段 //文字// 不受 语法效果。@@

这段 文字 受到 语法效果。

这段 //文字// 不受 语法效果。

注解

「注解」是一个源代码区块，在编译时会被跳过。建立方式是在源代码中加上[!-- ... --]，例如：

[!--
这段文字不会被编译。
--]

标题

要建立标题，在该行的最前面加上「加号（+）」。加号的数量会决定标题字的层级。

第一级标题
++ 第二级标题
+++ 第三级标题
++++ 第四级标题
+++++ 第五级标题
++++++ 第六级标题

内容目录（Table of Contents）

「内容目录」指的是所有「标题」的清单和连结。在希望加入的地方放置一个「内容目录」的标签即可。

[[toc]]
[[f>toc]] - 靠右的内容目录
[[f<toc]] - 靠左的内容目录

水平分隔线

用四个以上的「减号」(----) 可建立水平分隔线。

清单（Lists）

不编号清单

在段落的开头加上一个「星号」，就会产生清单的符号。在「星号」前加上空格，可以让清单项目向右缩排。

第一项

第二项

第二之一项

第一项

第二项

第二之一项

编号清单

方法与不编号清单类似。在段落开头使用「#」号可以建立编码清单。

第一项
第二项
第二之一项

第一项
第二项
第二之一项
不编码清单和编码清单可以混合使用。

名词定义清单

你可以用以下方式来建立名词定义清单。

: 名词一 : 意思指的是这个。
: 名词二 : 意思指的是那个。

名词一

意思指的是这个。

名词二

意思指的是那个。

引用区块（Block Quotes）

你可以在行首使用一个或多个「>」符号，来建立「引用区块」。「>」符号后面要加一格空格。

这是一般的文字。

这就是引用区块的文字。
另外，注意到我们可以在行尾使用反斜线「\」，
这样就可以把很多行连接成同一段。

这是另一段，接下来......

这是第二层的缩排。
会比第一层的引用区块往右缩得更多。

回到一般的文字。

这是一般的文字。

这就是引用区块的文字。
另外，注意到我们可以在行尾使用反斜线「\」，
这样就可以把很多行连接成同一段。

这是另一段，接下来……

这是第二层的缩排。
会比第一层的引用区块往右缩得更多。

回到一般的文字。

链接

内部链接

不像某些其他的wiki引擎以CamelCase格式的文字作为页面链接（指的是取消文字间的空格，但每个单字字首采用大写的连写格式），wikidot的内部链接一律采用三个中括号包夹。
如果页面的网址包含有不允的字符，该字符会被「unix化」成可允的字符。然而显示出来的名称仍然会维持原来的样子。

URLs

锚点

要放置锚点的话，使用[[# 锚点名称]]语法。要放置锚点的链接，使用[#锚点名称 链接显示的文字]。

电子邮件

虽然我们不鼓励任何人在网络上公开自己的email网址，但是WikiDot还是提供了一个简单的加密机制以防止机器人读取电子邮件。
每封信都会被加密，然后在客户的浏览器上解码。此法虽非100%安全，但比普通文字信件安全得多。

跨Wiki的链接

要链接到一篇「维基百科」的文章，可以使用以下语法：

其他链接定义方式的范例：

[google:free+wiki] - 在google搜寻「free wiki」一词

[dictionary:wiki] - 在dictionary.reference.com网站搜寻「wiki」这个字的定义

图片

单张图片

在页面中插入单张图片，采用以下语法：

[[image 图片来源地址 属性1="设定值1" 属性2="设定值2" ...]]

属性有以下几种：

size 属性在本地文件（附在页面的文件，在Wikidot服务器内）非常好用。而且不只可用在图片上，PDF或Postscript也可以用。更多细节参见this page。

图片来源地址 可以是下列的任何一种：

如果想在新窗口中开启图片所自动产生的链接，你可以在link属性前加上星号（例如 link="http://www.example.com"），或是在src元素前加上星号（例如flickr:149666562_debab08866、*image-file等等 ）。

以下为选择水平排列的方法：

[[=image… - 图片置中

[[<image… - 图片置左

[[>image… - 图片置右

[[f<image… - 图片漂浮于左（被文字围绕）

[[f>image… - 图片漂浮于右（被文字围绕）

多张图库

要插入一系列的多张图片内容，使用[[gallery]] 元素：

[[gallery size="图片大小"]]

[[gallery size="图片大小"]]
: 图片来源1 属性1="设定值1" 属性2="设定值2" ...
: 图片来源2 属性1="设定值1" 属性2="设定值2" ...
...
[[/gallery]]

[[gallery]] 标签中唯一允的属性是 size ，其设定值也只能设定为 "square", "thumbnail", "small", "medium"。

如果 [[gallery]] 标签没有一一指定图片，会自动显示附加在该页面的所有可显示图示的缩图（包括.pdf和.ps）。

如果 [[gallery]] 标签有一一指定图片，只有这些图片会被显示。这里的图片来源 不可以是URL网址。个别图片只有以下属性被允：

link - URL网址或wiki页面名称（不适用于Flickr图片）

alt - 当图片不存在时的替代显示文字。

想在新窗口开启文件的方式，与单张图片的规则相同。

如果你想要由Flickr载入图片，请参阅FlickrGallery module 。

程式码区块

用[[code]]…[[/code]] 标签（头尾标签各占一行）来建立程式码区域。

这是一个程式码区域的范例！

想在程式码区块中，利用PHP标签来套用PHP的程式码自动配色，需先加上[[code type="php"]]…[[/code]] 这样的标签。

然后在程式码区块中想要套用PHP颜色的范围，以 <?php.. ?>标签包围起来。

WikiDot.com使用PEAR::Text_Highlighter（高亮化文字识别），并支援多种颜色主题设定。以下为支援的种类（可以作为type的设定值）：

php, html, cpp, css, diff, dtd, java, javascript, perl, python, ruby, xml.

[[code type="php"]]

<?php /* comment */ for($i=0; $i<100; $i++){ echo "number".$i."\n"; } ?>
[[/code]]

<?php /* comment */ for($i=0; $i<100; $i++){ echo "number".$i."\n"; } ?>

表格

简单表格

你可以用成对的直线（||，就是反斜线\按键的上面）来建立简单表格：

||~ 标题 1 ||~ 标题 2 ||~ 标题 3 ||
|| 方格 1 || 方格 2 || 方格 3 ||
|||| 合并的方格 4 || 方格 5 ||
||方格 6 |||| 合并的方格 7 ||
|||||| 合并的方格 8||

|| lines must start and end || with double vertical bars || nothing ||
|| cells are separated by || double vertical bars || nothing ||
|||| you can span multiple columns by || starting each cell ||
|| with extra cell |||| separators ||
|||||| but perhaps an example is _
the easiest way to see ||

在表格的单一格内可以在行尾使用「底线（_）」来强制换行（参见以上范例）

进阶的表格（自订的表格）

使用特殊的标签可以允class和style 属性来管理表格的外观显示，以建立进阶的表格：

[[table]]
[[row]]
[[cell style="border: 1px solid silver; background-color: yellow;"]]
call 0.0
[[/cell]]
[[cell style="border: 1px solid silver"]]
call 0.1
[[/cell]]
[[/row]]
[[row style="border: 1px solid silver"]]
[[cell]]
call 1.0
[[/cell]]
[[cell style="border: 1px solid silver; background-color: yellow;"]]
call 1.1
[[/cell]]
[[/row]]
[[/table]]

每个 [[table]]、[[row]]和[[cell]]元素都可以接受style及class属性，然后它们会转换成(X)HTML标签: <table>、<tr>和<td>。

有个利用表格来制作页面排版的范例，请参阅我们的「程式码片段Wiki（Snippets Wiki）」：http://snippets.wikidot.com/code:layout-with-tables。

表格可以是多层次的（蜂巢状）。

区域格式元素

靠左、靠右、置中、两端对齐

文字区块的对齐方式采用以下程式码：

范例：

[[=]]
这一串文字是用来示范对齐模式，
所以内容是什么并不重要。
重要的是让你看出来这个对齐模式的效果，
就像这样。

你可以自己试试其他的效果。
[[/=]]

要使单行文字置中，可直接在行首加上等号（=）：

= 此行置中。

自订的 div 区块

要改进您可以使用的布局[[div]] ... [[/div]]转换为html的元素@div> ... </div@方块。
允的属性仅限于：class和style，但这应该足以创建所需的布局。
[[div]]方块可以嵌套。

下面是如何使用div块创建2列布局的示例：

[[div style="float:left; width: 45%; padding: 0 2%"]]
左列左列左列左列左列
左列左列左列左列左列
[[/div]]
[[div style="float:left; width: 45%; padding: 0 2%"]]
右栏右栏右栏右栏右栏
右栏右栏右栏右栏右栏
[[/div]]

~~~~元素用于清除浮点数并将或多或少地转换为<div style ="clear:both"> </div>）。

自定义[[div]]块可用于创建非常高级的页面布局。

数学

WikiDot.com使用LaTeX渲染漂亮的方程式。 对于那些知道使用wikidot方程的LaTeX语法的人应该是非常明显的。

方程式

简单地说一下这个等式[[math label]] … [[/math]] block tags (the label is optional). 等式在LaTex中呈现 \begin{equation} ... \end{equation} 环境。 有关语法的详细信息，请参阅任何LaTeX参考手册。

[[math label1]]
\rho _{\rm GJ} = -\sigma (r) \left[ (1 - \eta _{\ast }^2 {\kappa \over {\eta ^3}}) \cos \chi \right.
+ \left. {3\over 2} \theta (\eta) H(\eta)
\xi \sin \chi \cos \phi \right]
[[/math]]

To refer to a labeled equation simply use [[eref label]] to get a raw number or e.g. Eq. ([[eref label1]]) which gives Eq. (1).

要打破长方程，请使用type="eqnarray" attribute, e.g.

[[math label2 type="eqnarray"]]
\lefteqn{ \cos x = 1        
-\frac{x^{2}}{2!} +{} } \\
& & {}+\frac{x^{4}}{4!}
-\frac{x^{6}}{6!}+{}\cdots
[[/math]]

文字之间的数学符号

要在文本（句子）里面使用数学表达式 [[$ ... $]]标签。

[[$ E = mc^2 $]] is much more popular than
[[$ G_{\mu\nu} - \Lambda g_{\mu\nu} = \kappa T_{\mu\nu} $]]

在文章中加入注脚可使用 [[footnote]] 区块。注脚的内容会自动显示在页面文章最末。如果不希望显示在页面最末，在希望显示的地方插入 [[footnoteblock]]。

张先生[[footnote]]也就是卫生股长小张的父亲。[[/footnote]]常常自己一个人拎着锅子，
到隔好几条街、比较远的那家豆浆店 [[footnote]]据说是班长小青的妈妈开的。[[/footnote]]去买豆浆。

[[footnoteblock]]

张伯伯¹常常自己一个人拎着锅子，到隔好几条街、比较远的那家豆浆店²去买豆浆。

如果你对预设的标题「Footnotes」不满意，也可以自订标题：用[[footnoteblock title="Custom title"]] 或干脆不要标题 (title="")。

参考资料

「参考资料」区块以 [[bibliography]]...[[/bibliography]] 来定义。每笔参考资料都采下列格式表示：
标签名称 : 完整说明
在文章中要放置一个引用参考资料的链接记号，使用 ((bibcite 标签名称)).

人类发现的第一颗脉冲星是由J. Bell和A. Hewish [((bibcite bell))]所观测到的。另一个引用参考的范例[见 ((bibcite guy))]。

[[bibliography]]
: bell : Bell, J.; Hewish, A.; Pilkington, J. D. H.; Scott, P. F.; and Collins, R. A. //Observation of a Rapidly Pulsating Radio Source.// Nature 217, 709, 1968.
: guy : Guy, R. K. //Modular Difference Sets and Error Correcting Codes.// §C10 in Unsolved Problems in Number Theory, 2nd ed. New York: Springer-Verlag, pp. 118-121, 1994.
[[/bibliography]]

人类发现的第一颗脉冲星是由J. Bell和A. Hewish [1]所观测到的。另一个引用参考的范例[见 2]。

如果你对预设的标题「Bibliography」不满意，也可以自订标题：用[[bibliography title="Custom title"]] 或干脆不要标题 (title="")。

加入其他页面的内容（Include other pages）

如果你想要加入其他页面的内容，使用：

[[include 页面名称]]

include 标签必须自己占用一行。

[[include]] 标签也可以对来源页面使用参数和变数。在来源页面的变数表示方式如下：

{变数1}, {number_books}, {title}, {variable_name}, {$variableName}

在加入的页面使用：

[[include 页面名称 变数1=设定值1 | number_books = 43 | title=史上最好的Wiki
| variable_name = 就是一个变数
| variableName = 另一个变数
]]

如你所见，你可以把变数定义分成好几行，这样程式码看起来比较清楚。

注：includes和图片／文件：[[include]]就只是单纯地把页面内容插入指定的位置。如果你在来源页面内有附加图片或文件，而在来源页面以[[image filename.jpg]]来载入图片的话，在加入的页面里请记得加上该来源页面的名称。例如[[image 来源页面名称/filename.jpg]]

嵌入多媒体文件

视讯

要把视讯直接嵌入页面，使用 [[embedvideo]] ... [[/embedvideo]] 区块。
在「嵌入HTML程式码」的中间，可以放入以下的线上视讯资源：

Google Video

YouTube

例如：

[[embedvideo]]
<embed style="width:400px; height:326px;" id="VideoPlayback" align="middle" type="application/x-shockwave-flash" src="http://video.google.com/googleplayer.swf?docId=263244138622602613" allowScriptAccess="sameDomain" quality="best" bgcolor="#ffffff" scale="noScale" salign="TL" FlashVars="playerMode=embedded"> </embed>
[[/embedvideo]]

声音

要嵌入声音，使用 [[embedaudio]] ... [[/embedaudio]] 以及音讯来源网站所提供的html嵌入码。

目前支援的有：

Odeo.com

例如：

[[embedaudio]]
<embed src="http://www.odeo.com/flash/audio_player_standard_gray.swf" quality="high" width="300" height="52" name="audio_player_standard_gray" align="middle" allowScriptAccess="always" wmode="transparent" type="application/x-shockwave-flash" flashvars="audio_id=99133&audio_duration=282.0&valid_sample_rate=true&external_url=http://www.vitalpodcasts.com/FileSystem/podcasts/89/opensource_episode1.mp3" pluginspage="http://www.macromedia.com/go/getflashplayer" />
</embed>
<a style="font-size: 9px; padding-left: 110px; color: #f39; letter-spacing: -1px; text-decoration: none" href="http://odeo.com/audio/99133/view">
powered by <strong>ODEO</strong></a>
[[/embedaudio]]

嵌入其他网站的程式码

有时候有些网站（通常是社群网站）允你直接贴一段程式码到你的页面里，以增加你的网站的功能，或嵌入一些来自其原始网站的内容。

[[embed]] 标签

[[embed]] 区块标签允你做到以上的事情。例如显示由http://del.icio.us/help/tagrolls 提供的del.icio.us标签云，只需简单地加入以下html码：

[[embed]]

<script type="text/javascript" src="http://del.icio.us/feeds/js/tags/michal_frackowiak?icon;size=12-35;color=87ceeb-0000ff;title=my%20del.icio.us%20tags"></script>
[[/embed]]

有关支持的服务列表，请参阅页面： 嵌入其他服务的代码（英）.

请注意，如果代码包含<script type="text/javascript"…即只是JavaScript，当您在编辑页面时单击preview时，内容将无法完全呈现。 但是当你以后查看页面时它应该在那里。

[[iframe]] 元素

使用 iframe 元素可以嵌入任何其他网页的内容。语法为：

[[iframe url-source attributes]]

Iftags指令（关键字标签）

标签是页面的一种特殊标签，通过单击页面底部页面选项按钮上的标签链接，由编辑手动添加。 每个标记长度最多为64个字符，标记为「空格」分隔，每页标记没有限制。 标签对标签页面非常有用，然后很容易创建标签云，这样可以更快地找到有趣的页面或主题。

特殊标签以下划线开头：它们不会自动显示在标签云中，但它们可以在[[iftag]]条件中用作特殊限制。 标签可以在ListPages模块中使用，也可以使用通用条件(+,-)。

特殊标签是一个特殊的条件问题。 您可以在每个页面上使用它来对标签进行「反应」并在所使用的特定页面上进行设置。

Syntax:

[[iftags +tag1 -tag2 tag3]] ... [[/iftags]]

在标记名之前 - 此标记必须存在，（没有修饰符的标记以相同的方式工作）

在标记名之前 - 此标记不得存在。
例：

[[iftags +science]]
此页面标记为：科学。

点击此处查看更多科学文章>
[[/iftags]]

[[iftags +bug -fixed]]
This is a bug, but it's not fixed yet.
[[/iftags]]

Modules指令（功能模块）

模块是可以放在页面中的独立小部件。 一般语法是：
[[module 模块名 param1="value1" param2="value2" ...]]

要阅读有关模块的更多信息，请参阅modules文档部分。

附加文件

目标文件必须首先附加到页面 - 通过单击任何页面底部选项中的「文件」和「上载文件」。

用户

what you type	what you get	comments
[[user user-name]] e.g. [[user michal frackowiak]]	michal-frackowiak	user info (no buddy icon)
[[user user-name]] e.g. [[user michal frackowiak]]	michal-frackowiak	user info (with buddy icon)

社群工具链接按钮（Social bookmarking）

可以轻松地在页面中添加「社交书签」按钮 —写吧[[social]]（没有任何参数）并得到：

这相当于：

[[social blinkbits,blinklist,blogmarks,co.mments,connotea,del.icio.us,de.lirio.us,digg,fark,feedmelinks,furl,linkagogo,ma.gnolia,newsvine,netvouz,rawsugar,reddit,scuttle,shadows,simpy,smarking,spurl,tailrank,wists,yahoomyweb,facebook]]

您也可以只选择所选服务，例如 选择digg，furl和del.icio.us使用：

[[social digg,furl,del.icio.us,facebook]]

得到：

提醒： 使用社交书签！ 将社交快捷方式置于文章或侧栏内是一个好主意。

独立的按钮（页面选项）

不知何故，隐藏默认页面选项并仅向用户显示所选按钮可能会很方便。它的语法是：

[[button type options]]

其中type是：edit, edit-append, edit-sections, history, print, files, tags, source (查看页面源码), backlinks, talk (工作原理类似于 MediaWiki/Wikipedia).

可能的属性是：

text — 要显示的替代文本

class — CSS关于一个元素的类

style — CSS样式定义

对于一些带有图标的漂亮的「查看源」和「打印」按钮，您可以使用以下代码：

[[>]]
[[button source style="background-image: url(http://www.wikidot.com/local--files/files/view-source.png); background-repeat: no-repeat; background-position: bottom right; padding-right: 20px; color: #444"]]
[[button print style="background-image: url(http://www.wikidot.com/local--files/files/document-print.png); background-repeat: no-repeat; background-position: bottom right; padding-right: 20px;color: #444"]]
[[/>]]

得到：

排版元素

排版元素

要生成tabview，即一组选项卡，可以使用以下语法：

[[tabview]]
[[tab 表1的标题]]
表1的内容。
[[/tab]]
[[tab 表2的标题]]
表2的内容。
[[/tab]]
[[tab 表3的标题]]
表3的内容。
[[/tab]]
[[/tabview]]

这将生成以下标签集：

标签将接受任何内容，但目前无法嵌套标签视图。

tabview的另一个例子可以在Snippets Wiki上找到，网址是http://snippets.wikidot.com/code:tabs。