什么是[[include]]组件?

[[include]]是一种特殊的Wikidot语法,它的官方说明可以在这里找到。使用[[include]]语法可以引用(include)另一个页面的全部内容。这样,一些页面就可以作为模块化的组件来使用。

[[include]]的基本语法如下所示:

或者

在SCP维基中,[[include]]组件通常位于"component"分类下。也就是说,页面名称通常为"component:xxxxx"。

[[include]]语法允许跨维基网站引用页面,你只需要在页面名称前添加网站名称以及两个引号。网站名称可以是完整的地址,例如"www.scpwiki.com"或者"scp-wiki.wikidot.com"(中文站则为"scp-wiki-cn.wikidot.com")。也可以省略".wikidot.com",简写为"scp-wiki"(中文站则为"scp-wiki-cn")。

[[include]]语法可以添加一些参数,但参数的设置完全取决于被引用的页面。也就是说,不同的组件拥有不同的可用参数;而且相同名称的参数,在不同组件中的作用也可能会不尽相同。

在语法中,各项参数之间需要以分隔符("|")隔开。

常见的[[include]]语法写法有三种:

• 参数之间不换行。适合于参数少、结构简单的组件。

• 参数之间换行,首行缩进,分隔符置于行末。适合于参数多、结构复杂的组件。

• 参数之间换行,首行不缩进,分隔符置于行首。适合于参数多、结构复杂的组件。

注意:[[include]]语法必须单独一行,也就是说不能添加一些额外的语法,例如引用语法"> "、简易表格语法"|| 表格内容 || 表格内容 ||"。

提醒:现在一些CSS主题版式也能够通过[[include]]的方式引入。与[[include]]组件不同,主题版式改变的是整个页面的样式,而且通常不提供任何参数设置。

---

如何翻译?

打开页面的维基源代码,如果页面中包含语法正确的[[include]]组件,你就能看到如下内容:

其中,"页面名称"是一个可供点击的链接,指向被引用的页面。点击前往组件页面,在侧边栏的多语言栏中查找是否存在"中文"选项。如果有,你可以保留[[include]]语法不变,只修改"值X"中需要翻译的部分(不要修改"参数X"!)。这样,当发布于中文站上时,会自动引用中文站上已翻译的组件。

你可以在组件页面点击右下角的"+ 选项"(Options) > "反向链接"(Back links)来查看哪些页面使用[[include]]引入了该组件。

如果原文[[include]]包含"网站名称",例如:

将"网站名称"修改为"scp-wiki-cn"就能引用中文站上已翻译的组件。

如果组件并没有中文版本,可能该组件并不存在需要翻译的部分,也可能是该组件本身就拥有切换语言的功能:往往在这类组件中包含"lang"参数,需要将之修改为"cn"。

特别注意:SCP沙盒站和SCP维基并不是同一个Wikidot网站!一些组件可能在沙盒站上并不存在。当你在沙盒站使用不包含"网站名称"的[[include]]语法时,系统会在沙盒站上尝试寻找相应的页面,这样会出现错误。你需要在语法中额外添加"网站名称"才能正确显示。

同样的,一些组件并没有发布在SCP维基上,而是放在了各种官方、非官方的沙盒中,这时便无法利用多语言栏来识别是否存在已经本地化的组件。

---

那么…

这篇指南剩余的部分提供了很多常见[[include]]组件的索引,包括组件示例、是否存在翻译、一些使用注意事项等等,供各位译者查阅。

通用说明

很多附带插图的文章,插图地址使用的是相对路径。除非插图中包含需要重新嵌字的部分,否则请不要将原图直接上传到中文SCP维基上,而是将路径补齐,以节约中文维基的储存空间。

例如,对于英语主站的插图,将以下路径:

xxxxx.jpg

修改为:

http://www.scpwiki.com/local--files/scp-xxxx/xxxxx.jpg

http://scp-wiki.wikidot.com/local--files/scp-xxxx/xxxxx.jpg

http://scp-wiki.wdfiles.com/local--files/scp-xxxx/xxxxx.jpg

三种路径均可。

---

标准插图方块

说明:SCP维基所使用的附带说明的标准插图方块。

原地址:http://www.scpwiki.com/component:image-block

翻译地址:http://scp-wiki-cn.wikidot.com/component:image-block

