[[embed]]
<iframe src="//interwiki.scpwikicn.com/styleFrame.html?priority=2
&type=sidebar
&override={$override}&theme=https://cdn.scpwiki.com/theme/en/basalt/normalize-min.css
&css={$css}" style="display: none"></iframe>
[[/embed]]

[[embed]]
<iframe src="//interwiki.scpwikicn.com/styleFrame.html?priority=2
&type=sidebar
&override={$override}&theme=https://oxygennine.github.io/Peroxide/CSS/Interwiki/Interwiki.css
&css={$css}" style="display: none"></iframe>
[[/embed]]

[[iftags +原创 +版式]]

欢迎使用过氧化物Peroxide基础版式，这是一个不基于任何前置版式的美学版式，其前身为一氧化物版式，由OxygenNine开发。

在任何页面上，通过在页面顶端插入以下代码以启用此版式：

预设

推荐的引用顺序是：先引用过氧化物本体（可以调整参数），再引用布局方案，最后引用配色预设。配色预设会覆盖前面的设置。

布局方案

配色方案

自定义

可以通过引用参数对过氧化物进行简单的自定义。请复制下面的引用模板。

在使用模板时不要删除参数——如果你只希望改动其中一两个参数，那就把剩下的完整保留。

排版元素

引用块和div元素

特性

布局

#page-content被设置成类似流明冲击的纵轨道，可以使用下列class的div制作整个页面宽度范围的布局：

