模板:ISEvent

模板文档  

这个文档嵌入自模板:ISEvent/doc。

简述

此模板为系列模板，旨在通过基于Vue组件框架的HTML+JS方式书写灵活性更高的集成战略事件列表。 包含以下组件：

• Widget:ISEvent —— 核心JS处理库，可通过GitHub仓库进行底层处理代码修改和提交。
• 模板:ISEvent —— 本模板。数据外包装。
• 模板:ISEvent/scene —— 场景定义类模板。
• 模板:ISEvent/choose —— 选项定义类模板。

架构

本系列模板的基础架构如下：

• 数据外包装：包裹整个数据供核心处理库处理。
  • 事件：多个场景的集合体。
    • 场景：一个具有图像、标题和解说的场景，可以包含若干选项；等效于游戏中事件的“一屏”。
      • 选项：一个具有选项名称、选项详情和图标的选项；可以互动用于场景之间跳转。

如何撰写

首先，在页面中放置 Widget:ISEvent，并使用 {{#vardefine:theme|<主题名>}}{{#vardefine:link|<收藏品一览页面名>}}定义收藏品页面跳转（如：傀影与猩红孤钻、长生者宝盒）。

之后放置本模板（{{ISEvent}}）。

定义事件

在ISEvent中，用 |事件X=（X=1,2,3...）定义一个事件。

• 为了维护方便，你可以在新的类别起使用新的X命名方式（如“story1”等）。

定义场景

定义好一个事件后，即可在此事件中，用 {{ISEvent/scene}} 模板插入一个场景。具体参数如下：

• etype （可选）指定场景所属类别，将会变为一个二级标题（如：不期而遇）。只在该类别第一个事件的第一个场景填写。
• 无名第一参数 指定该场景的别名，用于这个事件的内部导航，可视情况自定。
• 无名第二参数 指定该场景的显示图片，自动调用Wiki内图像，不需要扩展名。
• 无名第三参数 指定该场景的标题。
• 无名第四参数 指定该场景的描述。
• 选项 （可选）指定该场景包含的选项。

一个事件常常拥有许多个场景，此时只需要把多个 {{ISEvent/scene}} 连续排列即可。

这里是一个水月与深蓝之树“悬高之葬”事件的场景样例（略去选项，有删减）：

{{ISEvent/scene|etype=不期而遇|开始|Avg_pic_rogue_2_1|悬高之葬|你正站在一座悬崖墓园内。这里正在举行送别逝者的仪式。……}}
{{ISEvent/scene|结束|Avg_pic_rogue_2_1|悬高之葬|祷告结束，你抬头向悬崖下方望去。……}}

定义选项

用 {{ISEvent/choose}} 在场景中插入若干选项。具体参数如下：

• 无名第一参数 指定选项类型，包括以下几种：
• 无名第二参数 指定选项名称；
  • simple：简单选项。这将会生效下列选项：
    • 无名第三参数 指定选项图标，根据ID自动调用Wiki内图像，不需要扩展名。
  • collection：获得具体收藏品的选项。这将会生效下列选项：
    • 无名第三参数 指定收藏品的图鉴ID。
  • item：获得具体的集成战略专属道具的选项。这将会生效下列选项：
    • 无名第三参数 指定道具名称。
  • desc：该“选项”不是选项，而是用于穿插描述而用的说明性文字。
    • 此类型无参数，并弃用原本的第二参数。
• desc1 （可选）指定该选项的附加说明文字，以游戏内为准。
• desc2 （可选）指定该选项的附加信息，一般用于补充该选项的说明。
• dest （可选）指定要跳转的目标场景的序号。
  以初始场景为0，按书写顺序依次递增。

这里是一些探索者的银凇止境事件的选项样例：

{{ISEvent/choose|simple|扑进去！|population|desc1=获得{{color|#b4f7ff|2}}希望|dest=2}}
{{ISEvent/choose|collection|搜索营地|220|desc1=获得收藏品{{color|#b4f7ff|树痕之盔}}|dest=1}}
{{ISEvent/choose|item|强化训练|高级物资配给券|desc1=获得进阶券<br/>{{color|#b4f7ff|高级物资配给券}}|dest=2}}
{{ISEvent/choose|desc|desc1={{fa|info-circle}} '''以下选项随机出现3个'''}}