使用频率:非常高 ●くろまる

备注 1:由于此组件使用广泛,绝大部分SCP网站(包括沙盒站)都有该组件。

备注 2:在日语站中,此组件有一个额外的参数"clear",用于清除移动端插图方块的浮动属性,翻译时需要删除。

---

引用的插图方块

说明:由于[[include]]语法必须单独一行,无法直接添加于引用语法"> "中。使用这个组件可以将插图方块置于引用块中。

原地址:http://www.scpwiki.com/component:image-block-quoted

翻译地址:http://scp-wiki-cn.wikidot.com/component:image-block-quoted

使用频率:高 ●くろまる

备注 1:由于此组件使用广泛,绝大部分SCP网站(包括沙盒站)都有该组件。

备注 2:在日语站中,此组件有一个额外的参数"clear",用于清除移动端插图方块的浮动属性,翻译时需要删除。

---

居于左侧的插图方块

说明:设置标准插图方块中的"align"参数可以实现同样的效果,现已很少使用。

原地址:http://www.scpwiki.com/component:image-block-left

翻译地址:http://scp-wiki-cn.wikidot.com/component:image-block-left

使用频率:非常低 ●くろまる

备注 1:由于此组件使用广泛,绝大部分SCP网站(包括沙盒站)都有该组件。

备注 2:在日语站中,此组件有一个额外的参数"clear",用于清除移动端插图方块的浮动属性,翻译时需要删除。

---

自适应插图方块

说明:自适应的插图方块,在移动设备上它可以自动将侧边插图居中,这样你就不会在屏幕边缘看到那一列难看的被压扁的文字。

原地址:http://www.scpwiki.com/component:image-block-responsive

翻译地址:http://scp-wiki-cn.wikidot.com/component:image-block-responsive

使用频率:低 ●くろまる

---

悬停放大的插图方块

说明:鼠标悬停于图片上方时可以放大图片。

原地址:http://scp-sandbox-3.wikidot.com/image-zoom

翻译地址:无

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc8

使用频率:高 ●くろまる

---

高斯模糊的插图方块

说明:鼠标悬停于图片上方时可以显示图片。

原地址:http://scp-sandbox-3.wikidot.com/image-blur

翻译地址:无

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc8

使用频率:非常低 ●くろまる

---

长按全屏的插图方块

说明:鼠标长按图片时可以全屏显示图片。

原地址:http://scp-sandbox-3.wikidot.com/component:image-zoom-2

翻译地址:无

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc8

使用频率:低 ●くろまる

---

图片轮播框

说明:轮流播放一系列图片。

原地址:http://www.scpwiki.com/component:carousel

翻译地址:http://scp-wiki-cn.wikidot.com/component:carousel

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc9

使用频率:非常低 ●くろまる

备注:原文使用的 Google APIs 资源库在大陆地区可能无法稳定访问,请使用本地化的版本。

著作信息模块

说明:附带著作信息的评分模块。

原地址:http://www.scpwiki.com/info:start

翻译地址:http://scp-wiki-cn.wikidot.com/credit:start

使用频率:非常高 ●くろまる

备注 1:在英语站和捷克语站,此组件被称为"信息模块"("Info module"),位于"info"分类下,翻译时需将其替换为"credit"。

备注 2:此模块自带评分模块,对于不需要评分模块的翻译作品而言,请使用"standalone"模式(详细说明请参见以上链接)。

备注 3:原文使用的 Google APIs 资源库在大陆地区可能无法稳定访问,请使用本地化的版本。

备注 4:在日语站、韩语站和法语站中,此模块的样式与其他语言分部不同,请注意识别。

---

Ayers的信息模块

说明:无。

原地址:http://www.scpwiki.com/component:info-ayers

翻译地址:http://scp-wiki-cn.wikidot.com/component:info-ayers

使用频率:非常高 ●くろまる

备注 1:尽管该组件提供了"lang"参数,但并没有切换语言的功能,本地化的版本移除了这一参数。

备注 2:本地化的版本参数设置与原文不完全相同,请参考以上链接中的"翻译指南"。

项目警告方块

说明:无。

原地址:http://www.scpwiki.com/component:object-warning-box-source

翻译地址:http://scp-wiki-cn.wikidot.com/component:object-warning-box-source

使用说明:http://scp-wiki-cn.wikidot.com/component:object-warning-box

