Migration to VitePress

[Meo597]

旧版的问题：

• CI 挂了
• mermaid 有问题
• 语言切换一次后有问题得刷新才正常
• 不支持模糊全文搜索相当于残废
• yarn npm pnpm 大乱斗
• 菜单太乱了，本页菜单放右边，并且有更多深度的话会更清晰
• 图片不能放大

迁移到 VitePress

[Meo597]

样式还需要调整
CI 和 lint 没弄

[Meo597]

[Fangliding]

CI好像还直接被扬了没有写新的 压根没开始编译
测试这一块

[Fangliding]

说到CI 之前有一次好像被改成定死页面到 xtls.github.io 了 我不太喜欢那个改动 因为旧版可以在自己的fork上自行depoly到的github page 这样pr也可以测试CI观察部署情况

[Meo597]

是的 CI 和 lint 我没有做
现在既然接受了，我会在这几天补上

之前没弄主要是懒得自己仓库搭建 CI 还得弄 Token 啥的麻烦

在这个 PR 之前，CI 就莫名坏了

[Fangliding]

以前还有本地分支推送的时候是不用的（action不需要token推到本仓库）

还有上面说的contributor的那个

[Meo597]

是的以前在一个仓库就不需要 token
现在跨库必须，我就是因为这个没折腾 ci 的

我晚上写 ci 脚本试试看能不能自适应
如果不行的话我改成在这个仓库发布页面？还是保持分库？

构建者这个我想的是显示的详细点提高大家编辑文档的积极性，等弄好你看看效果不行再改

[Fangliding]

我见过的绝大多数协作式文档或者各种wiki站全都是只在小地方显示个名字或者头像就好了 wikipedia甚至还没有 而且一堆github默认noreply邮箱很难绷

[Meo597]

没问题，这些小细节的东西很好改

我现在手机不方便
人在缅甸见几个掏心掏肺的朋友
今天晚点弄

[Fangliding]

至于之前push本仓库分支被删掉是因为编译结果太大又被git完全保留导致clone很慢 可以考虑fp一个只有一条历史的分支上去 不知道action有没有这个权限

[Meo597]

摸鱼的时候先把 CI 弄上了
目前已经可以正常编辑文档并部署了

上面提到的贡献者、合到一个库
或者其它要改进的地方可以在这里留言
我这几天抽空一起弄

[iambabyninja]

@Meo597 Good afternoon, my dear friend! Could we please avoid ignoring the Russian language in
140e721?

[Meo597]

Could we please avoid ignoring the Russian language in

如果你可以保证俄语最新，我很乐意调整它，但其实没有太大必要。因为这些是给 llm 理解的
它们会自动翻译，并始终用俄语输出给用户

[Meo597]

@iambabyninja 对了，一些俄语的菜单文本、提示文本等，我都是用 AI 翻译的，如有需要请随意调整
它们大多在 .vitepress 目录中

[RPRX]

新的文档挺好看的，辛苦了已 star，大史记没人更新了用捐款赞助替换吧

[Meo597]

好的

[Meo597]

现在编译时不允许忽略死链接警告，如果有则 ci 失败并报错
当下 65 个死链接已经全部替换了

f875f52

[Meo597]

翻译页缺失提示跳转到默认语言功能之前无效，因为 vitepress 404 路由优先级高于 theme
在脚本扫描缺失翻译页的时候自动创建空白 md 可解决此问题
反正是在 ci 环境新建，这样修起来最省事

531a851

[Meo597]

搜索改为默认显示详细视图

因为用户大多搜索配置字段名或值
然而字段名没用 # 光看搜索结果根本不知道是啥

现在会有更好的用户体验

e9579e8

[Meo597]

页面底部贡献者优先显示 GitHub 用户名而非邮箱

b03313d

[Meo597]

说到CI 之前有一次好像被改成定死页面到 xtls.github.io 了 我不太喜欢那个改动 因为旧版可以在自己的fork上自行depoly到的github page 这样pr也可以测试CI观察部署情况

预览的话其实这样挺方便，连 F5 都不用按：

pnpm install
pnpm run docs:dev

---

至于之前push本仓库分支被删掉是因为编译结果太大又被git完全保留导致clone很慢 可以考虑fp一个只有一条历史的分支上去 不知道action有没有这个权限

完事了，现在只有一条历史记录
83fb6d4

---

现在怎么说，删掉 XTLS/XTLS.github.io 这个库改到这里弄个分支发布 pages 吗？
@yuhan6665 @Fangliding

[RPRX]

GitHub 的机制不是一直都是只能 push 到 XTLS/XTLS.github.io 这个库吗

[Meo597]

GitHub 的机制不是一直都是只能 push 到 XTLS/XTLS.github.io 这个库吗

ci 里 external_repository: XTLS/XTLS.github.io
然后 https://github.com/XTLS/XTLS.github.io/settings/pages 里发布，域名是 组织/账户名，也可以绑定自己的域名

话说你要不要买个域名绑上去？

[RPRX]

域名这种东西迟早不续费的，可能十年二十年之后，所以不买域名

[RPRX]

我的意思是 GitHub 貌似只认 XTLS/XTLS.github.io 这个库的 pages 作为 xtls.github.io 的内容，个人的也是一样

[Meo597]

GitHub 貌似只认 XTLS/XTLS.github.io 这个库的 pages 作为 xtls.github.io 的内容

那就不晓得了没用过，他们想的话也可以把这个 repo 迁移到 XTLS.github.io 这个库
现在 pages 分支没有历史体积小了

不过我觉得想本地预览的话，pnpm run docs:dev 挺好使的，没必要迁移库

[RPRX]

都这么久了就不迁移了吧

[Meo597]

彻底完事了

[Meo597]

@patterniha @iambabyninja
Because we always do batch global replacements of some content, the outdated flags are inaccurate. Anyway, I've now batch updated all the English documents, just before my Gemini subscription expires.

[patterniha]

I will translate the 2 fragment fields.

#783 (comment)

@Fangliding ...

[Fangliding]

他们说以后这个功能可能移到final mask 我就暂时搁置了