Quellen
Was aus `duxt.sources` geworden ist — eine Collection je Quelle, Version und Sprache.
Das erste Panel, das du öffnest, denn alles andere im Tab hängt davon ab. Eine Zeile je aufgelöster Quelle: was ein Konsument als eine Handvoll Einträge geschrieben hat, aufgefaltet in die Collections, die Content tatsächlich erzeugt hat, und das URL-Präfix, unter dem jede einzelne ausgeliefert wird.
Spalten
| Spalte | Was sie sagt |
|---|---|
Prefix | Das URL-Segment, unter dem diese Collection ausgeliefert wird; / für die präfixlose |
Collection | Der erzeugte Collection-Name, so wie queryCollection ihn nimmt, bei einer generierten Sektion mit ihrem Typ ausgezeichnet |
Repository | Woher die Seiten kommen, verlinkt, sofern bekannt |
Folder / artefact | Der path innerhalb dieses Repositories — ein Docs-Ordner, oder das Artefakt, aus dem eine Sektion gebaut wurde |
Ref | Der Branch oder Tag, und welches von beidem er ist |
Version | Der Slug in der URL, default, wenn sie ohne Segment ausgeliefert wird |
Status | current, deprecated oder eol, direkt aus der Quelle |
Reserved segments | Ordnernamen innerhalb dieser Quelle, die ein Präfix bereits belegt hat |
Anmerkungen
Ein Repository-Segment erscheint nur, wenn es mehr als ein Repository gibt,
und ein Versionssegment nur, wenn es mehr als einen Ref gibt — ein Segment, das
nur einen Wert annehmen kann, unterscheidet nichts. sourceOptions.showRepo und
showVersion schalten sie wieder ein.
Reservierte Segmente sind die Falle, für die es diese Spalte gibt. Wird eine
Quelle unter /sdk ausgeliefert und enthält ihr Docs-Ordner ein Verzeichnis
v1-9/, gewinnt das Präfix und dieser Ordner ist unerreichbar. Das Panel
Prüfungen meldet das als Fehler; diese Spalte
zeigt, welche Namen belegt sind, bevor es passiert.
Eine generierte Sektion ist eine Collection wie jede andere, und genau das
lässt den Rest der Ebene unverändert auf ihr arbeiten — und machte sie hier
ununterscheidbar von einem Docs-Baum, dessen Ordner zufällig CHANGELOG.md hieß.
Die Auszeichnung neben dem Collection-Namen ist ihr Typ, changelog- und
openapi-Zeilen lesen sich also als das, was sie sind, und die Zusammenfassung
zählt sie mit. Was das Artefakt selbst zu sagen hatte, ist ein Befund und keine
Spalte und wird im Panel Prüfungen gemeldet.
Die Fußzeile nennt die Datei, aus der die Liste gelesen wurde — nützlich auf
einer Seite, auf der app.config.ts nicht dort liegt, wo du es erwartet hast.