使用频率:中 ●くろまる

---

警告方块

说明:无。

原地址:http://topia.wikidot.com/kaktus-header

翻译地址:无

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc4

使用频率:非常低 ●くろまる

备注:此组件的参数只能使用html语法,且需要转换为base64编码,请使用以上链接中提供的编码工具。

等级栏

说明:无。

原地址:http://www.scpwiki.com/component:classified-decoration

翻译地址:无

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc5

使用频率:高 ●くろまる

备注:此组件支持切换语言。翻译时,需要将"lang"参数设置为"CN"(必须大写),且额外添加以下参数:

---

等级栏

说明:带有"威胁等级"的项目等级栏。

原地址:http://smlt.wikidot.com/component:aers:classification-stuff

翻译地址:无

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc5

使用频率:非常低 ●くろまる

---

项目等级栏

说明:带有"负责站点"、"项目主管"等额外信息的项目等级栏。

原地址:http://www.scpwiki.com/component:object-class-bar-source

翻译地址:http://scp-wiki-cn.wikidot.com/component:object-class-bar-source

使用说明:http://scp-wiki-cn.wikidot.com/component:object-class-bar

使用频率:非常低 ●くろまる

---

等级栏 Ver.2

说明:带有"负责站点"、"项目主管"等额外信息的项目等级栏。

原地址:http://scp-wiki.wikidot.com/component:cd-ver2

翻译地址:http://scp-wiki-cn.wikidot.com/component:cd-ver2

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc5

使用频率:低 ●くろまる

备注:此组件的参数需要转换为base64编码,请使用以上链接中提供的编码工具。

---

Woed的分级栏

说明:无。

示例:http://www.scpwiki.com/component:classified-bar-woed

原地址:http://www.scpwiki.com/component:classified-bar-woed

翻译地址:无

使用说明:http://www.scpwiki.com/component:classified-bar-woed

使用频率:高 ●くろまる

备注:此组件支持切换语言。翻译时,需要将"lang"参数设置为"CN"(必须大写),且额外添加以下参数:

---

ACS异常分类栏

说明:使用了异常分类系统(ACS)的项目分级栏。

原地址:http://www.scpwiki.com/component:anomaly-class-bar-source

翻译地址:http://scp-wiki-cn.wikidot.com/component:anomaly-class-bar-source

使用说明:http://scp-wiki-cn.wikidot.com/component:anomaly-class-bar

使用频率:非常高 ●くろまる

备注:翻译时需要额外添加一个参数"lang=cn/tr"(必须小写),来设置简体中文或繁体中文。

---

Peppo的ACS异常分类栏

说明:小型化的ACS异常分类栏。

示例:http://scp-wiki-cn.wikidot.com/scp-4703

原地址:http://www.scpwiki.com/component:acs-peppo-lite

翻译地址:http://scp-wiki-cn.wikidot.com/component:acs-peppo-lite

使用频率:非常低 ●くろまる

备注:使用方法同上。

---

收容等级及扰动等级版头

说明:无。

原地址:
http://topia.wikidot.com/component:class-header-source
http://www.scpwiki.com/component:floppy-disruption-bar

翻译地址:
http://scp-wiki-cn.wikidot.com/component:class-header-source
http://scp-wiki-cn.wikidot.com/component:floppy-disruption-bar

使用频率:非常低 ●くろまる

备注:翻译时需要额外添加一个参数"lang=cn/tr"(必须小写),来设置简体中文或繁体中文。

---

SVG格式版头

说明:无。

原地址:http://topia.wikidot.com/svgheader1-inc

翻译地址:http://scpsandboxcn.wikidot.com/svgheader1

使用说明:http://scp-wiki-cn.wikidot.com/scp-style-resource#toc5

使用频率:非常低 ●くろまる

一些英语站作者喜欢在自己作品中添加"该作者的更多作品"("More by this author")列表。一般会出现在文章末尾,例如:SCP-3597;或者著作信息模块中,例如SCP-2338、SCP-4420。

这些列表同样也是利用[[include]]来添加的,被引用的页面通常位于沙盒站。列表一般会使用ListPages模块来自动生成,但是,ListPages所使用的"页面创建者"("created_by")筛选条件在中文站并不适用,无法抓取正确的页面。因此,建议在翻译时将这一部分删除。