欢迎各位归还者的到来,目前Wiki正在建设中。同时本WIKI编辑权限开放,欢迎收藏起来防止迷路,也希望有爱的小伙伴和我们一起编辑哟~

全站通知:

WIKI编辑教程

阅读

    

2026-04-09更新

    

最新编辑:猫猫踏月光

阅读:

  

更新日期:2026-04-09

  

最新编辑:猫猫踏月光

来自归环WIKI_BWIKI_哔哩哔哩
跳到导航 跳到搜索
页面贡献者 :
猫猫踏月光


归环BWIKI · 共建者完全指南
📚 WIKI编辑完全教程
从零基础到精通,成为归环BWIKI核心贡献者
踏上取经路,比抵达灵山更重要
📖 基础入门
🛠️ 进阶技巧
🎨 样式设计
👥 社区协作
🧭 快速导航
快速上手
5分钟入门
🏠
BWIKI基础
平台介绍
📖
学习路径
入门到精通
📝
基础语法
Wiki标记
🔧
高级语法
魔术字函数
🧩
模板系统
复用组件
🎨
样式设计
CSS布局
🖼️
图片媒体
上传管理
最佳实践
规范技巧
常见问题
排错指南
快速上手
5分钟入门,即刻开始编辑
1️⃣
创建/登录账号

使用B站账号直接登录BWIKI,无需额外注册。登录后即可编辑页面、上传图片、参与讨论。

💡 提示:建议完善个人资料,方便其他编辑者联系你

2️⃣
找到编辑入口

进入任意页面,点击右上角的「编辑」按钮。首次编辑建议从简单的文字修改开始。

🔰 新手建议:先尝试修改错别字或补充简单信息

3️⃣
使用可视化编辑器

BWIKI提供可视化编辑模式,像编辑Word文档一样简单。支持粗体、斜体、标题、列表等常用格式。

📝 进阶:熟悉后可切换到源码模式,功能更强大

4️⃣
预览并保存

编辑完成后,点击「显示预览」查看效果。确认无误后填写编辑摘要,点击「保存页面」。

✅ 好习惯:编辑摘要写清楚修改内容,方便他人查看历史

✅ 新手任务清单(完成即可获得编辑者称号)
完成个人资料设置
完成第一次编辑(修改错别字)
上传第一张图片
创建一个简单页面
使用一个模板
在讨论页留言
🏠
BWIKI基础
了解平台,事半功倍
📚 什么是Wiki?

Wiki是一种协作式网站,允许多个用户共同创建和编辑内容。其核心特点包括:

  • 开放编辑:任何注册用户都可以编辑页面
  • 版本控制:自动保存历史版本,可随时回退
  • 协作共建:多人协作,集思广益
  • 快速链接:使用页面名快速创建内链
🎮 什么是BWIKI?

BWIKI是哔哩哔哩游戏推出的游戏Wiki平台,专为游戏玩家打造:

  • B站账号:直接使用B站账号登录
  • 游戏专注:专为游戏攻略、资料设计
  • 社区氛围:与B站生态深度融合
  • 模板丰富:提供游戏专用模板
⚙️ 核心功能
  • 页面编辑:创建和编辑Wiki页面
  • 文件上传:上传图片、视频等媒体
  • 模板系统:复用代码,统一风格
  • 分类管理:组织页面结构
  • 讨论功能:页面讨论和评论
  • 版本历史:查看和恢复旧版本
