排版指南 · Layout Guide

排版指南
LAYOUT GUIDE — ROCK THEME

磐石主题(rock)排版构件参考。本页本身使用 rock-docs 风格——比文章卡片更宽、无缩进、无衬线,便于浏览代码与对照预览。

正常 category 下的页面通过 _template 自动加载主题样式。system:theme:contest: 等命名空间下的页面需要手动添加 include:

1. 文章容器 Article Container

.rock-article

SCP 档案、报告类长文使用的米色纸面卡片,760px 最大宽度,衬线字体,自动处理 Wikidot 段落 <p> 边距,首行缩进 2 字符。适合叙述性长文,不适合作为导航 / 文档页。

Wiki source

[[div class="rock-article"]]

... 文章内容 ...

[[/div]]

2. 章节标题 Section Heading

.rock-article-h + .rock-article-h-en

中文标题在上,英文 caps-spaced 副标题自动换行显示在下。

特殊收容措施 Special Containment Procedures

Wiki source

[[div class="rock-article-h"]]
特殊收容措施 [[span class="rock-article-h-en"]]Special Containment Procedures[[/span]]
[[/div]]

3. 元数据面板 Meta Panel

.rock-article-meta · .rock-article-meta-row · .rock-article-meta-label

"项目编号""项目等级""负责研究员"等键值对。米色背景 + 黑色左侧粗边。

Wiki source

[[div class="rock-article-meta"]]
[[div class="rock-article-meta-row"]]
[[span class="rock-article-meta-label"]]项目编号:[[/span]] SCP-173b
[[/div]]
[[div class="rock-article-meta-row"]]
[[span class="rock-article-meta-label"]]项目等级:[[/span]] Euclid
[[/div]]
[[/div]]

4. ACS 头部 ACS Header

.rock-acs-header · .rock-acs-id · .rock-acs-name · .rock-acs-tags · .rock-acs-tag

SCP-XXXX 编号 + 可选项目名 + 分类 chip 行。配色与 SCP 官方 ACS 一致。

两种形态: 若提供 .rock-acs-name,编号会自动降为小号 caps-label 显示在项目名上方;若省略,编号本身就是大标题——不会留出空白位。

SCP-173b

混凝土雕像 · 变种 II

LEVEL 3 EUCLID · 欧几里得 VLAM · 低度扰动 WARNING · 警告

SCP-XXX

LEVEL 2 SAFE · 安全 NOTICE · 提示

Wiki source — 带项目名 (with name)

[[div class="rock-acs-header"]]
[[div class="rock-acs-id"]]
SCP-173b
[[/div]]
[[div class="rock-acs-name"]]
混凝土雕像 · 变种 II
[[/div]]
[[div class="rock-acs-tags"]]
[[span class="rock-acs-tag rock-acs-clearance lvl3"]]LEVEL 3[[/span]]
[[span class="rock-acs-tag rock-acs-euclid"]]EUCLID · 欧几里得[[/span]]
[[span class="rock-acs-tag rock-acs-vlam"]]VLAM · 低度扰动[[/span]]
[[span class="rock-acs-tag rock-acs-warning"]]WARNING · 警告[[/span]]
[[/div]]
[[/div]]

Wiki source — 仅编号 (id only)

[[div class="rock-acs-header"]]
[[div class="rock-acs-id"]]
SCP-XXX
[[/div]]
[[div class="rock-acs-tags"]]
[[span class="rock-acs-tag rock-acs-clearance lvl2"]]LEVEL 2[[/span]]
[[span class="rock-acs-tag rock-acs-safe"]]SAFE · 安全[[/span]]
[[span class="rock-acs-tag rock-acs-notice"]]NOTICE · 提示[[/span]]
[[/div]]
[[/div]]

5. ACS 标签配色 ACS Tag Palette

.rock-acs-tag.rock-acs-<class>

所有可用的 ACS 类名。按收容、扰动、风险、许可四组排列。

收容等级 · CONTAINMENT

SAFE
EUCLID
KETER
THAUMIEL
APOLLYON
ARCHON
NEUTRALIZED
PENDING

扰动等级 · DISRUPTION

DARK
VLAM
KENEQ
EKHI
AMIDA

风险等级 · RISK

NOTICE
CAUTION
WARNING
DANGER
CRITICAL

安全许可 · CLEARANCE

LEVEL 1
LEVEL 2
LEVEL 3
LEVEL 4
LEVEL 5

6. 图片与占位 Image & Placeholder

.rock-article-image 是固定 260px 宽的右浮动容器,正文从左侧绕排。容器内可放三种内容:真实竖图、真实横图、或占位组件。每种之下是一个示例 + 源代码。

真实竖图 — vertical image

人物、雕像、肖像等竖向素材。图片按比例缩放至 260px 宽,下方可附 caption。

Carmonte 系列竖图

Carmonte


正文从图片左侧绕排——这一段文字示例占用足够多的行数来展示 float: right 的视觉效果。在实际文章中,特殊收容措施、描述、附录等正文段落会自然地围绕图片的左侧延展。当正文长度小于图片高度时,图片下方留白;正文较长时,文字会在图片下方继续延伸。

