用途:在 Coolify 文档中停用某项服务,使其不再出现在服务列表页,同时保留文档页面供搜索引擎、书签和直接 URL 访问。
主要能力与步骤:
- 在 docs/.vitepress/theme/components/Services/List.vue 的服务条目中添加 disabled: true,隐藏列表展示但保留直接 URL 访问。
- 在对应 markdown 文件(docs/services/service-name.md)顶部添加警告提示块,如 ::: warning SERVICE NOT AVAILABLE。
- 可选添加上下文,如被替代、暂时不可用或移除原因。
- 保留 nginx/redirects.conf 中指向该服务的重定向。
- 从 docs/services/all.md 的对应分类中移除该服务条目。
适用场景:服务在 Coolify 中被弃用、暂时不可用、从服务目录移除或被其他服务替代。
限制与注意:不要删除文档文件,以保留 SEO、书签支持和历史参考;重新启用时需移除 disabled: true 和警告提示块。
验证清单:确认 List.vue 已加 disabled: true、markdown 已加警告、all.md 已移除条目、文档文件仍存在、列表页与 all 页不再显示该服务、直接 URL 仍可访问且页面顶部显示警告。
相关技能:adding-service-documentation、renaming-services。