👤 用户权限
角色 权限
访客 浏览页面
注册用户 编辑页面、上传文件
自动确认用户 编辑半保护页面
管理员 删除页面、保护页面、管理用户
📖
学习路径
循序渐进,从入门到精通
阶段 1
入门篇 · 了解Wiki基础
📚 Wiki是什么
了解Wiki的协作理念、版本控制、社区共建模式
🎯 BWIKI平台
熟悉BWIKI的界面布局、功能入口、权限体系
✏️ 第一次编辑
完成账号设置、找到编辑入口、保存修改
⏱️ 预计时间:30分钟 | 🎓 目标:完成首次编辑
阶段 2
基础篇 · 掌握Wiki语法
📝 文本格式
粗体、斜体、标题、列表、链接的基础语法
🖼️ 图片处理
上传图片、调整大小、居中显示、添加链接
📊 表格制作
创建表格、合并单元格、设置样式
🏷️ 分类标签
添加分类、创建分类页、组织内容结构
⏱️ 预计时间:2小时 | 🎓 目标:独立创建简单页面
阶段 3
进阶篇 · 模板与样式
🧩 模板使用
调用现有模板、传递参数、嵌套模板
🎨 CSS样式
内联样式、配色方案、响应式布局
⚡ 魔术字
WIKI编辑教程、18:35等动态内容
🔧 解析函数
条件判断、字符串处理、数学运算
⏱️ 预计时间:4小时 | 🎓 目标:制作复杂页面
阶段 4
精通篇 · 高级技巧
📦 创建模板
设计可复用模板、参数设计、文档编写
📜 JavaScript
添加交互效果、动态内容、特殊功能
🗃️ 数据管理
Cargo数据库、动态查询、数据可视化
👥 社区管理
权限设置、编辑审核、评论管理
⏱️ 预计时间:持续学习 | 🎓 目标:成为核心贡献者
📄 第1部分结束(共4部分)| 接下来:基础语法详解
📝
基础语法详解
Wiki标记语言完全参考
✏️ 文本格式
显示效果 Wiki语法 说明
粗体文字 粗体文字 三个单引号,用于强调重要内容
斜体文字 斜体文字 两个单引号,用于书名、外来语等
粗斜体 粗斜体 五个单引号,粗体+斜体组合
删除线 <s>删除线</s> HTML标签,表示已删除或过时的内容
下划线 <u>下划线</u> HTML标签,用于特别强调
彩色文字 <span style="color:#dc3545;">彩色文字</span> 内联CSS样式,可自定义颜色
文字 <span style="font-size:20px;">大</span> 通过font-size调整文字大小
代码 <code>代码</code> HTML code标签,等宽字体显示
下标 上标 <sub>下标</sub> <sup>上标</sup> 化学式、数学公式使用
📌 标题层级
显示效果 Wiki语法 用途说明
一级标题
= 一级标题 = 页面主标题,一个页面只应有一个
二级标题
== 二级标题 == 大章节标题,主要分区使用
三级标题
=== 三级标题 === 小节标题,章节内细分
四级标题
==== 四级标题 ==== 细分内容,较少使用
五级标题
===== 五级标题 ===== 极少使用,建议用四级即可
六级标题
====== 六级标题 ====== 几乎不使用
💡 提示:标题会自动生成目录,合理使用层级让页面结构清晰。建议层级不超过4级
📋 列表
无序列表
  • 项目一
  • 项目二
    • 子项目A
    • 子项目B
      • 子子项目
  • 项目三
使用星号*,两个星号**表示子项,三个***表示孙项
有序列表
  1. 第一步
  2. 第二步
    1. 子步骤1
    2. 子步骤2
      1. 子子步骤
  3. 第三步
使用井号#,两个井号##表示子步骤
混合列表
  1. 主要步骤
    • 要点A
    • 要点B
  2. 下一步
    • 说明1
    • 说明2