Wiki source

[[div class="rock-article-image"]]
[[image https://roleplay.ncgs.top/storage/img/carmonte-1.png alt="..."]]
[[div class="rock-article-image-caption"]]
图注内容(可多行)
[[/div]]
[[/div]]

真实横图 — horizontal image

地点、设施、场景等横向素材。同样占 260px 宽,按比例缩放,高度较小,正文绕排区域更长。

海上钻井平台

胡安·德·富卡海峡以西 · 改造钻井平台
卫星侦察图 · 2026-04-26


横图占据 260px 宽但高度较小,因此正文有较长的绕排空间。如果你的图片是地图、设施鸟瞰、场景照之类的横向素材,效果会比竖图更自然——读者首先看到的是图,然后视线自然进入左侧的描述文字。这种排版适合大多数 SCP 现场记录类文章。

Wiki source

[[div class="rock-article-image"]]
[[image https://roleplay.ncgs.top/storage/img/oilrig.png alt="..."]]
[[div class="rock-article-image-caption"]]
图注内容(可多行)
[[/div]]
[[/div]]

占位组件 — placeholder (no image yet)

正式图片尚未提供时使用 .rock-article-image-placeholder。固定 4:5 竖向占位,斜条纹背景 + 中央问号图标。有正式图片后,只需把整个 .rock-article-image-placeholder 块替换为 URL——外框与 caption 保留不变。

?
待补充图片
IMAGE PENDING · CL-3 ACCESS ONLY

SCP-173b · 收容前现场记录 · Site-47 / B-04


正文从占位框左侧绕排——和真实图片版面一致。这种占位适合提交未配图的稿件,让审稿和读者明确知道"此处预留图片",而不是简单留空。后续可无缝替换为真实图片。

Wiki source

[[div class="rock-article-image"]]
[[div class="rock-article-image-placeholder"]]
[[span class="rock-article-image-icon"]]?[[/span]]
[[span class="rock-article-image-text"]]待补充图片[[/span]]
[[span class="rock-article-image-meta"]]IMAGE PENDING · CL-3 ACCESS ONLY[[/span]]
[[/div]]
[[div class="rock-article-image-caption"]]
SCP-XXX · 现场记录
[[/div]]
[[/div]]

7. 全宽题图 Embedded Hero Image

.rock-article-hero横向延伸至文章左右边缘的题图构件,常用于故事 / 长文的视觉头图。图片通过容器的 background-image 设置,标题文字以 9 宫格方式叠加在图上——按图片亮部分布选择最不干扰的格位。默认居中、白色粗体;亮底图可加 .dark 切换为黑色文字,需要竖排标题可加 .vert(书写方向 vertical-rl + CJK 字符直立)。

.rock-article-hero.vert.pos-mr — 竖排 / 右贴边

负边距 -2.4em / -2.6em 让此构件穿出 .rock-article 的内边距,撑满纸卡左右边缘。默认 21:9 宽高比;如需更高,可在容器加 inline aspect-ratio 覆盖。本例使用 .vert 竖排 + .pos-mr 右侧贴边,白色粗体。

分裂

正文起点 Body Begins


图下直接衔接章节标题——题图本身不参与 <p> 段落流程,因此与下方内容之间不会出现额外空隙。

Wiki source

[[div class="rock-article-hero vert pos-mr" style="background-image: url(...)"]]
[[div class="rock-article-hero-title"]]
分裂
[[/div]]
[[/div]]

.rock-article-hero.vert — 竖排 / 居中

不指定位置类时默认中心 (.pos-mc);与 .vert 搭配,呈现书脊式的居中竖排标题。本例使用故事《征召》的封面图。

征召

“所以,你承认。”

“我承认我下了那道命令。”

“原话。”

“……‘对那群叛徒开火。’”

“‘那群’指谁。”

“驻站 MTF。”

“再具体一点,沃斯。原话里有没有修饰性的指代。”

“我说……我说‘那群拿着 O5 逮捕令冲进我办公室的叛徒’。”

“是原话,还是你整理过的?”

“是原话。”

“还有别的吗。”

“……还有一句‘去他妈的’。”

“去他妈的什么?”

“去他妈的,所有人。”

Wiki source

[[div class="rock-article-hero vert" style="background-image: url(...)"]]
[[div class="rock-article-hero-title"]]
征召
[[/div]]
[[/div]]
[[div class="rock-article-body"]]
正文段落 1。

正文段落 2。
[[/div]]

.rock-article-hero.dark.pos-tl — 横排 / 左上 / 黑色标题

省略 .vert 即为默认横排,标题水平展开;加 .dark 把标题改为黑色 + 浅描边,适合白底 / 高曝光 / 雾色调的图像。本例同时使用 .pos-tl 把标题放在左上角。

档案 · A


横排模式下,文字按通常的西文 / 中文水平排版方向延展;适合大多数普通页面标题。

Wiki source

[[div class="rock-article-hero dark pos-tl" style="background-image: url(...)"]]
[[div class="rock-article-hero-title"]]
档案 · A
[[/div]]
[[/div]]

位置类(9 宫格): .pos-tl · .pos-tc · .pos-tr · .pos-ml · .pos-mc · .pos-mr · .pos-bl · .pos-bc · .pos-br。第一个字母为行(top/middle/bottom),第二个为列(left/center/right)。不写位置类时默认中心 (.pos-mc)。

颜色变体:.dark 把标题改为黑色 + 浅描边;适合白底 / 雾色调 / 高曝光主体的图。

书写方向:.vert 把标题切换为竖排(writing-mode: vertical-rl + CJK 字符直立);省略则横排。.vert.dark、9 宫格位置类可自由叠加。

使用前提: 此构件须放在 .rock-article 容器之内(依赖文章卡片的内边距对齐)。放在文章首行可贴齐顶端;放在文章中段时通过 inline margin-top: 0 收紧上边距。

8. 引用 / 文献节录 Quote Block

.rock-article-quote + .cite

报告、批注、外勤手记、邮件节录。金色左边、斜体衬线字体、底部可选引用署名(.cite span)。

"……合金中检出锆、铪、钽等高熔点元素,比例不符合任何已知人造合金。"
— Dr. M. Aragawa · 化学部门 · 173b/CHEM-001

Wiki source

[[div class="rock-article-quote"]]
"……合金中检出锆、铪、钽等高熔点元素。"
[[span class="cite"]]— Dr. M. Aragawa · 化学部门 · 173b/CHEM-001[[/span]]
[[/div]]

9. CTA 按钮 Call-To-Action Button

.rock-cta + link

将 Wikidot 链接(无论是页面链接还是带斜杠的相对/绝对路径形式)包裹在 .rock-cta 容器里即可渲染为按钮。具体链接语法请见下方源代码。默认是黑色方块按钮,hover 反色。

Wiki source

[[div class="rock-cta"]]
[/system:join 申请权限 →]
[[/div]]

10. 可折叠区块 Collapsible Block

Wikidot 内置的折叠组件。showhide 属性分别控制收起/展开状态下显示的按钮文字。本页顶部的 "查看 include 写法" 折叠就是这种用法。可附加 folded="no" 让区块默认展开,hideLocation="both" 在展开后也保留收起按钮。

Wiki source

[[collapsible show="▸ 展开示例内容" hide="▾ 收起"]]
被折叠的内容……

[[div class="rock-article-quote"]]
"任意 wikitext 都可放入。"
[[span class="cite"]]— 引用署名[[/span]]
[[/div]]
[[/collapsible]]

11. 表单 / 输入框 Form & Inputs

.rock-apply (Wikidot Data Form wrapper)

.rock-apply 容器为 Wikidot Data Form 生成的 input / textarea / submit 元素提供米色卡片样式。要让 Data Form 渲染为真实表单,须在站点设置中将页面 category 标记为 form 模式。本页是普通页面,下方仅为视觉占位示意。

姓名

请输入姓名…

自我介绍

请填写……

提交申请

Wiki source skeleton

[[div class="rock-apply"]]
... 在 form 类别页面中,Wikidot Data Form 字段
    会被注入为 input / textarea / submit;
    本 wrapper 提供整体样式。
[[/div]]

参考 system:join 的实际实现。

12. 页脚 Article Footer

.rock-article-footer

文章末尾的细线 + 居中说明栏,用于注明归档单位、转载说明等。

Wiki source

[[div class="rock-article-footer"]]
SCP-173b · 由 Site-47 内部研究存档管理
[[/div]]

13. 完整文章骨架 Full Article Skeleton

copy-paste starter

组合前面各小节作为新 SCP 档案的起点:rock-article 外壳 → rock-acs-header(ID + tags)→ rock-article-meta(项目编号 / 等级 / 负责研究员)→ 若干 rock-article-h 小节(特殊收容措施 / 描述 / 附录)→ rock-article-footer

直接参考 scp-173b 的源代码作为完整范本(在该页"+ Options" → "Edit" 即可查看)。

14. Wikidot 解析陷阱 Parser Gotchas

⚠ 务必避免以下写法

  • 不要把 div 开闭标签和内容挤在同一行。 单行内联(开标签 + 内容 + 闭标签全部一行)会导致内容被吞,并污染后续整页的解析。每个标签、每段内容都必须独占一行。
  • 不要写空的带 class span 标签。 完全空的 span 会被 Wikidot 静默删除。若只是想插入一个样式占位(例如 ACS 图标),在里面放一个英文句点(.)作为占位字符——主题 CSS 会通过 color: transparent 把它视觉上隐藏。
  • 不要在 span 标签上使用行内 style 属性。 本站会剥离 span 上的 style。需要样式请在 theme:rock-css 中定义 class,然后通过 class 名引用。div 标签上的 style 属性是保留的,可以正常使用 style="display:none" 等。
  • 不要用 Wikidot 自带的方括号-感叹号注释语法隐藏整段 div。 它只对内联文本可靠,无法稳定隐藏块级内容。要彻底隐藏一段 div,请用带 style="display:none" 属性的 div 包裹被隐藏的内容。

相关页面 Related

除非特别注明,本页内容采用以下授权方式: Creative Commons Attribution-ShareAlike 3.0 License