Aller au contenu
duxt

ProseA

Un lien, résolu selon la source dans laquelle il a été écrit.

Chaque lien d’une page Markdown passe par ce composant.

Ce qu’il ajoute

Un chemin de documentation est réécrit pour porter le préfixe de la source d’où vient la page, plus la locale du lecteur. Une URL externe est laissée telle quelle et reçoit le nouvel onglet et la flèche.

Pourquoi

Markdown n’a aucune idée qu’il est servi sous un préfixe. /getting-started écrit dans le docs/ de ce dépôt est correct sur un site à une seule source et un 404 sur un site à deux, où la même page vit sur /duxt/getting-started — et l’auteur du Markdown, qui peut être un tout autre dépôt, ne peut pas savoir lequel des deux.

Pire, le même fichier est servi sous plusieurs préfixes à la fois dès qu’il est publié en plus d’une version : un lien ne peut pas être réécrit à la compilation, car il n’y a pas de réponse juste unique. Il est résolu à chaque rendu, selon la source depuis laquelle la page est lue — ainsi un lien à l’intérieur de v0.7.0 garde le lecteur dans v0.7.0.

API

Props

PropTypeRemarques
hrefstringTel qu’écrit dans le Markdown
targetstringDéfini pour un lien externe
Cette page vous a-t-elle été utile ?