目前，我们镜像站目前缺失一些文档，除此以外，后期随着我们同步的镜像源增多、 镜像源不断更新，我们需要花费大量的时间来维护文档。 我们希望将我们站点一些不热门的镜像源集成MirrorZ的文档，以便更好地为用户提供服务。
集成以后，我们希望使用MirrorZ更多、更新更频繁的文档来帮助用户更好地使用我们的镜像站。
集成方法
根据MirrorZ的Readme，我们可以使用下面几种方式集成MirrorZ的文档：
- link in the mirror frontend e.g. ISCAS, SJTUG and SDU
- link in the mirror help e.g. NWAFU
- Fork/Rebase and Transpile mdx to local markdown e.g. TUNA/BFSU
- Self-host e.g. xtom.help
- Reverse proxy e.g. NJU
我们考虑到了以下几点：
- 我们希望用户在浏览我们的镜像站时，可以直接访问到MirrorZ的文档，而不需要跳转到其他站点。
- 我们希望用户在阅读MirrorZ的文档时，可以获得和我们维护的文档相似的体验。
- 我们希望对MirrorZ的文档进行一些定制化的修改，比如修改超链接的地址，以适应我们的站点。
综合以上需求，我们决定使用第三种方式集成MirrorZ的文档。
方案
我们编写的脚本将使用以下步骤来集成MirrorZ的文档：
- 下载MirrorZ的文档
- 将MirrorZ的文档转换为我们站点的格式
- 替换超链接的地址
- 替换markdown前言部分的元数据
- 增加来源提示，以及原文链接
除此以外，我们还需要编写更新脚本辅助后期和上游文档的同步。
实现
我们实现了两个脚本，一个用于下载并生成MirrorZ的文档，一个用于更新MirrorZ的文档。
具体实现可以参考站点目录的scripts目录。使用方法可以参考Readme。
后期我们会考虑使用类似于Github Actions的工具来自动化更新过程，让文档定期更新，保持和上游的同步。