Paket-Baukasten

Was der Baukasten für Sie entscheidet und was nicht

Er entscheidet	Er entscheidet nicht
Welche Komponenten Ihre Auswahl zwingend nach sich zieht — auch die Abhängigkeiten der Abhängigkeiten.	Welche Komponenten Sie wollen.
Welche Komponenten eine von Ihnen angekreuzte Funktion braucht.	Welche Funktionen Sie brauchen.
In welcher Reihenfolge installiert wird.	Ob Sie eine Empfehlung annehmen. Optionale Komponenten werden nie ungefragt eingepackt.
Aus welcher Fassung gebaut wird — nach dem gewählten Kanal.	Ob eine Kombination fachlich sinnvoll ist.

Die drei Arten von Abhängigkeit

Die Unterscheidung ist der eigentliche Inhalt dieser Seite, denn an ihr hängt jede praktische Frage.

Zwingend erforderlich. Ohne diese Komponente lädt oder arbeitet die gewählte nicht. Sie kommt immer mit.
Für eine gewählte Funktion erforderlich. Die Komponente darf fehlen, ohne dass etwas kaputtgeht — und ist unumgänglich, sobald jemand genau diese Funktion will. wkdoado ist für wkdoadogit technisch entbehrlich und für „ein Azure-DevOps-Repository verwenden„ unumgänglich. Kreuzen Sie die Funktion an, kommt die Komponente mit; nehmen Sie das Kreuz weg, geht sie wieder.
Optional. Verbessert den Betrieb. Erscheint als Empfehlung mit der Angabe, was sie bringt, und wird nicht eingepackt.

Jede automatisch ergänzte Komponente nennt in der Aufstellung, warum sie dort steht. Eine Zusammenstellung, die man nicht nachvollziehen kann, ist nur eine andere Art von „vertrauen Sie mir“.

Kanal

Kanal	Woraus gebaut wird	Wofür
Stabil	Die Fassung, die jede Komponente in ihrem Manifest festgeschrieben hat.	Die Vorgabe, und das, was öffentliche Besucher bekommen. Das Manifest im Archiv nennt je Komponente die tatsächlich verwendete Revision, sodass derselbe Inhalt erneut herstellbar ist.
Aktuell	Der jeweils neueste Stand jeder Komponente.	Zum Erproben.

Eine Komponente ohne festgeschriebene Fassung wird auf Stabil abgelehnt und namentlich genannt — statt stillschweigend den aktuellen Stand einzupacken und ihn stabil zu nennen.

Was im Archiv liegt

wkl-dokuwiki-bundle-<kennung>.zip
|
+-- lib/plugins/<komponente>/ ...   jede Komponente an ihrem Installationsort
+-- lib/tpl/<template>/ ...
+-- manifest.json                   Inhalt, Begründung je Komponente, verwendete Revision
+-- README.txt                      Inhalt, Ziel, Voraussetzungen, Reihenfolge,
|                                   Erstkonfiguration, Einschränkungen, Funktionsprüfung
+-- checksums.sha256                eine SHA-256-Summe je Datei

Die Installation beschreibt Eine Komponente installieren, Weg C.

Wie lange ein Paket verfügbar ist

Fertige Pakete sind flüchtig. Der Download ist ab dem Erzeugen fünfzehn Minuten gültig; danach antwortet der Endpunkt mit einer Meldung, dass das Paket abgelaufen ist, und Sie stellen es hier neu zusammen. Das Aufräumen läuft alle fünf Minuten.

Das ist kein Sparzwang, sondern die Folge davon, dass ein Paket eine Momentaufnahme ist: Es enthält die Fassungen, die zum Zeitpunkt Ihrer Anfrage festgeschrieben waren. Ein Archiv, das wochenlang unter einem Link liegt, wird irgendwann installiert und ist dann etwas anderes, als die Seite daneben beschreibt.

Warum kein Zugriffstoken nötig ist

Der Browser spricht nie mit der Bauanlage. Er schickt an dieses Wiki eine Auswahl — Komponenten, Funktionen, Kanal — und sonst nichts: kein Repository, keine Revision, keinen Pfad. Alles Übrige leitet der Server aus dem Katalog ab, und die Zugangsdaten zur Bauanlage verlassen ihn nicht.

Deshalb genügt hier ein Klick, wo früher ein persönliches Zugriffstoken und eine REST-Adresse standen.