| 第1行: | 第1行: | ||
<!-- | <!-- 本页面搬运自 Fandom 后室中文维基 Backrooms_Wiki:模板功能入门,遵循 CC-BY-SA 许可协议 --> | ||
--> | |||
**"模板功能入门"**是Fandom后室中文分部的**写作指导** | |||
[[文件:Commons-emblem-success.svg|25px|center]] | |||
* 写手们在Fandom后室中分进行创作时应当遵守或参考本指导(我们强烈建议您读完再参与创作)。关于其它需要阅览的指导,请见"[[分类:写作指导|写作指导]]"分类。 | |||
* 对指导内容有疑问的,可以在页面下方的评论区进行讨论,或者前往讨论版发帖咨询。 | |||
{{Tip|拥有对[[Help:代码教程|·代码教程·]]的一定认知会对理解接下来的内容有所帮助}} | |||
* [[#认识模板与使用方法|认识模板与使用方法]] | |||
* [[#常用模板列举|常用模板列举]] | |||
模板的本质很简单。你可以把模板当做是一个特殊的压缩包,你能把你需要的内容装在这个压缩包内,并把它放在页面中特定的位置。当你阅览它时这个压缩包就会被打开。 | |||
它通常被用来制成简单反复引用的板式、文本,亦或是制成代码糖。这里以一个最常见的Class模板做展示: | |||
{{Class 0}} | |||
<div class="mw-collapsible mw-collapsed" style="border:1px solid #aaa; margin:10px 0;"> | |||
<div style="background:#f0f0f0; padding:6px 10px; cursor:pointer; font-weight:bold;">点击我展开【压缩包】</div> | |||
<div class="mw-collapsible-content" style="padding:10px; background:#fff;"> | |||
<div style="background:linear-gradient(to right,#ffffff 0%,#DCDCDC 20%);border:6px solid #DCDCDC;border-radius:5px"> | |||
[[File:C0.png|right|200px|link=]] | |||
<p style="color:black;font-size:32px;margin:0px 5px">'''生存难度:'''</p> | |||
<p style="color:black;font-size:24px;margin:0px 5px">''Class 0''</p> | |||
<p style="color:#696969;font-size:20px;margin:15px 0 15px 30px">'''》安全'''</p> | |||
<p style="color:#696969;font-size:20px;margin:15px 0 15px 30px">'''》已勘探完全'''</p> | |||
<p style="color:#696969;font-size:20px;margin:15px 0 15px 30px">'''》无实体'''</p> | |||
</div> | |||
</div> | |||
<div style="background:#f0f0f0; padding:6px 10px; cursor:pointer; font-weight:bold;">把它塞回去吧</div> | |||
</div> | |||
你当你要更改模板中对应的内容时则需要更改对应的'''参'''数的(内容)值,可更改的在模板的源代码里被用三个大括号({{{}}})括起来,若一个参数需要定义一个默认的值会在大括号中添加一个分割符(|)并在其左侧写上它的名称,右侧写上它的值。 | |||
如果相同的参数反复出现,那么更改一个参数的值会连带更改所有相同参数。 | |||
而当你需要使用一个模板时,只要遵循如下的格式: | |||
* 直接套用:{{模板名称}} | |||
* 需要修改参数:{{模板名称|参数名称=你要的内容}} | |||
* 需要修改不止一个参数:{{模板名称|参数名称A=你要的内容|参数名称B=你要的内容|参数名称C=你要的内容}} | |||
未被定义的参数会默认显示它在模板源代码中的值,例如你想且只想改变上面例举生存难度模板中是否安全的部分,就写: | |||
{{Class 0|safety=不安全}} | |||
最后你就会得到一个除了「安全」被替换成「不安全」以外与原来一模一样的「Class 0」。 | |||
如果一个模板中有未被定义的参数,且在源代码中也未被定义,那么这个模板在引用时它会直接显示为{{{参数}}}。并且名字是数字的参数会根据小到大的整数顺序(会绕过已定义值的参数)进行补全。 | |||
以在一开始就运用到的{{Ruby}}为例: | |||
{{Ruby|在下主要内容|不止文字?}} | |||
由于实际上的{{Ruby}}模板中对应的参数形式实际是这样的: | |||
{{Ruby|{{{1}}}|{{{2}}}|3=(|4=)}} | |||
所以如果单单填上了模板名字的话会显示为【{{{1}}}({{{2}}})】。 | |||
如果你的浏览器是支持<Ruby>的话(别担心,绝大多数都会有,除了QQ内置的浏览器或是什么老旧手机的默认浏览器之类的)想要显示出上面的效果,不需要填写参数3和参数4,只要这么写: | |||
{{Ruby|在下主要内容|不止文字?}} | |||
亦或者写上参数的名字也行: | |||
{{Ruby|1=在下主要内容|2=不止文字?}} | |||
除此之外,你还可以用模板来整点活……例如让你的文在历史记录里显示的字符少几个量级(有人以此为目的做过),亦或者把大段的包含重复性代码的内容放在模板里,可以给需要反复于上下文编辑的情况下提供一些创作上的便利,**但如果实在没有必要的话就不建议这样做**,到时候如果你制作的模板导致了模板冗余、出错、不再使用还没法自己主动删除页面,得联系站务或是站务主动发现才能删除。 | |||
顺带一提,将表格插入进模板内会冲突,因此你需要使用源代码(例如常用的折叠),或是把表格做成代码。 | |||
更高层次的代码运用是迟早要摆脱一些作为代码糖的模板的。 | |||
想要找到模板的源代码,请搜索'''Template:你要找的模板名称'''。 | |||
== 常用模板列举 == | |||
以下列举了一些常用的模板及其用法。模板的使用分为'''直接套用'''与'''修改参数'''两种方式。 | |||
=== Level Class === | |||
生存难度模板... | |||
{{Class 0}} | |||
* `{{{background_color}}}`:生存难度框的背景色。默认为`linear-gradient(to right, #ffffff 0%, #DCDCDC 20%)`。 | |||
* `{{{border_color}}}`:生存难度框的边框色。默认为`#DCDCDC`。 | |||
* `{{{image}}}`:生存难度图标的文件名,不带`File:`命名空间前缀。默认为`C0.png`。 | |||
* `{{{sd_color}}}`:生存难度字样的颜色。默认为`black`(即#000000)。 | |||
* `{{{class}}}`:生存难度等级。默认为`Class 0`。 | |||
* `{{{bullet_color}}}`:三条楼层性质简述的颜色。默认为`#696969`。 | |||
* `{{{safety}}}`:楼层安全性。默认为`安全`。 | |||
* `{{{security}}}`:楼层勘探程度。默认为`已勘探完全`。 | |||
* `{{{entity}}}`:楼层实体数量。默认为`无实体`。 | |||
实际上最后三个参数可以和安全性、勘探程度和实体数量不一定关联,可以自由写。 | |||
=== Ruby === | |||
在选定内容顶部显示出注音... | |||
{{Ruby|在下主要内容|不止文字?}} | |||
* 通常只需`{{Ruby|下面的内容|上面的内容}}`即可,注意不做一些处理的话上下会被自动间距至等宽。 | |||
== | === Collapse === | ||
是大家最爱的折叠... | |||
{{Collapse|initial=点我展开|final=点我折叠|body=我是内容}} | |||
* `{{{initial}}}`:点击后会展开折叠的内容 | |||
* `{{{final}}}`:点击后会关闭折叠的内容 | |||
* `{{{body}}}`:内容本身 | |||
* `{{{num}}}`:填上不同的数字来区分折叠,否则会一并关闭或打开 | |||
折叠内容空着可以让它开了就关不上。 | |||
可能不适的整活之前记得预警,阴间过头的活预不预警都得删。 | |||
== | === Hr === | ||
水平分割线... | |||
{{Hr}} | |||
* `{{{thickness}}}`:分割线厚度,默认为2px。 | |||
* `{{{style}}}`:分割线样式,默认为`solid`。所有可用的值为: | |||
* `dotted`:点状线 | |||
* `dashed`:虚线 | |||
* `double`:双实线 | |||
* `solid`:单实线 | |||
* 其它值会被转成`solid`。 | |||
* `{{{light_color}}}`:分割线在浅色主题下的颜色,默认采取`{{{color}}}`。 | |||
* `{{{dark_color}}}`:分割线在深色主题下的颜色,默认采取`{{{color}}}`。 | |||
* `{{{color}}}`:`{{{light_color}}}`和`{{{dark_color}}}`缺省时采用的颜色。对于浅色主题默认为`#B4B082`,对于深色主题默认为`#6B6B6B`。 | |||
* `{{{width}}}`:分割线长度,默认为90%(即占据完整宽度的90%)。 | |||
* `{{{margin-top}}}`:分割线到上元素的距离。默认为12px。 | |||
* `{{{margin-bottom}}}`:分割线到下元素的距离。默认为12px。 | |||
== | === 黑幕 === | ||
遮盖内容... | |||
{{黑幕|1=需要盖上的内容|2=鼠标移动至上方显示的内容}} | |||
* | * 不填写参数2默认为无 | ||
图片也行[[文件:雨竹疑问.png|24px|link=]] | |||
== | === Background === | ||
背景图片... | |||
{{Background | |||
|file=图片名称,默认为Bg.png,不要带File: | |||
}} | |||
== | === Fandom Community Header === | ||
导航栏不再让读者眼瞎... | |||
这个不太方便上使用例 | |||
* | * 直接套用即可,加上这个模板可以防止你的图片色调与背景色调相似而违反Fandom定制化原则 | ||
== | === 渐变字体 === | ||
实际上用来实现文字变化... | |||
* * | * {{渐变字体|id=同折叠的num|before=文字1|after=文字2|time=循环一次的时间|delay=开始播放前的延迟}} | ||
* 与style修饰词冲突 | |||
== | === DarkTheme === | ||
默认主题... | |||
是版式,不过可以点击[[此处]]演示一下 | |||
* 使页面默认呈现深色主题(夜间模式),避免浅色主题(日间模式)字色不适配等问题 | |||
* 建议置于其他CSS模板之前,否则可能会覆盖同一个且没追加`!important`的属性 | |||
* `{{DarkTheme}}`或`{{CSS|Template:DarkTheme.css}}`均可 | |||
[[文件:Thebackrooms.jpg|200px|center|Thebackrooms|link=https://backrooms.fandom.com/zh/wiki/File:Thebackrooms.jpg]] | |||
[[分类:生存难度0]] | |||
[[分类:写作指导]] | |||
[[分类:指导]] | |||
[[分类: | |||
[[分类: | |||
[[分类: | |||
2026年8月8日 (六) 11:14的最新版本
- "模板功能入门"**是Fandom后室中文分部的**写作指导**
- 写手们在Fandom后室中分进行创作时应当遵守或参考本指导(我们强烈建议您读完再参与创作)。关于其它需要阅览的指导,请见""分类。
- 对指导内容有疑问的,可以在页面下方的评论区进行讨论,或者前往讨论版发帖咨询。
模板的本质很简单。你可以把模板当做是一个特殊的压缩包,你能把你需要的内容装在这个压缩包内,并把它放在页面中特定的位置。当你阅览它时这个压缩包就会被打开。
它通常被用来制成简单反复引用的板式、文本,亦或是制成代码糖。这里以一个最常见的Class模板做展示:

生存难度:
Class 0
》安全
》已勘探完全
》无实体

生存难度:
Class 0
》安全
》已勘探完全
》无实体
你当你要更改模板中对应的内容时则需要更改对应的参数的(内容)值,可更改的在模板的源代码里被用三个大括号({{{}}})括起来,若一个参数需要定义一个默认的值会在大括号中添加一个分割符(|)并在其左侧写上它的名称,右侧写上它的值。
如果相同的参数反复出现,那么更改一个参数的值会连带更改所有相同参数。
而当你需要使用一个模板时,只要遵循如下的格式:
未被定义的参数会默认显示它在模板源代码中的值,例如你想且只想改变上面例举生存难度模板中是否安全的部分,就写:

生存难度:
Class 0
》不安全
》已勘探完全
》无实体
最后你就会得到一个除了「安全」被替换成「不安全」以外与原来一模一样的「Class 0」。
如果一个模板中有未被定义的参数,且在源代码中也未被定义,那么这个模板在引用时它会直接显示为{{{参数}}}。并且名字是数字的参数会根据小到大的整数顺序(会绕过已定义值的参数)进行补全。
以在一开始就运用到的{{{1}}}为例:
在下主要内容
由于实际上的{{{1}}}模板中对应的参数形式实际是这样的: {{{1}}}
所以如果单单填上了模板名字的话会显示为【{{{1}}}({{{2}}})】。
如果你的浏览器是支持<Ruby>的话(别担心,绝大多数都会有,除了QQ内置的浏览器或是什么老旧手机的默认浏览器之类的)想要显示出上面的效果,不需要填写参数3和参数4,只要这么写: 在下主要内容
亦或者写上参数的名字也行: 在下主要内容
除此之外,你还可以用模板来整点活……例如让你的文在历史记录里显示的字符少几个量级(有人以此为目的做过),亦或者把大段的包含重复性代码的内容放在模板里,可以给需要反复于上下文编辑的情况下提供一些创作上的便利,**但如果实在没有必要的话就不建议这样做**,到时候如果你制作的模板导致了模板冗余、出错、不再使用还没法自己主动删除页面,得联系站务或是站务主动发现才能删除。
顺带一提,将表格插入进模板内会冲突,因此你需要使用源代码(例如常用的折叠),或是把表格做成代码。
更高层次的代码运用是迟早要摆脱一些作为代码糖的模板的。
想要找到模板的源代码,请搜索Template:你要找的模板名称。
常用模板列举
以下列举了一些常用的模板及其用法。模板的使用分为直接套用与修改参数两种方式。
Level Class
生存难度模板...

生存难度:
Class 0
》安全
》已勘探完全
》无实体
- `{{{background_color}}}`:生存难度框的背景色。默认为`linear-gradient(to right, #ffffff 0%, #DCDCDC 20%)`。
- `{{{border_color}}}`:生存难度框的边框色。默认为`#DCDCDC`。
- `{{{image}}}`:生存难度图标的文件名,不带`File:`命名空间前缀。默认为`C0.png`。
- `{{{sd_color}}}`:生存难度字样的颜色。默认为`black`(即#000000)。
- `{{{class}}}`:生存难度等级。默认为`Class 0`。
- `{{{bullet_color}}}`:三条楼层性质简述的颜色。默认为`#696969`。
- `{{{safety}}}`:楼层安全性。默认为`安全`。
- `{{{security}}}`:楼层勘探程度。默认为`已勘探完全`。
- `{{{entity}}}`:楼层实体数量。默认为`无实体`。
实际上最后三个参数可以和安全性、勘探程度和实体数量不一定关联,可以自由写。
Ruby
在选定内容顶部显示出注音...
在下主要内容
- 通常只需`下面的内容`即可,注意不做一些处理的话上下会被自动间距至等宽。
Collapse
是大家最爱的折叠...
- `{{{initial}}}`:点击后会展开折叠的内容
- `{{{final}}}`:点击后会关闭折叠的内容
- `{{{body}}}`:内容本身
- `{{{num}}}`:填上不同的数字来区分折叠,否则会一并关闭或打开
折叠内容空着可以让它开了就关不上。
可能不适的整活之前记得预警,阴间过头的活预不预警都得删。
Hr
水平分割线...
- `{{{thickness}}}`:分割线厚度,默认为2px。
- `{{{style}}}`:分割线样式,默认为`solid`。所有可用的值为:
* `dotted`:点状线 * `dashed`:虚线 * `double`:双实线 * `solid`:单实线 * 其它值会被转成`solid`。
- `{{{light_color}}}`:分割线在浅色主题下的颜色,默认采取`{{{color}}}`。
- `{{{dark_color}}}`:分割线在深色主题下的颜色,默认采取`{{{color}}}`。
- `{{{color}}}`:`{{{light_color}}}`和`{{{dark_color}}}`缺省时采用的颜色。对于浅色主题默认为`#B4B082`,对于深色主题默认为`#6B6B6B`。
- `{{{width}}}`:分割线长度,默认为90%(即占据完整宽度的90%)。
- `{{{margin-top}}}`:分割线到上元素的距离。默认为12px。
- `{{{margin-bottom}}}`:分割线到下元素的距离。默认为12px。
黑幕
遮盖内容...
- 不填写参数2默认为无
图片也行文件:雨竹疑问.png
Background
背景图片...
Fandom Community Header
导航栏不再让读者眼瞎...
这个不太方便上使用例
- 直接套用即可,加上这个模板可以防止你的图片色调与背景色调相似而违反Fandom定制化原则
渐变字体
实际上用来实现文字变化...
- 与style修饰词冲突
DarkTheme
默认主题...
是版式,不过可以点击此处演示一下
- 使页面默认呈现深色主题(夜间模式),避免浅色主题(日间模式)字色不适配等问题
- 建议置于其他CSS模板之前,否则可能会覆盖同一个且没追加`!important`的属性
- `模板:DarkTheme`或`模板:CSS`均可

