SuperAPI AI 工具集

redirect-article

写作与研究

查看项目

更新于 10-15 21:12

技能介绍

用途:在 dotnet/docs 仓库中删除一篇 Markdown 文章,同时创建重定向条目,把访问旧地址的用户导向另一篇文章,保证既有链接与书签在内容重组后仍可用。适用场景包括:删除应重定向到其他文章的文章、把多篇文章合并为一篇、重命名或移动文章、移除过时内容但保留 URL 功能。

必要用法:不要手动编辑重定向 JSON 文件,必须使用脚本 ./scripts/create-redirect-entry.ps1 自动添加条目,它会按字母顺序插入并处理格式。步骤:先用 Remove-Item 删除源文章;再用该脚本创建重定向条目;最后在仓库中搜索引用旧文章的 **/.md 与 **/.yml 文件,并把链接更新为新文章。脚本参数:RedirectionFile(必填,重定向 JSON 文件名,如 .openpublishing.redirection.csharp.json)、SourcePath(必填,被删文章的仓库路径)、RedirectUrl(必填,目标 URL);示例:.\scripts\create-redirect-entry.ps1 -RedirectionFile ".openpublishing.redirection.csharp.json" -SourcePath "docs/csharp/fundamentals/old-article.md" -RedirectUrl "/dotnet/csharp/fundamentals/new-article"。

重定向文件选择:先在 .openpublishing.redirection.*.json 中搜索与源文章路径相似的既有条目,选择路径前缀最长匹配的文件;若没有匹配,按内容领域参考表选择,如 AI、Architecture、Aspire、Azure、.NET Core、C#、Desktop WPF、.NET Framework、F#、.NET Fundamentals、Machine Learning、Navigate、Orleans、.NET Standard、Visual Basic,默认使用 .openpublishing.redirection.json。

条目格式:source_path_from_root 为从仓库根开始的路径、以 / 开头(首选属性),source_path 为无前导 / 的旧属性;redirect_url 为以 /dotnet/ 开头的 URL 路径。注意:条目按路径字母顺序排序;redirect_url 不含文件扩展名或域名;脚本读取时兼容两种路径属性,写入时始终使用 source_path_from_root。