如何设置自动重定向到 BreezeWiki?

BreezeWiki 文档列出了几种把 Fandom 页面自动跳转到 BreezeWiki 的方式:浏览器扩展 Indie Wiki Buddy、Redirector、Violentmonkey、LibRedirect,以及 Apple iPhone 上的重定向方法。选择哪一种取决于你用的浏览器、是否愿意装扩展、以及是否希望只对特定站点生效。下面按方式说明各自的做法和适用条件。

先确认你要跳转到哪里

自动重定向的目标是 BreezeWiki 实例。文档在 Links 一节中区分了三类入口:

  • Official:官方站点
  • Mirrors:镜像站点
  • Onion Mirrors:Tor 洋葱服务镜像

配置重定向规则时,需要把目标指向其中一个可用实例。如果你所在网络访问官方站点不稳定,可以改用镜像;对匿名性有要求时再考虑洋葱镜像(需要配合 Tor 浏览器)。

方式一:Indie Wiki Buddy(浏览器扩展)

文档把 Indie Wiki Buddy 列为自动重定向的第一种方式。它面向的是「独立 wiki 优先」的场景:当某个 Fandom wiki 存在对应的独立版本时,扩展会把你导向独立站点,BreezeWiki 属于这类目标之一。

适用条件:你希望安装一个扩展后自动处理,而不是自己写规则。适合不想维护规则列表的普通用户。

方式二:Redirector(浏览器扩展)

Redirector 通过自定义规则实现跳转,你需要自己指定「从哪个域名跳到哪里」。

适用条件:你想精确控制哪些 Fandom 域名被重定向、跳到哪个 BreezeWiki 实例。适合只需要处理少数几个 wiki 的情况。

配置时的关键点是:源地址匹配 Fandom 的域名模式,目标地址填你选定的 BreezeWiki 实例地址。

方式三:Violentmonkey(用户脚本管理器)

Violentmonkey 用来运行用户脚本。文档把它列为一种重定向途径,意味着你需要加载一段脚本,由脚本在页面加载时执行跳转。

适用条件:你已经在用 Violentmonkey 管理其他脚本,或者更习惯用脚本方式而不是扩展内置规则。

方式四:LibRedirect(浏览器扩展)

LibRedirect 的定位是把主流平台的链接重定向到注重隐私的替代前端。BreezeWiki 作为 Fandom 的替代前端,被纳入它的重定向目标之一。

适用条件:你已经在用 LibRedirect 处理其他服务(如 YouTube、Reddit 等)的重定向,希望把 Fandom 也一并交给它统一管理。

Apple iPhone 上的重定向

文档单独列出了 Apple iPhone redirect 一节。这说明在 iOS 上无法像桌面浏览器那样安装上述扩展,需要走另一套方法(例如借助支持脚本或规则的系统级工具)。如果你主要在 iPhone 上浏览,应优先看这一节,而不是照搬桌面扩展的做法。

几种方式的对比

方式 形态 适合谁 需要自己写规则
Indie Wiki Buddy 浏览器扩展 想装完即用、不维护规则 否
Redirector 浏览器扩展 想精确控制跳转范围 是
Violentmonkey 用户脚本管理器 已用脚本管理器的用户 是(加载脚本)
LibRedirect 浏览器扩展 已用它统一管理多站点重定向 否(在扩展内启用)
Apple iPhone redirect 系统/应用层方法 iOS 用户 视方法而定

遇到问题怎么反馈

文档设有 Reporting Bugs 一节,并区分了「Actually sending a report」和「Other communication channels」两部分。也就是说,提交问题时需要按文档说明的渠道发送,而不是随便找个入口留言。如果你在配置重定向时发现某个实例不可用或跳转异常,可以按这一节的指引反馈。

自己运行一个实例

如果现成实例都不满足需求,文档的 Running 一节覆盖了多种运行方式:

  • 运行编译好的可执行文件
  • 从源代码运行
  • 更新源代码
  • 用 Docker 运行
  • 资源占用说明

其中还包含「What next?」的后续指引。运行自己的实例后,重定向规则里的目标地址就改成你自己的地址。

配置项在哪里查

自建实例需要配置。文档的 Configuration 一节分为:

  • Required options:必填项
  • Detailed Options:详细选项
  • File:配置文件方式,含 Example 和 Format
  • Environment variables:环境变量方式,含 Example

也就是说,配置既可以通过文件,也可以通过环境变量,两种方式文档都给了示例。必填项没配好,实例无法正常启动。

想改代码或参与开发

Developing BreezeWiki 一节面向开发者,内容包括:

  • Racket(项目使用的语言)
  • Files(文件结构)
  • Fandom endpoints(Fandom 接口)
  • HTML tree transformations(HTML 树变换)
  • Programming
  • Testing

如果你只是想用重定向,这部分可以跳过;如果你要修 bug 或改行为,从这里入手。

docs.breezewiki.com