查看“︁帮助:ARG与Puzzle标准页面”︁的源代码

本页展示 ARG / Puzzle 档案中常见内容的写法。示例仅用于排版，不对应真实项目；实际编写时用自己的材料替换，并把完整解答直接写出。开头用普通段落介绍项目背景、本文范围和目前结论；如果是转载或翻译，在这一段注明原作者和原文链接。

== 基本信息 ==
在可视化编辑器中插入“基本信息”，填写已经确认的字段；源代码写法如下。未知字段可以留空，自定义字段用于记录平台或资料范围。
<div class="mc-example-preview">
{{基本信息
|显示标题=否
|名称=ARG / Puzzle 档案示例
|创作团队/个人=
|开始时间=
|结束时间=
|状态=仅作排版示例
|相关作品=
|自定义标签1=资料范围
|自定义内容1=本页给出的完整演示材料
}}
</div>
<div class="mc-example-source"><pre>{{基本信息
|显示标题=否
|名称=ARG / Puzzle 档案示例
|创作团队/个人=
|开始时间=
|结束时间=
|状态=仅作排版示例
|相关作品=
|自定义标签1=资料范围
|自定义内容1=本页给出的完整演示材料
}}</pre></div>


== 具体流程 ==
按项目的实际阶段安排小节。在叙述中遇到下列内容时，选用相应写法，不必把所有区块都塞进每篇文章。

