用途:对 Open Publishing 重定向 JSON 文件中的重定向条目按路径进行字母顺序排序,保证文件整齐一致、便于维护。适用于新增重定向条目后、重定向文件变得无序时,或合并分支后可能产生乱序条目的情况。
主要能力:脚本 sort-redirects.ps1 按路径(忽略 source_path_from_root 的前导 /)对 JSON 文件中所有条目做字母顺序排序,并同时处理 source_path_from_root 与 source_path 两种属性。脚本保留所有现有重定向条目,仅改变条目顺序。排序区分大小写,按规范化后的路径(不含前导 /)进行。
使用方式:先确定需要排序的 .openpublishing.redirection.*.json 文件,再运行排序脚本并传入文件路径。脚本位置相对本技能文件为 ./scripts/sort-redirects.ps1。参数 RedirectionFile 为必填,指重定向 JSON 文件的路径,例如 .openpublishing.redirection.csharp.json。示例命令:.\scripts\sort-redirects.ps1 -RedirectionFile ".openpublishing.redirection.csharp.json"。
限制:资料未提供脚本运行的其它前置条件、依赖环境、错误处理或回滚方式,这些内容暂未提供。