#* 组合使用,有序中包含无序
定义列表
术语
定义解释
另一个术语
另一个定义
分号;表示术语,冒号:表示定义
🔗 链接
类型 Wiki语法 说明
内部链接 角色图鉴 链接到同Wiki的其他页面
带文字链接 查看全部角色 竖线|后自定义显示文字
外部链接 归环官网 方括号内URL+空格+文字
裸链接 https://guihuan.cn 直接写URL会自动识别
HTML链接 <a href="/guihuan/角色图鉴">链接</a> HTML块内使用,更灵活
锚点链接 #快速上手 链接到页面内指定位置
分类链接 分类:角色 冒号开头链接到分类页
跨Wiki链接 bwiki:崩坏:角色 链接到其他BWIKI
邮箱链接 发邮件 点击打开邮件客户端
🖼️ 图片
效果 Wiki语法 说明
基础显示 归环-壁纸-01.jpg 显示原始尺寸图片
指定宽度 归环-壁纸-01.jpg 限制图片宽度为400像素
居中显示
归环-壁纸-01.jpg
center参数使图片居中
点击跳转 归环-壁纸-01.jpg 点击图片跳转到文件页
链接到页面 归环-壁纸-01.jpg 点击图片跳转到指定页面
带标题 这是标题 鼠标悬停显示标题文字
缩略图
描述
thumb生成带边框的缩略图
左/右对齐 / left或right参数控制对齐
无框图 归环-壁纸-01.jpg frameless无边框,适合图标
⚠️ 注意:BWIKI对文件名大小写敏感!.jpg 和 .JPG 是不同的文件
📊 表格
基础表格
表格标题
表头1 表头2 表头3
内容1 内容2 内容3
内容4 内容5 内容6
!表示表头,|表示单元格,|-表示新行
合并单元格
表头1 表头2 表头3
跨两行 内容2 内容3
跨两列
rowspan=跨行数,colspan=跨列数
表格样式
表头
红色文字
使用style属性添加CSS样式
表格类名

wikitable - 基础样式
sortable - 可排序
wikitable sortable - 组合

class可组合使用多个
📄 第2部分结束(共4部分)| 接下来:高级语法与魔术字
🔧
高级语法
魔术字、解析函数、条件判断
⚡ 魔术字(Magic Words)

魔术字是MediaWiki的特殊标记,用于插入动态内容。它们用双花括号包裹,会被系统自动替换为对应的内容。

魔术字 说明
WIKI编辑教程 当前页面名称(不含命名空间)
WIKI编辑教程 完整页面名称(含命名空间)
当前命名空间名称
2026 当前年份(如:2026)
04 当前月份(01-12)
23 当前日期(1-31)
18:35 当前时间(HH:mm格式)
445 当前修订版本ID
3546648124852705 最后编辑者用户名
191 Wiki总页面数
9 Wiki文章页面数
62 Wiki上传文件数
167 Wiki注册用户数
🔧 解析函数(Parser Functions)

解析函数提供编程能力,可以进行条件判断、字符串处理、数学运算等操作。

条件判断 #if

条件为真时显示

根据条件显示不同内容
相等判断 #ifeq

不等时显示

判断两个值是否相等
字符串长度 #len

3

返回字符串长度
字符串截取 #sub

字符串

截取字符串的一部分
替换 #replace

字符串

替换字符串中的内容
数学运算 #expr

7
3.33

支持 + - * / round等运算
时间格式化 #time

2026年04月23日
18:35:04

格式化显示时间
URL编码 #urlencode

