本页面是对应的Wikidot官方文档的一个简要的中文版本，翻译了绝大部分有关Wikidot模块的内容。尽管有相当多的模块十分鸡肋，Wikidot的模块系统可待发掘的地方还有很多。

译名和术语参考

• category：页面分类，或命名空间。每个页面默认的分类是_default。
• pagename：页面名称。这不是指页面的标题。每个Wikidot页面的URL格式为：https://sitename.wikidot.com/category:pagename，pagename指的是category:之后的部分。它和category都必须仅由小写英文字母、连接符和数字组成。category:pagename被称为fullname（完整页面名称）。
• sitename：二级域名。
• attributes：属性，或者参数。

什么是Wikidot模块

是类似[[module 模块名]]或[[module 模块名]] ... [[/module]]的结构，这样的模块调用Wikidot本身的API来爬取网站的内容。你最常用到的[[module Rate]]就是一个模块，其中Rate就是模块名。

“Module”一词并没有官方的中文翻译，这里暂且译为“模块”，不过其实也可以翻译成“模组”，看你比较喜欢哪个称呼了。

根据官方文档，模块分为以下几种：

• 列表和分类（Listing and categorizing），例如ListPages、Categories等列出网站内容的模块。
• 用户和成员（Users, members），例如Members、Join（加入网站）这样有关Wikidot用户的模块。
• 论坛和讨论（Forum &¹ discussion），有关论坛功能的模块。
• 新闻与订阅源（News & feeds），只包括Feed和FrontForum。
• 页面评分（Page rating），只包括Rate和RatedPages。
• 图片、画廊和附件（Photos, galleries, files），顾名思义。
• 搜索（Searching），与Wikidot搜索功能有关，基本不可用。
• 变更（Changes），仅包括SiteChanges一个模块。
• 杂项（Miscellaneous），例如ThemePreviewer、FeaturedSite等，值得注意的是，Wikidot将CSS模块也分在此类。
• 已废弃（Deprecated），包括一些不再被Wikidot支持（但不一定无法使用）的模块。

一般来说，模块的使用方式为：

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

其中，[[module 模块名 属性1="属性值" 属性2="属性值" …]]是开始标签，[[/module]]是闭合标签。并不是所有模块都需要闭合标签。也并不是所有模块可以设置属性和变量，具体见下面的模块列表。

我们下面开始逐个讲解每个模块。

在此之前你可能需要了解的高级Wikidot语法

接下来的介绍会涉及Wikidot的一些很实用的高级语法，虽然它们不属于模块，但经常配合模块使用，有必要了解。

[[html]]、[[iframe]]和[[embed]]

这三个标签都用于引入HTML代码。然而，它们的作用方式略有不同。

首先，[[html]] ... [[/html]]内可以插入任意的HTML代码，但开始和结束标签必须独占一行。即，类似这样的语法是无效的：

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

为使Wikidot解析[[html]]，你必须以如下形式使用它：

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

Wikidot会将这种HTML代码以<iframe>的形式呈现出来。也就是说，你可以自由插入JavaScript脚本，但你没办法用它更改页面上的内容；你只能用它更改[[html]]以内的东西。由于HTML被储存在wdfiles.com，根据同源策略，想让它访问父页面的内容也是不可能的。尽管如此，有一些奇特的技巧可以实现将[[html]]里的属性向外传递，例如这个。

[[html]]难以被嵌入行内。如果你希望在行内嵌入<iframe>，可以使用[[embed]]。但[[embed]]只接受<iframe>标签，如果你在其中插入任何其它的HTML元素，Wikidot将会展示一个报错信息。甚至，尽管Wikidot自己的文档中提供了在[[embed]]中插入<script>的例子，如果你亲自去尝试就会发现Wikidot仍然会报错。例如：

[[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)]]最终被解析为24，其中%是取余数。

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

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

[[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，即类似01 Jan 1970 00:00这样的时间格式。%Y，%m，%d分别表示年、月、日、英文月份，例如[[date 0 format="%Y年%m月%d日"]]会被显示为01 Jan 1970 00:00。完整的占位符列表如下所示（基本上与PHP strftime相同）：

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

[[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模块会被编译为这样：

• Relliorca从档案柜里冒了出来 by (Relliorca)
• SCP-CN-4560 by (JasonAlpha)
• SCP-CN-4178 by (Kinsfoil)
• SCP-CN-4665 by (Tokiu)
• SCP-7530 by (JackWheel)

你可能会注意到%%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另外一个复杂的冷门但强大的功能，受篇幅所限，此处暂且不谈。

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一样，模块主体不能包含[[code]]或[[html]]。

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

TagCloud（标签云）

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

以下是属性列表：

PageCalendar（页面日历）

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

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

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

简单的示例：

[[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 名称
 * ...

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

如果你的字段是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 查看图片。这意味着，如果你点击图库中的图片，将弹出一个非常美观²的弹窗，你可以在不重新加载页面/打开新标签页或窗口的情况下向前/向后滚动图片。要禁用 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相同，但使用后会提示“你所使用的模块不存在，但你可以先玩俄罗斯方块哦 :)”³并显示一个可玩的俄罗斯方块小游戏。然而其它模块不存在的报错则是“[[module XXX]]没有此模块，请查阅可用模块并修复该页面。”所以只能解释为这是Wikidot的刻意设计了。
• UserInfo：用于用户信息页面。若直接使用会报错”未指定用户“，需要在有这个模块的页面的URL后加上/用户名，例如https://www.wikidot.com/user:info/oxygennine（没错，这个也是模块实现的。#page-content里可能有的任何东西基本都是模块。）在其它地方可以被正常使用，例如https://scp-wiki.wikidot.com/system:user/。
• SimpleToDo：用于创建一个待办事项列表，必须要有一个id参数。

嵌套使用

你可能会注意到，[[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]]并正常将变量嵌入。也可以试着将其他模块互相嵌套。