Help:视频与图片集维护说明

本页用于记录「视频 Videos」与「图片集 Portfolio」页面的维护方法，方便后续编辑者添加视频、补充封面、上传图片和扩展图片集内容。

视频页面维护

视频页面主要使用模板 {{视频}} 展示外链视频。普通编辑者只需要在页面中添加模板，不需要手动写 HTML 或 CSS。

添加一个新视频

在「视频 Videos」页面中添加以下格式：

{{视频
|标题=视频标题
|链接=https://www.bilibili.com/video/BVxxxxxxxxxx
|平台=BiliBili
}}

如果已经有封面文件，也可以手动指定封面：

{{视频
|标题=视频标题
|链接=https://www.bilibili.com/video/BVxxxxxxxxxx
|平台=BiliBili
|封面=Bilibili封面-BVxxxxxxxxxx.jpg
}}

字段说明：

标题：视频卡片中显示的视频名称。
链接：视频地址，目前主要支持 Bilibili 视频链接。
平台：视频平台名称，例如 BiliBili。
封面：可选字段。填写后，视频卡片左侧会显示该图片作为缩略图。

自动补充 Bilibili 封面

服务器上有一个脚本可以自动扫描视频页面中的 Bilibili 链接，抓取视频封面，上传到 Wiki，并把封面字段补回模板中。

脚本位置：

/opt/wiki/tools/bilibili_cover_bot.py

手动运行方式：

python3 /opt/wiki/tools/bilibili_cover_bot.py \
  --api https://wiki.noblecraftmusic.cloud/api.php \
  --user 你的Wiki用户名 \
  --title "视频 Videos"

建议正式执行前先 dry-run 检查：

python3 /opt/wiki/tools/bilibili_cover_bot.py \
  --api https://wiki.noblecraftmusic.cloud/api.php \
  --user 你的Wiki用户名 \
  --title "视频 Videos" \
  --dry-run

如果 dry-run 显示会修改页面，再去掉 --dry-run 正式执行。

注意事项：

脚本只会处理使用 {{视频}} 模板的视频。
链接中需要包含 Bilibili 的 BV 号。
已经有 封面= 的视频通常不会重复处理。
如果封面没有显示，先检查文件名是否完整、模板中是否已经补上 封面=文件名.jpg。

图片集页面维护

「图片集 Portfolio」页面使用自定义卡片排版。添加图片时，不再直接使用普通的 [[File:...|thumb]] 排列，而是把图片放进对应的卡片结构中。

添加图片前，请先把图片上传到 Wiki，并记住上传后的文件名。

添加官方设定图

官方设定图放在「官方设定图」下的对应区域，例如「服务器娘」。

在对应的 nc-character-grid 区块中，添加一个卡片：

<div class="nc-art-card">
<div class="nc-art-image">[[File:文件名.jpg|link=File:文件名.jpg]]</div>
<div class="nc-art-caption">'''作品标题'''<br><span>画师：作者名</span></div>
</div>

示例：

<div class="nc-art-card">
<div class="nc-art-image">[[File:诺布-新服装.jpg|link=File:诺布-新服装.jpg]]</div>
<div class="nc-art-caption">'''诺布 - 新服装'''<br><span>画师：作者名</span></div>
</div>

添加 LOGO 或品牌素材

LOGO 区使用 nc-logo-card。在 LOGO 区添加：

<div class="nc-logo-card">
<div class="nc-logo-image">[[File:文件名.png|frameless|320x180px|link=File:文件名.png]]</div>
<div class="nc-art-caption">'''作品标题'''<br><span>设计：作者名</span></div>
</div>

如果是夜间版、黑底版 LOGO，可以在图片区额外加 nc-logo-dark：

<div class="nc-logo-card">
<div class="nc-logo-image nc-logo-dark">[[File:文件名.png|frameless|320x180px|link=File:文件名.png]]</div>
<div class="nc-art-caption">'''作品标题'''<br><span>设计：作者名</span></div>
</div>

添加玩家创作

玩家创作放在「玩家创作」区域的 nc-fanart-grid 中。

<div class="nc-art-card">
<div class="nc-art-image">[[File:文件名.jpg|link=File:文件名.jpg]]</div>
<div class="nc-art-caption">'''作品标题'''<br><span>创作者：作者名</span></div>
</div>

示例：

<div class="nc-art-card">
<div class="nc-art-image">[[File:诺布娘 - 玩家名.jpg|link=File:诺布娘 - 玩家名.jpg]]</div>
<div class="nc-art-caption">'''诺布娘'''<br><span>创作者：玩家名</span></div>
</div>

添加隐藏展区图片

隐藏展区目前建议继续使用折叠模板，不建议在折叠模板里塞复杂卡片代码。

推荐格式：

{{折叠|标题=这是？|[[File:文件名.jpg|center|thumb|420x420px|'''作品标题'''<br>创作者：作者名]]}}

样式修改说明

视频卡片和图片集卡片的样式写在：

MediaWiki:Common.css

一般编辑内容时，不需要修改 CSS。只有在需要调整卡片尺寸、阴影、颜色、间距时，才修改 Common.css。

重要原则：

页面内容放在「视频 Videos」或「图片集 Portfolio」页面中。
视觉样式放在 MediaWiki:Common.css 中。
不要用新的 CSS 覆盖整份 Common.css，除非已经确认备份。
添加补丁类 CSS 时，通常放在 Common.css 的最底部，方便覆盖旧样式。

常见问题

视频没有封面

可能原因：

模板中还没有 封面= 字段。
自动脚本还没有运行。
Bilibili 链接格式不规范，脚本没有识别到 BV 号。
封面文件名中有特殊字符，导致图片没有被正确引用。

建议先检查页面源码中对应视频模板是否已经出现 封面=...。

图片集新图片没有变成卡片

通常是因为图片没有放进正确的卡片结构中。请确认图片被包在：

<div class="nc-art-card">
...
</div>

或：

<div class="nc-logo-card">
...
</div>

里面。

图片比例不一样会不会影响页面

不会。图片集卡片会自动把图片限制在展示区域内。不同尺寸、不同长宽比的图片都可以添加，但建议上传清晰版本，并尽量避免过小的图片。

白底图片看起来突兀怎么办

目前图片集样式已经尽量使用接近白色的展示底，减少白底图片的突兀感。如果仍然明显，可以优先考虑上传带透明背景的 PNG，或保留原图但接受其作为作品本身的一部分展示。