{{#urlencode: 中文内容 }}

将内容转为URL编码
📝 注释与转义
HTML注释

<!-- 这是注释,不会显示 -->

用于添加编辑备注
Wiki注释

<!-- 多行
注释内容 -->

支持多行注释
转义显示

<nowiki>不解析</nowiki>
<pre>原格式文本</pre>

nowiki不解析Wiki语法,pre保持原格式
代码块

<syntaxhighlight lang="js">
// JavaScript代码
function test() {}
</syntaxhighlight>

语法高亮代码块
🧩
模板系统
复用组件库,提升编辑效率

什么是模板? 模板是预先设计好的可复用代码块,通过传入不同参数生成不同内容。使用模板可以保持页面风格统一,减少重复工作。

👤
角色信息框

{{角色信息框
|姓名=归还者
|属性=光
|稀有度=SSR
|使灵=初
|简介=时间循环的归还者...
}}

用于角色详情页,展示角色基本信息、属性、使灵等。
使灵卡片

{{使灵卡片
|名称=初
|类型=光
|稀有度=SSR
|技能=时间回溯
}}

用于使灵图鉴页,展示使灵的基础信息和技能。
📖
攻略卡片

{{攻略卡片
|标题=新手入门指南
|分类=新手攻略
|作者=编辑者名字
|日期=2026-04-08
|摘要=本攻略面向刚入坑的玩家...
}}

用于攻略列表页,展示攻略文章的摘要信息。
💡
提示框

{{提示框
|类型=info
|标题=提示
|内容=这是一条提示信息...
}}

类型可选:info/success/warning/error

用于页面中的提示、警告、成功等提示信息。
📂
折叠面板

{{折叠面板
|标题=点击展开查看详情
|内容=这里是折叠的内容...
|默认状态=折叠
}}

用于隐藏长内容,保持页面整洁。
🍞
面包屑

{{面包屑
|首页=首页
|分类1=攻略
|分类2=新手攻略
|当前=入门指南
}}

用于页面顶部,显示当前页面的导航路径。
✨ 创建自己的模板

当现有模板无法满足需求时,可以创建新模板:

1
创建新页面,名称格式为 模板:模板名称
2
在模板中使用 默认值 定义可配置参数
3
添加模板文档,说明参数用途和使用示例
4
在其他页面使用 模板:模板名称 调用
🎨
样式设计
CSS与页面美化
🎨 CSS基础

BWIKI支持内联CSS样式,通过 style="..." 属性添加样式。

文字样式

color: #ff0000;
font-size: 16px;
font-weight: bold;
font-family: '微软雅黑';
text-align: center;
line-height: 1.5;

颜色、大小、粗细、字体、对齐、行高
盒模型

width: 100%;
height: 200px;
padding: 20px;
margin: 10px;
border: 1px solid #ccc;
border-radius: 8px;

宽高、内边距、外边距、边框、圆角
背景样式

background: #f0f0f0;
background: linear-gradient(...);
background-image: url(...);
background-size: cover;
background-position: center;

背景色、渐变、图片、尺寸、位置
布局样式

display: flex;
flex-direction: row;
justify-content: center;
align-items: center;
gap: 10px;
flex-wrap: wrap;

Flex布局常用属性
🌈 常用配色参考
主色 #1a1a1a
次级 #495057
辅助 #6c757d
边框 #adb5bd
浅色 #dee2e6
背景 #f8f9fa
危险 #dc3545
成功 #28a745
警告 #ffc107
信息 #17a2b8
📱 响应式设计

使用CSS媒体查询,让页面在不同设备上都能良好显示。BWIKI中可通过JavaScript检测窗口大小来切换样式。

常用断点参考
手机竖屏
小于 576px
手机横屏
576px - 768px
平板
768px - 992px
桌面
大于 992px
📄 第3部分结束(共4部分)| 接下来:图片媒体、最佳实践、常见问题
🖼️
图片与媒体
上传、管理、优化
📤 上传指南
1. 找到上传入口

• 左侧菜单「工具」→「上传文件」
• 编辑页面时点击「上传」按钮
• 直接访问 特殊:上传 页面

2. 选择文件

• 支持格式:JPG、PNG、GIF、SVG、WEBP
• 单个文件大小限制:通常为10MB
• 建议提前压缩优化图片

3. 填写信息

• 目标文件名:建议使用英文或拼音
• 文件描述:说明图片内容
• 授权协议:选择合适的版权协议

4. 完成上传

• 点击「上传文件」按钮
• 等待上传完成
• 复制文件名用于页面引用

⚡ 图片优化建议
格式选择

照片/复杂图像:使用 JPG
图标/透明背景:使用 PNG
动画:使用 GIF
矢量图形:使用 SVG
现代浏览器:优先使用 WEBP

尺寸建议

头像/图标:100×100px
缩略图:200-400px
内容图片:600-800px
横幅/Banner:1200-1920px
全屏背景:1920px以上

压缩工具推荐

TinyPNG:tinypng.com
Squoosh:squoosh.app
ImageOptim:Mac专用
PS/在线工具:导出时选择「存储为Web所用格式」

命名规范

✅ 归环-角色名-立绘.jpg
✅ guihuan-character-art.png
❌ IMG_20240101.jpg
❌ 截图2024.png
❌ 未命名-1.jpg

🎬 其他媒体类型
视频嵌入

B站视频:
文件:Bilibili视频封面.jpg

或使用iframe(需管理员权限)

通常使用封面图+链接方式
音频文件

文件:背景音乐.mp3

或使用HTML5: <audio controls>

 <source src="...">

</audio>

支持MP3、OGG等格式
PDF文档

文件:攻略手册.pdf

点击下载或在线预览

适合上传攻略文档
SVG矢量图

文件:图标.svg

SVG可无损缩放,适合图标

推荐使用SVG作为图标
最佳实践
编辑规范与技巧
📋 编辑规范
✅ 应该做的

• 填写清晰的编辑摘要
• 使用合适的标题层级
• 为图片添加描述文字
• 给页面添加分类
• 保持代码格式整洁
• 预览后再保存
• 参考现有优秀页面

❌ 不应该做的

• 直接复制其他网站内容
• 上传版权不明的图片
• 使用过大尺寸的图片
• 在页面中泄露个人隐私
• 添加未经证实的信息
• 恶意破坏他人编辑
• 创建无意义的页面

📝 编辑摘要规范

新增:+ 新增角色介绍
修改:~ 修正数据错误
删除:- 移除过时信息
格式:* 调整排版格式
图片>:📷 添加角色立绘
模板:🧩 更新信息框模板

🏷️ 分类规范

• 每个页面至少添加一个分类
• 使用标准分类名称
• 分类层级不宜过深
• 避免重复分类
• 新建分类前先检查是否已存在

🏗️ 页面结构建议

📄 角色页面结构示例:

= 角色名 =

首页 > ... > WIKI编辑教程

模板:角色信息框

== 简介 ==
角色背景故事...

== 基础信息 ==

...


== 技能介绍 ==
=== 普通攻击 ===
...

=== 必杀技 ===
...

== 相关攻略 ==

🤝 协作礼仪
尊重他人编辑

• 不要无故删除他人内容
• 修改前先查看编辑历史
• 有争议时在讨论页沟通
• 不要进行编辑战

有效沟通

• 编辑摘要写清楚原因
• 复杂修改先在讨论页说明
• 回复他人时保持礼貌
• 接受建设性批评

版本控制

• 大改动分多次小提交
• 每次提交聚焦一个主题
• 保留有价值的编辑历史
• 善用撤销功能

新人友好

• 帮助解答新手问题
• 不要嘲笑错误
• 提供具体的改进建议
• 分享你的经验

常见问题
排错指南,解决编辑中的疑难杂症
Q1: 图片上传后页面不显示?

A: 检查以下几点:
• 文件名大小写是否完全匹配(.jpg.JPG 是不同的)
• 确认使用 文件:文件名 语法
• 检查文件是否成功上传(访问 特殊:文件列表 查看)
• 清除浏览器缓存或强制刷新(Ctrl+F5)

Q2: 页面布局错乱,样式不生效?

A: MediaWiki会自动将HTML块内的空行转为 <p> 标签,导致布局问题:
• 确保flex/grid容器的直接子元素写在同一行,不要有空行分隔
• 使用 <div> 包裹内容,避免自动添加段落标签
• 检查CSS语法是否正确,特别是分号和引号
• 复杂布局建议在沙盒页面先测试

Q3: 链接点击后404或跳转错误?

A: 不同场景使用不同的链接语法:
• 在HTML块内:使用 <a href="/guihuan/页面名"> 格式
• 在Wiki语法区:使用 页面名 格式
• 避免在HTML内使用 页面名 语法
• 检查页面名是否包含特殊字符,需要URL编码

Q4: 模板调用后显示红色错误?

A: 红色通常表示模板不存在或参数错误:
• 检查模板名称是否拼写正确
• 确认模板已创建(访问 模板:模板名 查看)
• 检查参数名是否与模板定义一致
• 查看模板文档了解正确的使用方法

Q5: 编辑后页面没有更新?

A: 尝试以下方法:
• 强制刷新页面(Ctrl+F5 或 Cmd+Shift+R)
• 清除浏览器缓存
• 在URL后添加 ?action=purge 清除服务器缓存
• 等待几分钟,BWIKI可能有CDN缓存延迟

Q6: 如何撤销错误的编辑?

A: 有多种方式可以恢复:
• 点击「编辑」→ 修改回正确内容 → 保存
• 点击「查看历史」→ 找到正确的旧版本 → 点击「撤销」
• 点击「查看历史」→ 找到正确的旧版本 → 点击「编辑」→ 保存(恢复该版本)
• 联系管理员协助恢复

Q7: 如何创建新页面?

A: 多种方式创建新页面:
• 在搜索框输入页面名,点击「创建页面」
• 在现有页面添加 新页面名 链接,点击红色链接创建
• 直接访问 /guihuan/新页面名?action=edit
• 使用「工具」→「创建页面」

Q8: 编辑时提示"编辑冲突"?

A: 编辑冲突表示在你编辑期间,其他人已保存了修改:
• 仔细对比两个版本的内容
• 手动合并双方的修改
• 保留双方的有价值内容
• 保存前再次预览确认

📎
资源附录
速查手册与外部资源
📋 语法速查表
文本格式

粗体
斜体
粗斜体
<s>删除线</s>
<u>下划线</u>

标题

= 一级 =
== 二级 ==
=== 三级 ===

四级

列表
  • 无序
    • 子项
  1. 有序
    1. 子项
定义
解释
其他

<!-- 注释 -->
<nowiki>不解析</nowiki>
<pre>原格式</pre>

🌐 外部资源
📚 官方文档
🛠️ 工具网站

• 表格生成器:tablesgenerator.com
• 颜色选择器:colorpicker.me
• CSS渐变:cssgradient.io
• 图片压缩:tinypng.com

🎨 设计资源

• MDN Web文档:developer.mozilla.org
• CSS参考:cssreference.io
• HTML参考:htmlreference.io
• 图标库:fontawesome.com

🎮 参考WIKI

• 崩坏:星穹铁道WIKI
• 原神WIKI
• 明日方舟WIKI
• 绝区零WIKI

📝 教程更新日志
v2.0 - 超级详细版
2026-04-08

• 全面重写,内容扩充3倍
• 新增BWIKI基础介绍、高级语法详解
• 新增样式设计、图片媒体章节
• 新增最佳实践、协作礼仪
• FAQ从6条扩展到8条
• 新增资源附录和速查表

v1.0 - 白色版
2026-04-08

• 初始版本发布
• 白色主题设计
• 包含基础语法、模板、工具、FAQ

👥 加入归环BWIKI社区
与其他编辑者交流,共同完善WIKI
💬
讨论页
在每个页面底部参与讨论
📢
公告栏
关注WIKI最新动态
🏆
贡献榜
查看活跃贡献者
🎯
待办事项
查看需要完善的页面
📚
沙盒
测试和练习编辑
归环BWIKI · 共建共享 · 持续更新
踏上取经路,比抵达灵山更重要
最后更新:2026年4月8日 | 版本:v2.0 | 超级详细版
📄 共4部分
🎨 白色主题
📖 完全教程
🎉 恭喜完成全部4部分教程!
现在你已经掌握了归环BWIKI编辑的全部知识