这使得插入全宽元素更方便，但亦导致过氧化物无法正确显示裸文本布局（例如，使用换行而非空行可能会让Wikidot错误解析为裸文本而非块级元素<p>），CSS float也会失效。为取得最大兼容性，可将所有内容包裹在一个{{

* 标签1
 * 二级列表项1
 * 二级列表项2
 * ……
* 标签2
* ……

[[module 模块名 属性1="属性值" 属性2="属性值" …]]
%%变量名%%
其它内容
[[/module]]

[[html]] <p>Hello World!</p> [[html]]

[[html]]
<p>Hello World!</p>
[[html]]

[[embed]]<p>Hello World!</p>[[/embed]]

唯一可行的使用[[embed]]的方式是这样的：

[[embed]]<iframe src="https:example.com"></iframe>[[/embed]]

[[iframe]]可以直接引入<iframe>标签。它的语法是[[iframe URL attributes]]，最终被解析为<iframe src="URL" attributes></iframe>。其中，attributes支持如下属性：frameborder（0或者1），align（left，right，top，bottom，middle），height， width，scrolling（yes或者no），class，style。

[[#expr]]、[[#if]]和[[#ifexpr]]

即判断表达式。[[#expr]]用于计算数值，[[#ifexpr]]则根据计算结果判断其应该被解析的内容。这两个标签允许使用数学/逻辑语法以及3个内置函数（abs、min、max），长度最大可为256个字符。

[[#expr]]是数值计算器，语法为：[[#expr 计算式]]。例如：[[#expr abs(-20) + min(1,2,3) + (10%7)]]最终被解析为[[#expr abs(-20) + min(1,2,3) + (10%7)]]，其中%是取余数。

[[#if]]是简单的真假判断器，语法为：[[#if 值 | 为真时显示的内容 | 为假时显示的内容 ]]。显示内容支持基本的Wikidot语法，例如：[[#if 1>0 | //True// | //False// ]]最终会被解析为[[#if 1 | True | False ]]。

[[#ifexpr]]是根据计算结果判断显示内容，语法为：[[#ifexpr 比较式 | 为真时显示的内容 | 为假时显示的内容 ]]。例如，[[#ifexpr 1+1>=2 | //True// | //False// ]]最终被解析为[[#ifexpr 1+1>=2 | True | False ]]。

[[iftags]]

[[iftags]]根据页面的Tag来判断被它包裹的内容是否会显示。语法为：[[iftags +tag1 -tag2 tag3]]

其中，+或者没有前缀表示该标签必须存在，-表示该标签必须不存在。对于下面的内容：

[[iftags +tag1 -tag2 tag3]]
可能显示的内容
[[/iftags]]

如果一个页面有“tag1”和“tag3”这俩个标签，并且没有“tag2”这个标签，那么页面上就会出现“可能显示的内容”。如果以上两个条件有任何一条没被满足，这行字就不会出现。

[[date]]

[[date]]用于显示格式化的日期。语法为：[[date 时间戳 <format="格式<|agohover>">]]

其中，“时间戳”是UNIX时间，即1970年1月1日与所需日期之间的秒数。“格式”是Wikidot的占位符文本，默认为%e，即类似1970/1/1 00:00:00这样的时间格式。%Y，%m，%d分别表示年、月、日、英文月份，例如[[date 0 format="%Y年%m月%d日"]]会被显示为1970年01月01日。完整的占位符列表如下所示（基本上与PHP strftime相同）：

如果属性里有agohover，例如[[date 1145141919 format="%Y年的那事|agohover"]]，把鼠标悬浮在上面就会出现一个提示框，显示从2006年的那事之后过去了多少天。

[[include]]

[[include]]用于导入其它的页面。语法为：[[include 页面名称 |属性1=属性内容 |属性2=属性内容…]]。

例如，导入插图方块的方式为[[include component:image-block |name=(URL) |caption=描述]]。在此格式中，name与caption即为引用参数，而|用于分隔属性。不同属性允许换行，但一个引用参数内部的换行无法被识别。最终，Wikidot会将component:image-block这个页面里的所有内容插入到相应页面中。

有些版式给出的引用方式类似于{{@@[[include :scp-wiki-cn:theme:mox]]@@}}，并特别强调了“在任何维基页面上”，这是因为{{:scp-wiki-cn}}是SCP中文维基的二级域名，它强调了要加载{{@@https://scp-wiki-cn.wikidot.com@@}}上的页面。如果不特别强调这个二级域名，在其它Wikidot网站上引用的就是对应网站下的{{/theme:mox}}页面，但这个页面很有可能并不存在。所以，我推荐你养成在{{@@[[include]]@@}}里加上二级域名的习惯。

引用参数是以这样的形式被设置的：在被引用的页面里，任何类似{$parameter_name}的文本都对应着名为parameter_name的引用参数。当你在引用时添加|parameter_name=content，这个页面里的{$parameter_name}就会被替换为content。Wikidot语法会被完整地保留并正常解析。例如，假设有一个名为include-test的页面，其内容如下：

{$year}年，//{$month}月{$day}日//

使用如下方式引用：

 [[include include-test |year=二零七七 |month=1 |day=**1**]]

最终呈现的结果是：

引用参数不能以]]结尾，也最好不要包含|这样的关键字。所以，如果你的引用参数里面有链接或者换行，最好在每一行后面加上@@@@来避免它被错误地解析。

在上面的代码块中，[[include…前有一个空格。这是因为[[code]]内的[[include]]也会被解析。这是Wikidot的刻意设计。

模块

ListPages（列出页面）

ListPages模块是一种通用且广泛使用的工具，用于选择并显示站点内的页面。该模块一般语法为：

[[module ListPages 属性…]]
模块主体
[[/module]]

如果你完全不添加属性和模块主体，ListPages模块将按从最新到最旧的顺序显示当前类别中的所有可见页面，这也是很多“炸代码”情况的原因。需要特别注意的是，模块主体不能包含[[code]]或[[HTML]]。如果包含这些标签，模块将完全无法工作。

属性

选择页面

1. pagetype可接受的值
• normal（默认）指名称中不含下划线的页面。在Wikidot上，以下划线开头的页面是所谓”隐藏页面“，例如_template（全站默认模板页），其内容会被自动复制进每个_default分类的页面。大部分网站会锁定_template防止恶意破坏。
• hidden表示以下划线开头的页面。
• *表示所有页面，无论是否有下划线。
2. category可接受的值
• .（默认）表示当前的页面分类。
• *表示所有页面分类。
• 还可以是一个页面分类的列表，使用逗号或空格分隔，逻辑类似[[iftags]]。例如，-deleted -fragment表示过滤掉所有-deleted和fragment分类的页面，_default wanderers则表示仅接受来自_default和wanderers分类的页面。
3. tags可接受的值
• 默认没有属性。
• -表示无标签页面，无论可见与否。
• =表示与本页面具有任意一个相同可见标签的页面。
• ==表示与本页面具有完全相同可见标签的页面。
• 可以填入一个和category属性类似的列表，逻辑也类似：如果属性内容是tag1 tag2 tag3，那么有这三个标签中的任意一个的页面就会被选中。如果你希望选择的页面必须包括tag1，就使用+tag1。
4. parent可接受的值
• 默认没有属性。
• -表示没有父页面的页面。
• =表示当前页面的同级页面（与当前页面有同样的父页面）。
• -=表示与当前页面的父级不同。
• .表示当前页面的子页面，即，将当前页面作为属性传入。
• 否则，指定一个单独的fullname。
5. link_to可接受的值
• 输入现有页面的单个全名，以选择链接到该页面的页面（只识别使用{{@@[[[pagename]]]@@}}语法的页面）。{{.}}表示链接到当前页面的页面。
6. created_at可接受的值
• =表示与当前页面创建于同一天。
• yyyy.mm表示指定的年份和月份。
• 可选择以>、<、=、<=、>=、<>作为前缀（默认值为=）。日期并非本地时间，而是协调世界时（格林威治标准时间）。
• 也可以是last N hours/day/week/month，其中N是一个数字（默认为1），例如last 2 day表示选择过去两天里创建的所有页面。
7. updated_at可接受的值
• 与created_at一致。
8. created_by可接受的值
• =表示由当前页面的作者创建。
• -=表示非当前页面作者创建。
• 也可以指定一个用户名。
9. rating可接受的值
• n表示评分等于n的页面。
• 可选择以>、<、=、<=、>=、<>作为前缀（默认值为=）。
• =表示与当前页面评级相同的页面。
• 当列出多个分类的页面时，如果某些分类在站点管理器中的评级类型设置为“+”或“+/-”，而其他分类设置为五星制，则按评级选择和排序可能无法正常工作。解决方法是列出并排序具有相同评级模式的分类下的页面。
10. votes可接受的值
• 与rating一致。
11. offset可接受的值
• before表示排序后直至当前页（不包括当前页）的页面。
• after表示当前页面之后的页面（排序后的顺序）。
• others是指当前页面以外的页面。
12. name可接受的值
• 输入现有页面的单个名称（指不含类别部分的名称），以选择给定类别的此特定页面。如果还选择了不同类别，也可选择不同类别的页面。你可以使用当前页面的数据表单字段。
• =表示与当前页面名称完全相同的页面（仅在选择其他类别时才有意义）。
• s%或s*表示以给定字符“s”开头的所有页面。
13. fullname可接受的值
• 输入现有页面的单个页面完整名称，以精确选择此单个页面（你可以使用当前页面的数据表单字段）。
14. _<data-form-field-name>可接受的值
• 语法为 _data-form-field-name="数据表单值"。

示例：[[module ListPages category="_default wanderers" rating=">15"]]会筛选出所有评分在15分以上的、_default或wanderers分类的页面。

排序页面

筛选完页面后，你可能会希望按照某种顺序呈现它们。order属性是唯一一个负责排序的属性，它的语法如下：order="属性名 <desc>"。默认按某个属性升序排列，如果加上desc，就表示降序排列。还可以反复使用desc，例如desc desc仍然表示升序。

可用的属性有以下几种：

• name：按页面名称排序。
• fullname：按类别和页面名称排序。
• title：按页面标题排序。
• created_by：按页面发布者的用户名排序。
• created_at：按创建日期排序（默认的排序方式）。
• size：按页面字符数排序。
• rating：按评分排序（如果不同分类的评分方式不同，可能无法正常工作）。
• votes：按投票数排序。
• revisions：按修订次数排序。
• comments：按评论数量排序。
• random：随机排序，60秒刷新一次。
• _data-form-field-name：按数据表单中的某个字段排序。

分页显示

1. limit可接受的值：最小为1的一个整数，是抓取页面数量的上限，默认无限制。
2. perPage可接受的值：最小为1的一个整数，每页分页显示的项目数量。ListPages单次最多显示250项，默认显示20项。
3. reverse可接受的值：yes，例如reverse="yes"表示在给定页面上按从后到前的顺序显示维基页面。

如果一页不能显示完全，ListPages会创建一个分页目录，其HTML结构类似于：

<div class="pager">
    <span class="pager-no">page 1 of 2</span>
    <span class="current">1</span>
    <span class="target"><a href="/new-main/date/2025.07/p/2">2</a></span>
    <span class="target"><a href="/new-main/date/2025.07/p/2">next »</a></span>
</div>

模块主体

ListPages的模块主体会不断重复，重复次数就是抓取到的页面的数量。我们以这样一个模块主体作为示例：

[[module ListPages separate="no" wrapper="no" limit="5"]]
  [[head]]
    [[ul id="u-myList"]]
  [[/head]]

  [[body]]
    [[li class="list-item"]]%%title_linked%% by (%%created_by%%)[[/li]]
  [[/body]]

  [[foot]]
    [[/ul]]
  [[/foot]]
[[/module]]

注意到[[ul]]的id是u-（代表user）开头的，这是因为如果你不使用u-开头的ID，Wikidot会在编译后自动给你加上u-。如果使用u-开头的ID，Wikidot则不再追究。这是为了防止和Wikidot网页的其它元素冲突。

其中，

• separate这个属性表示是否要给每个[[body]]里的内容都单独套一个<div class="list-pages-item">。如果是no，那么无事发生；如果是yes，那么每抓取到一个页面，就会生成一个并列的<div class="list-pages-item">。
• 注意：当separate设置为true时，每个页面将单独编译（从维基源文件转换为HTML）。而当它为false时，维基编译器只会对所有选定页面的组合源文件调用一次。因此，一些特定于页面的变量和结构（如[[iftags]]）可能会产生不同的结果。当[[iftags]]的separate属性设置为yes时，它将识别各个页面的标签；而当separate属性设置为no时，它将读取包含ListPages模块的主页标签。
• wrapper表示是否要将整个模组放入一个<div class="list-pages-box">。默认值为yes。
• [[head]]…[[/head]]仅在最开始生成一次，它也可以写进属性，格式是prependLine="…"，且仅在separate为yes（true）时才有效。
• [[foot]]…[[/foot]]仅在最末尾生成一次，同样的，可以以appendLine="…"的形式写进属性。仅在separate为yes时才有效。

同样地，[[image :first …]]也只在separate为yes时才有效，它代表显示附加到当前页面的第一张图片（如果没有图片则不显示）。

所以，上面的ListPages模块会被编译为这样：

你可能会注意到%%title_linked%%和%%created_by%%，这两个是ListPages占位符，或者说变量名（variable-name）。在Wikidot编译时，变量名会被自动替换成对应页面的信息，这也是ListPages的主要功能。全部的可用变量名如下所示：

• 所有的{{%%…_at%%}}（例如{{%%created_at%%}}）都可以使用和{{@@[[date]]@@}}相同的日期占位符，格式为{{%%…_at|<modifier>%%}}。例如，{{%%created_at|%Y.%m.%d%%}}就会以{{%Y.%m.%d}}的格式输出。
• {{%%tags_linked%%}}可以指定链接到的页面，并不一定是默认的标签总览页（{{system:page-tags}}）。例如，{{%%tags_linked|interesting-list/category/%%}}就会连接到{{/interesting-list/category/<Tag名称>}}，甚至可以连到其它Wikidot站点：{{@@%%tags_linked|http://myothersite.wikidot.com/see-also/tag/%%@@}}。此外，{{%%tags_linked|%%}}会直接连到名为{{<Tag名称>}}的页面，但由于Tag支持中文而页面名称必须是英文字符，所以不推荐这种写法。

数据表单是Wikidot另外一个复杂的冷门但强大的功能，受篇幅所限，此处暂且不谈。可在wikidot-data-form-tech中学习如何创建并使用数据表单。

URL传参

你可以通过将属性指定为属性="@URL|默认值"作为属性值，然后在用于调用页面的URL后附加“/名称/值”，来在URL中传递任何属性。

如果URL不包含该属性的值，则使用默认值。其值中没有@URL的属性无法通过URL设置。默认值是可选的：如果仅使用属性@URL且未在URL上提供值，则该属性的行为就如同未设置一样。

使用URL属性主要有两种方式：（一）在另一页面上显式创建指向某个页面的链接；（二）在ListPages自身内部生成链接，这样它就能以不同的配置重新显示自身。下面是一个简单的示例：

[[module ListPages category="@URL|design"]]
%%name%% in category %%category%%
[[/module]]

这样，如果你访问有这个ListPages的页面时，在URL后添加{{/category/art}}（例如，页面本来是{{@@https://example.wikidot.com/test@@}}，现在使用{{@@https://example.wikidot.com/test/category/art@@}}访问），那么这个ListPages就会表现为：

[[module ListPages category="art"]]
%%name%% in category %%category%%
[[/module]]

如果正常访问的话，它则表现为：

[[module ListPages category="design"]]
%%name%% in category %%category%%
[[/module]]

可以以类似的方式指定多个属性：{{@@http://example.wikidot.com/blog/created_at/2008.07/order/rating desc/limit/3@@}}。要传递带有(+/-)的标签，“+”需要用“%2b”进行编码。

注意：由于部分属性可以在请求的URL中传递，因此当页面中存在多个ListPages模块时，可能会发生冲突。最有可能出现的一种冲突是，当两个模块都需要分页时，点击其中一个模块的“下一页”也会影响到另一个模块。

为防止此类冲突，请使用{{urlAttrPrefix}}属性。这可以要求在URL中的属性名称前加上一段文本。例如，如果一个ListPages有属性{{urlAttrPrefix="listpages1"}}，URL传参时就必须以{{@@…@@/listpages1_created_at/2008.07}}的方式传参，而{{@@…@@/created_at/2008.07}}就是无效的。如果能为每个ListPages实例设置不同的前缀，就可以避免任何冲突。

已废弃的功能

你可能会在某些场景发现这些变量，它们已经不再受Wikidot支持，但仍然能够工作。在此给出对应列表。

ListPages支持一种“默认格式”，在这种格式下，你无需指定任何模块主体，也无需使用[[/module]]。此功能已弃用，应避免使用。

ListDrafts（列出草稿）

语法：[[module ListDrafts pageType="<exists|notexists>"]]

列出网站上所有的草稿页面。exists表示已经存在的页面，但有未保存的草稿；noexists表示还不存在的页面。

CountPages（页面计数）

此模块和ListPages有相同的、负责筛选页面的属性，但唯一可用的变量名是%%total%%或者%%count%%（作用相同），也就是说它只负责统计页面数量。适用于一些轻量级场景。不能嵌套在ListPages内。

ListUsers（当前用户名）

一个完成度很低的模块，Wikidot声称此模块还在开发中。此模块唯一的使用方式是：

[[module ListUsers users="."]]
模块主体
[[/module]]

ListUsers要求一个唯一且必须的属性，属性的值也是唯一且必须的，即users="."。它负责抓取已经登录的用户名。和ListPages一样，模块主体不能包含

或[[html]]。

ListUsers有三个可用变量：{{%%number%%}}是用户的数字ID，{{%%name%%}}是小写无空格的用户名称，{{%%title%%}}则是正常的用户名。如果用户没有登录，该模块以及里面的内容不会被显示。

++ TagCloud（标签云）

此模块为带标签的页面创建可定制的标签云。尽管Wikidot声称可以实现3D标签云，但实测后发现这个功能已经报废了。

以下是属性列表：

[[collapsible show="展开" hide="关闭"]]

||~ 属性 ||~ 是否必填 ||~ 允许值 ||~ 默认值 ||~ 描述 ||
|| mode || 否 || 3d || none || 开启 3D 模式 ||
|| maxFontSize || 否 || 任何长度值（单位为 px、pt、em 或 %） || 300% || 最常见标签的字体大小 ||
|| minFontSize || 否 || 任何长度值（单位为 px、pt、em 或 %） || 100% || 最不常见标签的字体大小 ||
|| maxColor || 否 || 颜色定义（RRR、GGG、BBB，各自范围为 0-255） || 128,128,192 || 最常见标签的颜色 ||
|| minColor || 否 || 颜色定义（RRR、GGG、BBB，各自范围为 0-255） || 64,64,128 || 最不常见标签的颜色 ||
|| limit || 否 || 任何大于 0 的整数 || 50 || 应显示的标签数量 ||
|| target || 否 || 有效的页面名称 || system:page-tags || 链接应指向的目标页面名称 ||
|| category || 否 || 有效的类别名称 || none || 将标签（以及点击标签时显示的页面）限制在指定的页面类别中 ||
|| showHidden || 否 || true /yes || false || 显示隐藏标签，即以下划线（_）开头的标签 ||
|| urlAttrPrefix || 否 || 任何字符串 || none || 在每个标签生成的 URL 属性中添加给定字符串作为前缀；使该模块与 ListPages 和 PagesCalendar 模块更兼容 ||
|| skipCategoryFromUrl || 否 || true /yes || false || 默认情况下，若使用 category 属性，它也会作为属性添加到标签生成的 URL 中；若启用此选项，类别名称将被忽略 ||
|| width || 否 || 整数 || 300 || 设置 3D 标签云的宽度 ||
|| height || 否 || 整数 || 300 || 设置 3D 标签云的高度 ||

[[/collapsible]]

++ PageCalendar（页面日历）

PageCalendar模块会创建一个页面日历，该日历会显示每年和每月创建的页面数量。可以与ListPages配合使用。Wikidot声称此模块还在开发中。

||~ 属性 ||~ 是否必填 ||~ 允许值 ||~ 默认值 ||~ 描述 ||
|| category || 否 || 以逗号或空格分隔的类别名称，或用 "*" 表示整个 wiki，或 @URL || 当前类别 || 设置待处理页面的范围 ||
|| tags || 否 || 带有 + 和 - 修饰符的以逗号或空格分隔的标签名称，或 @URL || none || 列出用作页面选择标准的标签，标签前的 "+" 表示必填，"-" 表示 "不包含该标签"，无修饰符的标签表示 "包含任意这些标签的页面"；"@URL" 表示从 URL 中获取标签 ||
|| startPage 或 targetPage || 否 || 任何有效的 wiki 页面 || 当前页面 || 设置点击任意日期时将显示的页面 ||
|| urlAttrPrefix || 否 || 任何字母数字 || none || 用于通过 URL 传递给例如 ListPages 模块的属性前缀 ||

如果要将PageCalendar与ListPages一起使用，请确保两个模块中的{{urlAttrPrefix}}属性值相同。

此模块接受{{@URL}}值的属性（即允许URL传参），也允许使用与ListPages模块类似的默认值。

简单的示例：

[[code]]
[[module PageCalendar category="doc"]]
[[module ListPages category="doc" perPage="7" date="@URL" separate="false" prependLine="||~ Page||~ Date created||~ Created by ||"]]
|| %%linked_title%% || %%date%% || %%author%% ||
[[/module]]

PageTree（页面树）

以无序列表的形式列出某个父页面下的所有子页面。

Backlinks（反向链接）、WantedPages（待建页面列表）以及OrphanedPages（孤立页面列表）

没有属性，直接以[[module 模块名]]的形式使用。

使用{{@@[[module Backlinks]]@@}}显示一个通过{{@@[[[pagename]]]@@}}语法链接到此页面的列表。列表会被包裹在{{div.backlinks-module-box}}中。

Wikidot官方提示了此模块的用处：创建”软分类“（soft categories），即在页面中插入类似[[[category:need-update]]]这样的链接，然后在category:need-update这个页面使用此模块，就可以列出这个”假分类“下的所有页面。不过，用隐藏tag也能实现这一点，而且还可以被ListPages抓取到。

WantedPages模块列出所有不存在但有链接指向它们的页面，它也可以在每个页面底部的站点工具中被找到。OrphanedPages列出所有的没有父页面的页面。

Categories（各命名空间下的页面一览）

Categories模块是一种工具，用于显示网站内的分类及其页面。Wikidot声称此工具最终将被ListPages取代。

仅有的一个可选属性includeHidden默认值为false，可选择是否显示在列表中包含“隐藏”（以下划线开头）的页面。

Watchers（关注者）

此模块用于列出正在关注该页面的用户。仅有的一个可选属性noActions默认值为true，可选择是否显示”关注/取消关注此页面“的按钮。

Members（成员列表）

此模块用于列出站点成员。

例如，[[module Members group="admins"]]列出网站上所有的管理员。

Join（加入网站）

Join模块提供了一个操作按钮，当用户点击该按钮时，Join模块首先会确保用户拥有账户（并要求匿名用户创建账户），然后尝试让该用户成为网站成员。接受button="按钮文本"和class="CSS类"两个属性。编译后，它会被包裹在.join-box里。

当你在你自己的网站或已经加入的网站上创建Join模块时，保存页面后你不会看到“加入”按钮。该按钮不显示是因为你已经是网站的成员，并且该模块不会为已成为网站成员的用户显示此按钮。

有两种方法可以查看非成员访问你的网站时按钮的显示效果：

• 你可以编辑包含[[module Join]]的页面，然后预览该页面。
• 你可以退出网站。页面刷新后，你将看到该按钮。然后你可以再次登录继续在网站上工作（届时你将看不到该按钮）。

SendInvitations（发送邀请）和WhoInvited（谁邀请的）

没有属性，直接以[[module 模块名]]的形式使用。

SendInvitations允许你发送一个电子邮件邀请，前提是网站启用了允许邀请。

WhoInvited查询特定成员是如何加入此网站的，并显示一系列邀请记录。

CSS（嵌入层叠样式表）

CSS模块允许您将CSS（层叠样式表）代码插入到维基页面中。语法：

[[module CSS]]
/* 在此插入CSS代码 */
[[/module]]

接受两个属性：如果使用[[module CSS show="true"]]，CSS代码会以代码块的形式显示出来。disable="true"可以使CSS无效化。CSS模块会以<style>的形式被编译进页面的<head>里。模块内容不能为空，否则它将不会被编译为<style>标签。

NewPage（新建页面）

可以有以下属性：

任何用作模板（通过template属性传递）的页面都必须属于模板类别，即其名称应包含template:前缀，例如template:pagename。并且该页面必须已存在。

如果你选择多个模板（名称之间用逗号分隔），将显示一个额外的字段，要求为用户想要创建的页面选择一个模板。

如果你希望新页面符合给定的模式，可以使用format属性，配合正则表达式使用。例如：

• 页面名称将恰好由5个数字组成：format="/^[0 - 9]{5}$/"
• 一个简单的表达式，用于匹配有效的日期（并非100%准确，假设所有月份都有31天）：format="/^[\d]{4}[- \/.](0[1 - 9]|1[012])[- \/.](0[1 - 9]|[12][0 - 9]|3[01])$/"

此模块可以创建隐藏页面（即名称以下划线“_”开头的页面）。有趣的是，2010年9月之前，此模块无法创建下划线开头的页面。Wikidot声称在反馈网站上，有人希望改变这种规则，并在其官方文档内提供了通往那个反馈页面的链接，呼吁人们去点赞。那是2010年的深秋时分，几位用户和Wikidot管理员在讨论区你来我往了十几条评论。现在，这个功能可以被正常使用了。

Clone（克隆）

复制当前站点或指定站点的部分或全部内容。执行克隆操作的用户将成为新站点的所有者（主管理员）。

有两个可选属性：source指定要克隆的站点二级域名，如果不指定或填入.则克隆当前站点。button属性设置克隆按钮上的文本。

Redirect（重定向）

重定向模块会向浏览器抛出一个301状态码，告诉网络浏览器请求另一个网页。

唯一且必填的属性destination是需要重定向的URL或者pagename。可以在页面URL的末尾输入noredirect/true阻止重定向。类似地，norender/true阻止整个页面的编辑，如果你因为某些原因把页面搞炸了可以通过这种方式打开编辑框。

ThemePreviewer（主题预览器）

该模块会显示网站上的可用主题列表（一个下拉栏），并允许在不进入站点设置的情况下预览主题。

允许一个可选属性noUi="true"，效果是不显示下拉栏，直接加载URL中指定的CSS。theme_url属性设置要加载的CSS，例如[[module ThemePreviewer noUi="true" theme_url="http://d3g0gp89917ko0.cloudfront.net/v--3e3a6f7dbcc9/common--theme/base/css/style.css"]]会加载Wikidot默认的、没有任何版式的样式。

MailForm（邮件表单）

此模块可用于通过网络表单收集用户输入，并通过电子邮件接收已填写的表单。电子邮件可发送给任何已注册的Wikidot用户。简单来说，这是一个Wikidot提供的调查问卷模块。

to的名称不能包含空格：若要指定包含空格的用户名，需将每个空格替换为连字符或下划线。如果未指定“收件人”属性，电子邮件将发送给所有站点管理员。

模块主体（[[module …]] … [[/module]]）必须使用列表的语法，类似于：

# 字段 1 名称
 * 选项 1 名称：值1
 * 选项 1 名称：值2
  * 子选项 1 名称：值
# 字段 2 名称
 * …

允许的字段名称列表如下：

|| rules |||||||| 验证规则，见下文 ||||||||

如果你的字段是select字段，你还必须为其提供选项。操作方法类似：

# 字段名称
 * title: 性别
 * type: select
 * default: male
 * options:
  * male: 男
  * female: 女
  * option_name: Displayed value

本模块提供了一种强大的方式来验证输入数据。要使用验证，请执行以下操作：

# 字段名称
 * title: Validated field
 * type: text
 * rules:
  * rule1_name: value
  * rule2_name: value

PetitionAdmin（请愿）

PetitionAdmin模块允许你设置和管理在线网络请愿活动。似乎只有管理员可以发起请愿，普通成员只能参与请愿。

此功能似乎已经报废：在签署请愿后，会有一封确认邮件，但点击验证链接并不会让请愿签署人数增加。得，本来就没啥用的功能这下更没用了。

SiteGrid（站点网格）和FeaturedSite（特色站点）

SiteGrid模块能够在Wikidot上创建一个网站缩略图网格，当鼠标指针悬停在缩略图上时，会以弹出窗口的形式显示描述和一些详细信息。模块会随机对缩略图进行排序。它用于Wikidot主页上列出特色网站。

在该模块中，你必须提供一个网站名称列表，例如community（如果网址是community.wikidot.com），或者提供完整网址，例如community.wikidot.com或www.digistan.org（如果网站有自定义域名）。只有一个可选属性limit，限制从预定义列表中显示的缩略图数量。

例如：

[[module SiteGrid limit="20"]]
scp-wiki
scp-wiki-cn
scp-jp
backrooms-wiki-cn
[[/module]]

FeaturedSite与SiteGrid非常相似，但它仅显示一个维基站点缩略图，而且该缩略图要大得多。

Feed（RSS提要）

此模块负责导入RSS提要，由于这种技术已经过时，故不在此翻译，有感兴趣的可以去看原文：https://www.wikidot.com/doc-modules:feed-module。

FrontForum（讨论区信息）

[[module FrontForum]]允许你爬取网站的论坛帖子，可以跨站使用。同时还支持RSS订阅（尽管在现代互联网已经没什么人会用这玩意了）。

category的值可以在讨论区的URL中被找到，例如SCP中分的“一般讨论区”连接是https://scp-wiki-cn.wikidot.com/forum/c-882982/，那么对于此分类，category就是882982；类似地，“基金会世界观”是882983，“单页讨论”是675245。这也是为什么此模块是少数能跨站使用的模块，因为Wikidot在技术上似乎并不在意每个讨论区分别属于哪个网站。

该模块支持一系列与ListPages类似的变量。

Comments（评论区）

在页面中插入评论区。如果访问者有足够的权限，评论区默认打开。可以通过设置 hideForm="true"属性来更改此设置。

RecentPosts（最近的帖子）等

• RecentPosts（最近的帖子）：显示最近的帖子。没有属性和模组主体。
• MiniRecentThreads（最近讨论串略表）：显示最新的讨论串。列表项包含主题标题、开始日期和帖子数量。唯一的可选属性是limit，限制显示数量。
• MiniActiveThreads（活跃的讨论串略表）：以紧凑形式显示过去 7 天内最活跃的讨论串。会显示讨论串标题、起始日期和帖子总数。唯一的可选属性是limit。
• MiniRecentPosts（最近的帖子略表）：以紧凑形式显示最新的帖子，唯一的可选属性是limit。有趣的是，Wikidot官方文档中，这个模块的介绍和MiniRecentThreads完全一致，可能是复制完了忘改了。

Rate（评分模块）

即[[module Rate]]。

一个冷知识是Rate是可以有模块主体的，甚至还有变量，调用方式为[[module Rate]]…[[/module]]。但只有五星制评分的页面可以这么做，其变量包括：

但Up/Down评分制的页面无法使用变量和模组主体。

以下是Rate评分框的HTML结构：

<div class="page-rate-widget-box">
    <span class="rate-points">
     评分:&nbsp;
     <span class="number prw54353">0
     </span>
    </span>
    <span class="rateup btn btn-default">
     <a title="我喜欢" href="javascript:;" onclick="WIKIDOT.modules.PageRateWidgetModule.listeners.rate(event, 1)">
     +
     </a>
    </span>
    <span class="ratedown btn btn-default">
     <a title="我不喜欢" href="javascript:;" onclick="WIKIDOT.modules.PageRateWidgetModule.listeners.rate(event, -1)">
     –
     </a>
    </span>
    <span class="cancel btn btn-default">
     <a title="取消我的投票" href="javascript:;" onclick="WIKIDOT.modules.PageRateWidgetModule.listeners.cancelVote(event)">
     x
     </a>
    </span>
</div>

RatedPages（评分页面列表）

此模块显示评分最高的页面。也可以指定一个类别来限制结果。Wikidot声称此模块还在开发中但应该能正常运行，未提及其功能实际上被ListPages完全替代。

Gallery（画廊）

准确来说这不是一个模块，因为它的语法不以[[module …]]开头。[[gallery]]被用于插入一系列图片，语法如下：

[[gallery size="image-size"]]
: image-source1 attribute1="value1" attribute2="value2" …
: image-source2 attribute1="value1" attribute2="value2" …
…
[[/gallery]]

order属性还接受以下已弃用的值：nameDesc、dateAddedDesc 和 dateAdded。为了与 ListPages 模块保持一致，它还接受以下值：name desc desc 和 created_at desc desc（含义与不带 desc desc 时相同）。

如果在调用[[gallery]]标签时未提供图片列表，它将自动显示当前页面附加的图片文件的缩放图像（缩略图）（默认情况下，图库仅显示图片，不包括 .pdf 和 .ps 文档）。

如果在调用[[gallery]]时提供了图片列表，则仅显示这些图片。在这种情况下，图片源不能是 URL。允许的 “每张图片属性” 有：

• link：URL或维基页面名称（为符合Flickr条款，此属性对Flickr图片无效）
• alt：图片不可用时的替代文本

要使文档在新窗口中打开，适用与单个图片相同的规则。

默认情况下，图库使用 LightBox 查看图片。这意味着，如果你点击图库中的图片，将弹出一个非常美观2Footnote 2.官方文档原文为very nice looking。的弹窗，你可以在不重新加载页面/打开新标签页或窗口的情况下向前/向后滚动图片。要禁用 LightBox 查看，请使用以下参数：[[gallery viewer="no"]]或[[gallery viewer="false"]]。

FlickrGallery（Flickr画廊）

与Flickr有关。此功能似乎已经由于Flickr的API变更而报废。

Files（附件）

此模块列出了附加到页面的所有文件。没有属性和模组主体，只需[[module Files]]即可使用。

Search（搜索）等

• Search（搜索）
• SearchAll（全Wikidot搜索）
• SearchUsers（搜索用户）

上述三个模块全部报废🎉。

SiteChanges（页面变更）

列出对站点内容所做的最新更改。支持的更改类型：

• 新建页面
• 页面内容更改（编辑源代码或标题）
• 页面重命名或移动
• 元数据更改（父页面）
• 附加文件

无属性，无模组主体。使用[[module SiteChanges]]即可。

不受支持的模块

• AdSenseUnit（广告块）：与Google AdSense相关，在2010年被弃用。
• MembershipApply（申请站点成员）：被[[module Join]]替代。
• MembershipByPassword（通过密码申请站点成员）：被[[module Join]]替代。
• Pages（页面）：被[[module ListPages]]替代。
• ChildPages（子页面）：被[[module ListPages]]替代。
• PagesByTag（按标签筛选页面）：被[[module ListPages]]替代。这个模块可以一次显示所有的页面，而不是像ListPages一样有250的单页显示上限。它在绝大部分Wikidot站点上仍然可以正常运行，但由于Wikidot疑似定向优化的bug，2025年所有的以scp开头的Wikidot网站都无法使用此模块。
• NextPage（下一页面）：被[[module ListPages]]替代。
• PreviousPage（上一页面）：被[[module ListPages]]替代。
• ManageSite（管理网站）：网站的控制面板页面（/_admin）包含此模块。在任何页面上使用[[module ManageSite]]都会将该页面重定向到/_admin。非管理员进入控制面板会收到权限错误提示。

被隐藏的模块

这些模块虽然存在，但官方文档中没有它们。大部分都用于Wikidot的某些特定功能。

一个冷知识是：www.wikidot.com是一个和其它Wikidot网站（本质上）没有任何不同的Wikidot站点，如同SCP中文分部的二级域名是scp-wiki-cn一样，这个网站的二级域名就叫www。首页上创建账号的功能，以及用户信息页面都是靠模块实现的，例如：

• CreateAccount：用于创建Wikidot账号。它以及下面的模块都无法在其它任何页面上被使用。
• FrontSpecialMini：用于展示Wikidot首页上的统计数据。
• Dashboard：仅用于{{https://www.wikidot.com/account/activity}}，无法在其它任何页面上被使用。

此外，还有几个模块是被隐藏的：

• SignPetition和PetitionList：用于请愿功能，可以被独立正常调用。SignPetition接受一个id参数，用于确定要加入哪个请愿；PetitionList则接受id和limit两个参数，用于查看某个请愿有哪些人参与。但反正这个功能报废了，谁会在意呢？
• SiteManage：从名字上看似乎和ManageSite相同，但使用后会提示“你所使用的模块不存在，但你可以先玩俄罗斯方块哦 :)”3Footnote 3.原文：The module you have used does not exist, but you can play Tetris instead :) 并显示一个可玩的俄罗斯方块小游戏。然而其它模块不存在的报错则是“[[module XXX]]没有此模块，请查阅可用模块并修复该页面。”所以只能解释为这是Wikidot的刻意设计了。
• {{UserInfo}}：用于用户信息页面。若直接使用会报错”未指定用户“，需要在有这个模块的页面的URL后加上{{/用户名}}，例如{{@@https://www.wikidot.com/user:info/oxygennine@@}}（没错，这个也是模块实现的。#page-content里可能有的任何东西基本都是模块。）在其它地方可以被正常使用，例如{{https://scp-wiki.wikidot.com/system:user/}}。
• SimpleToDo：用于创建一个待办事项列表，必须要有一个id参数。
• What is hot使用的专用模块：MostActiveSites、RecentWRevisions、MostActiveForums、SiteGrid2和NewWUsers。
• New Site的专有模块：NewSite。
• 用于页面布局的专有模块：NaviBar、FooterBar、LoginStatus、PageOptionsBottom、AdModuleAboveContent、AdModuleBelowContent、AdModuleAboveSidebar、AdModuleBelowSidebar、AdModuleBelowFooter、Ad，只有Pro账户可以使用。

嵌套使用

你可能会注意到，[[include]]的引用参数{$parameter}可以保留完整的Wikidot语法。实际上，它几乎可以保留任何东西。这是一个极具灵活性的设计，我们来看一些示例：

CSS版式“预设选项”

假设有一个页面test-1，内容如下：

[[module CSS]]

/* {$option}/

.myclass {
    color: red;
}

/{$option} */

[[/module]]

在引用此页面时，如果你以[[include test-1 |option=*]]的格式引用，那么{$option}就会被替换为*，页面内容也会变成：

[[module CSS]]

/* */

.myclass {
    color: red;
}

/* */

[[/module]]

在引用之前，CSS模块里是一段很长的注释，而引用之后注释就“闭合”了，从而让中间的CSS代码变得有效。模块里的引用参数也可以工作。

有些CSS版式的引用参数需要设置为a，这是因为它们将引用参数放在了[[iftags]]的“a”那里；还有一些是—，利用了Wikidot的注释语法[!-- --]。

引用参数也可以被用于[[iframe]]的URL中，从而通过URL向<iframe>传参。当然，它也可以用于各种模块的属性中，或者HTML内的脚本值。你可以自己尝试一些奇特的引用方式。

ListPages的嵌套

有些模块也可以互相嵌套。例如，ListPages与CSS嵌套：

[[module ListPages limit="5" separate="no"]]

[[%%content{0}%%module CSS]]

.page-%%index%%::before {
    content:' %%name%% ';
}

[[%%content{0}%%/module]]

[[span class="page-%%index%%"]]%%rating%%[[/span]]

[[/module]]

由于Wikidot的某些bug，你必须使用[[%%content{0}%%module CSS]]才能保证CSS模块正常运行。这创建了5个类，分别是.page-1至.page-5，并且每个类的::before伪元素内容都是它们的页面名称。

[[#ifexpr]]等表达式虽然可以嵌入ListPages，例如[[#expr (%%rating_votes%%+%%rating%%)/2/%%rating_votes%%*10000%10001/100]]可以计算页面的Upvote率，但却无法被嵌入CSS模块。不过，你可以使用CSS的counter功能来实现一些简单的累计计算。有关这方面的高级运用，建议阅读Sharia Vanilla撰写的这篇和这篇教程。

此外，ListUsers可以被通过类似的方式嵌入ListPages中。

虽然ListPages里不能使用[[html]]，但可以使用[[iframe]]和[[embed]]并正常将变量嵌入。也可以试着将其他模块互相嵌套。