Partager via


Trier les redirections

Nom de l’extension

La méta-extension Learn Authoring Pack, Visual Studio Code est composée de plusieurs sous-extensions. Cette fonctionnalité est incluse dans l’extension Learn Markdown . L’extension Learn Markdown fait partie du Pack de création Learn. Il n’est pas nécessaire de l’installer séparément.

Résumé

Avec l’évolution d’un docset, certains fichiers Markdown seront finalement supprimés. Quand un fichier Markdown est supprimé, nous devons fournir une redirection afin que toute référence à l’article supprimé soit correctement résolue par la redirection. Les redirections sont spécifiées dans le fichier .openpublishing.redirection.json.

  1. Ouvrez la palette de commandes, puis appuyez sur F1 (ou ⇧⌘P sur macOS).
  2. Type : Learn : Trier main fichier de redirection
  3. Sélectionnez la commande pour l’exécuter.
  4. Observez les changements apportés au fichier .openpublishing.redirection.json.

Considérations

Le concept de « chaînage » est lié à la conception initiale du fichier .openpublishing.redirection.json. Au fil du temps, les fichiers ajoutés en tant que redirection finissent par devenir obsolètes. Cela se produit quand le fichier A est supprimé et nécessite une redirection vers le fichier B, puis que le fichier B est supprimé, puis redirigé vers le fichier C. Idéalement, les deux entrées pointent vers C, afin que A soit redirigé vers C et que B reste le même. Il s’agit d’un gain de performances mineur alors que vous passez beaucoup de temps sur la fonctionnalité.

En action

Vous trouverez ci-dessous une brève démonstration de cette fonctionnalité.

Démo de tri de redirections