Sources
Ce que `duxt.sources` est devenu — une collection par source, version et langue.
Le premier panneau qu’on ouvre, car tout le reste de l’onglet en découle. Une ligne par source résolue : ce qu’un consommateur a écrit en une poignée d’entrées, déplié en collections que Content a réellement générées, et le préfixe d’URL que chacune sert.
Colonnes
| Colonne | Ce qu’elle dit |
|---|---|
Prefix | Le segment d’URL de cette collection ; / pour celle sans préfixe |
Collection | Le nom de collection généré, tel que queryCollection le prend, étiqueté de son type lorsqu’il s’agit d’une section générée |
Repository | D’où viennent les pages, en lien dès qu’il est connu |
Folder / artefact | Le path dans ce dépôt — un dossier de documentation, ou l’artefact d’où une section a été construite |
Ref | La branche ou le tag — et lequel des deux |
Version | Le slug dans l’URL, default pour celle servie sans segment |
Status | current, deprecated ou eol, directement depuis la source |
Reserved segments | Noms de dossier de cette source qu’un préfixe a déjà réservés |
Notes
Un segment de dépôt n’apparaît qu’à partir du deuxième dépôt, un segment de
version qu’à partir de la deuxième ref — un segment qui ne peut prendre qu’une
valeur ne distingue rien. sourceOptions.showRepo et showVersion les imposent
malgré tout.
Les segments réservés sont le piège pour lequel cette colonne existe. Si une
source est servie sous /sdk et que son dossier de documentation contient un
répertoire v1-9/, le préfixe gagne et ce dossier est injoignable. Le panneau
Checks le signale comme une erreur ; cette colonne
montre quels noms sont pris avant que cela arrive.
Une section générée est une collection comme une autre, ce qui permet au
reste de la couche de fonctionner dessus sans rien changer — et ce qui la rendait
ici indiscernable d’un arbre de documentation dont le dossier se serait appelé
CHANGELOG.md. L’étiquette à côté du nom de collection est son type : les lignes
changelog et openapi se lisent donc pour ce qu’elles sont, et le résumé les
compte. Ce que l’artefact lui-même avait à dire est un constat plutôt qu’une
colonne, signalé sur le panneau Checks.
Le pied de page nomme le fichier d’où la liste a été lue — utile sur un site dont
l’app.config.ts n’est pas là où vous l’attendiez.