=== 原始材料与线索 ===
先给出原始内容和出处，再写观察与推论。可以插入“资料记录”；长篇原文可直接放在段落中，使用小节链接关联。
<div class="mc-example-preview">
{{资料记录
|编号=R01
|标题=十六进制文本
|原始内容=<code>666F6F</code>
|出处=[https://www.rfc-editor.org/rfc/rfc4648.html#section-10 RFC 4648 第 10 节测试向量]
|观察=按两个字符分组，可以得到 66、6F、6F。
|核实情况=对应完整文本为 foo，与该测试向量一致。
}}
</div>
<div class="mc-example-source"><pre>{{资料记录
|编号=R01
|标题=十六进制文本
|原始内容=&lt;code&gt;666F6F&lt;/code&gt;
|出处=[https://www.rfc-editor.org/rfc/rfc4648.html#section-10 RFC 4648 第 10 节测试向量]
|观察=按两个字符分组，可以得到 66、6F、6F。
|核实情况=对应完整文本为 foo，与该测试向量一致。
}}</pre></div>


=== 图片与多张图片 ===
普通图片可以直接插入缩略图。需要把说明与来源放在一起时，插入“图片说明”。下面借用本站已有的数独图片演示排版，'''它不是本示例的 ARG 线索'''；文件来源与版权以文件描述页为准。
<div class="mc-example-preview">
{{图片说明|图片=[[文件:Sudoku.webp|缩略图|居中|300px|数独图片，仅演示排版]]|说明=说明画面中需要读者注意的部分。此图不属于上方转换示例。|来源=[[:文件:Sudoku.webp|文件描述页中的来源与版权信息]]}}
</div>
<div class="mc-example-source"><pre>{{图片说明|图片=[[文件:Sudoku.webp|缩略图|居中|300px|数独图片，仅演示排版]]|说明=说明画面中需要读者注意的部分。此图不属于上方转换示例。|来源=[[:文件:Sudoku.webp|文件描述页中的来源与版权信息]]}}</pre></div>

多张图片可使用图库；说明中写清各图的差别，不用把每张图片再套进信息卡片。
<div class="mc-example-preview">
<gallery widths="180" heights="140">
Sudoku.webp|现有文件的图示与说明
凯撒密码加密图例.png|另一张现有图片；来源见文件描述页
</gallery>
</div>
<div class="mc-example-source"><pre>&lt;gallery widths="180" heights="140"&gt;
Sudoku.webp|现有文件的图示与说明
凯撒密码加密图例.png|另一张现有图片；来源见文件描述页
&lt;/gallery&gt;</pre></div>

音频、视频和下载材料也应写明文件名、内容要点、出处与访问方式。视频按 [[编辑守则#图片和媒体使用规范|媒体规范]] 处理；不要只留下一个让读者另行寻找答案的链接。

=== 对照表与数据表 ===
字符映射、时间对照或多项材料比较使用普通 Wikitext 表格，不需要另找“表格开始”和“表格结束”模板。本例的每一行对应一个字节。
<div class="mc-example-preview">
{| class="wikitable"
! 次序 !! 十六进制字节 !! 十进制值 !! ASCII 字符
|-
| 1 || 66 || 102 || f
|-
| 2 || 6F || 111 || o
|-
| 3 || 6F || 111 || o
|}
</div>
<div class="mc-example-source"><pre>{| class="wikitable"
! 次序 !! 十六进制字节 !! 十进制值 !! ASCII 字符
|-
| 1 || 66 || 102 || f
|-
| 2 || 6F || 111 || o
|-
| 3 || 6F || 111 || o
|}</pre></div>

模板参数里的普通竖线写作 <code><nowiki>{{!}}</nowiki></code>；<code><nowiki>[[条目|显示文字]]</nowiki></code> 的链接分隔符保持原样。复杂表格直接放在正文中。

=== 解谜过程 ===
使用“解谜记录”把输入、方法、中间步骤、输出和验证放在一起。较长过程也可以直接用普通小节，不必把整章放入一个模板参数。
<div class="mc-example-preview">
{{解谜记录
|标题=十六进制文本的转换
|输入=<code>666F6F</code>
|方法=每两个十六进制字符表示一个字节，按 ASCII 文本读取。
|过程=
# 分为 <code>66 6F 6F</code>。
# 字节值为十进制 <code>102 111 111</code>。
# 对应小写字符 <code>f</code>、<code>o</code>、<code>o</code>。
|结果=<code>foo</code>
|验证=[https://www.rfc-editor.org/rfc/rfc4648.html#section-10 RFC 4648 第 10 节]给出相同测试向量。
}}
</div>
<div class="mc-example-source"><pre>{{解谜记录
|标题=十六进制文本的转换
|输入=&lt;code&gt;666F6F&lt;/code&gt;
|方法=每两个十六进制字符表示一个字节，按 ASCII 文本读取。
|过程=
# 分为 &lt;code&gt;66 6F 6F&lt;/code&gt;。
# 字节值为十进制 &lt;code&gt;102 111 111&lt;/code&gt;。
# 对应小写字符 &lt;code&gt;f&lt;/code&gt;、&lt;code&gt;o&lt;/code&gt;、&lt;code&gt;o&lt;/code&gt;。
|结果=&lt;code&gt;foo&lt;/code&gt;
|验证=[https://www.rfc-editor.org/rfc/rfc4648.html#section-10 RFC 4648 第 10 节]给出相同测试向量。
}}</pre></div>

只有单独一步需要强调时，可以插入“步骤”：
<div class="mc-example-preview">
{{步骤|序号=01|标题=按字节分组|内容=将 666F6F 分为 66、6F、6F，每组两个十六进制字符。}}
</div>
<div class="mc-example-source"><pre>{{步骤|序号=01|标题=按字节分组|内容=将 666F6F 分为 66、6F、6F，每组两个十六进制字符。}}</pre></div>


=== 代码、密文与原始格式 ===
短字符使用 <code>&lt;code&gt;</code>；程序、密文或需要保留空格换行的材料使用 <code>&lt;pre&gt;</code>。要显示 Wikitext 本身而不执行它，用 <code>&lt;nowiki&gt;</code>。保留原始大小写、颜色及符号。
<div class="mc-example-preview">
<pre>value = "666F6F"
result = bytes.fromhex(value).decode("ascii")
print(result)
# 输出：foo</pre>
</div>
<div class="mc-example-source"><pre>&lt;pre&gt;value = "666F6F"
result = bytes.fromhex(value).decode("ascii")
print(result)
# 输出：foo&lt;/pre&gt;</pre></div>

如果使用工具处理过图片或文本，应同时保留原始材料，写清工具、参数、操作与输出，不能只给最终截图。

=== 时间与阶段 ===
资料中有可靠日期时使用“事件记录”，连续放置多个完整调用即可。日期只有年或月时按该精度填写；没有时间依据就不加日期。
<div class="mc-example-preview">
{{事件记录|日期=日期未提供（示例）|事件=这里记录已经发生的事件；本例不设虚构活动日期。|来源=替换为实际支持该事件的出处。}}
</div>
<div class="mc-example-source"><pre>{{事件记录|日期=日期未提供（示例）|事件=这里记录已经发生的事件；本例不设虚构活动日期。|来源=替换为实际支持该事件的出处。}}</pre></div>

阶段较多时，按“第一阶段”“第二阶段”组织三级标题，必要时将大段材料放到关联子页，总述中仍应给出结论和明确链接。

=== 原文摘录、补充说明与结论 ===
原文摘录使用“引用摘录”，编写者的推论写在摘录外。下面只引用本页教学材料中的一句话，不是实际项目文献。
<div class="mc-example-preview">
{{引用摘录|内容=每两个十六进制字符表示一个字节。|出处=本页教学说明；不是实际项目原文。}}
</div>
<div class="mc-example-source"><pre>{{引用摘录|内容=每两个十六进制字符表示一个字节。|出处=本页教学说明；不是实际项目原文。}}</pre></div>

内容范围或已知限制可用“信息提示”，但结论和答案要保持直接可见。
<div class="mc-example-preview">
{{信息提示|类型=提示|标题=资料范围|内容=本文只记录已经核实的内容。没有来源支持的推测应另行说明，不作为已证实结论。}}
</div>
<div class="mc-example-source"><pre>{{信息提示|类型=提示|标题=资料范围|内容=本文只记录已经核实的内容。没有来源支持的推测应另行说明，不作为已证实结论。}}</pre></div>

本例中的 <code>666F6F</code> 按字节转换为 ASCII（美国信息交换标准代码）文本后得到 <code>foo</code>。这一结果与 RFC 4648 的测试向量一致；它不表示存在后续网址、密码或隐藏任务。<ref name="arg-rfc">{{引文信息|标题=RFC 4648|网址=https://www.rfc-editor.org/rfc/rfc4648.html#section-10|作者=Simon Josefsson|定位=第 10 节：测试向量}}</ref>

=== 子页与相关条目 ===
需要连接长文的不同部分时插入“阅读导航”，填写实际存在的页面名称。下面用本站现有档案入口演示：
<div class="mc-example-preview">
{{阅读导航|上一页=ARG档案|目录=编写指南|下一页=工具和科普}}
</div>
<div class="mc-example-source"><pre>{{阅读导航|上一页=ARG档案|目录=编写指南|下一页=工具和科普}}</pre></div>


== 参考资料 ==
外部事实后紧跟 <code>&lt;ref&gt;</code> 引用；同一来源可以复用名字。文末放一次 <code>&lt;references /&gt;</code>。编号和返回正文的链接会自动生成：
<div class="mc-example-preview">
本例可以用规范中的测试向量复核。<ref name="demo-hex">{{引文信息|标题=RFC 4648|网址=https://www.rfc-editor.org/rfc/rfc4648.html#section-10|作者=Simon Josefsson|定位=第 10 节：测试向量}}</ref>
同一来源再次使用时不重复录入。<ref name="demo-hex" />
</div>
<div class="mc-example-source"><pre>本例可以用规范中的测试向量复核。&lt;ref name="demo-hex"&gt;{{引文信息|标题=RFC 4648|网址=https://www.rfc-editor.org/rfc/rfc4648.html#section-10|作者=Simon Josefsson|定位=第 10 节：测试向量}}&lt;/ref&gt;
同一来源再次使用时不重复录入。&lt;ref name="demo-hex" /&gt;</pre></div>

已有文章用“参考资料”模板维护列表时，也可以继续这样写：
<div class="mc-example-preview">
{{参考资料|标题=其他参考资料|参考1=[https://www.rfc-editor.org/rfc/rfc4648.html RFC 4648 原文]}}
</div>
<div class="mc-example-source"><pre>{{参考资料|标题=其他参考资料|参考1=[https://www.rfc-editor.org/rfc/rfc4648.html RFC 4648 原文]}}</pre></div>

<references />

[[模板:ARG条目起稿#源代码|复制整页框架]] · [[编写指南|返回编写指南]] · [[模板说明|全部模板说明]]