Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

In Aggrega importieren

Was ein Import liest und schreibt und welche Formate er liest, ist unter Import beschrieben; diese Seite behandelt, wie Sie einen Import aus dem Editor ausführen.

Aggrega: Import into Aggrega — entwirft Aggrega-Authoring-Dateien aus einer Quelle, die ein anderes Werkzeug geschrieben hat. Es ist auch die Schaltfläche Import in der Gruppe Author des Panels Commands und Import into Aggrega im Kontextmenü einer Datei oder eines Ordners im Explorer, das die angeklickte Datei oder den angeklickten Ordner importiert: Die drei sind ein Befehl und stellen daher dieselben Fragen, in dieser Reihenfolge, jede in der eigenen Eingabe des Editors, außer dass der Eintrag im Explorer nicht nach der Quelle fragt.

Zuerst die Quelle: File… oder Folder…, dann der Öffnen-Dialog Ihres Editors für eine solche — die Wahl kommt zuerst, weil unter Windows und Linux ein Dialog nicht beides anbieten kann. Dann der Ordner innerhalb des Workspace, in den entworfen wird, relativ zu dessen Stammverzeichnis, wobei ein leeres Feld unterhalb des Workspace-Stammverzeichnisses entwirft, wie aggrega import ohne --output-dir. Dann die Optionen, eine Liste, in der Sie Preview, Sync, beide oder keine ankreuzen können: Preview ist --dry-run — nichts wird geschrieben, und jede Datei, die der Import schreiben würde, wird im Ausgabekanal gefolgt von ihrem Inhalt angezeigt — und Sync ist --sync, das bringt, was ein früherer Import entworfen hat, auf den Stand der Quelle und ändert nur, was der Import geschrieben hat, wobei jeder aktualisierte Teil im Kanal mit den Worten aufgeführt wird, die aggrega import --sync dafür ausgibt; keines anzukreuzen schreibt die Entwürfe vollständig. Zuletzt die Provider-Capability, für die ein Manifest entworfen werden soll, etwa compose oder helm, wobei ein leeres Feld keines entwirft, wie ohne --target. Eine Antwort, die Sie leer lassen, und eine Option, die Sie nicht ankreuzen, wird gar nicht gesendet, sodass der Compiler seinen eigenen Standard anwendet, und das Verwerfen einer Frage oder eines Dialogs beendet den Import, ohne etwas zu senden. Ein Ordner, der aus dem Workspace hinausführt, und eine Capability, an die sich kein Recipe im Katalog des Workspace bindet, werden vom Compiler in eigenen Worten abgelehnt, bevor etwas geschrieben wird.

Die erste Frage des Imports, ob die Quelle eine Datei oder ein Ordner ist.

Das Format wird an der Gestalt der Quelle selbst erkannt, wie in einem Terminal; wo der Compiler ablehnt, weil kein Format oder mehr als eines die Quelle erkennt, zeigt der Editor diese Ablehnung — die die Formate nennt — und fragt nach dem Format, als das die Quelle gelesen werden soll, und sendet dann denselben Import erneut mit dieser Angabe; bleibt diese Frage leer, endet der Import mit der Ablehnung. Er liest die Datei, die Sie nennen, oder die Dateien des genannten Verzeichnisses, die sein Importer liest, und keine anderen. Er erreicht kein Netzwerk, außer um abzurufen, worauf ein Import angewiesen ist und was dieser Rechner noch nicht hat — einen der Kern-Importer des Compilers, wenn ein Format ihn zum ersten Mal braucht, und in einem Workspace, der keinen Katalogordner nennt, den veröffentlichten Katalog-Snapshot, den der Import als seinen Katalog liest —, wobei jedes davon aus der Standard-Registry des Workspace geholt, verifiziert und im Content-Cache behalten wird, wie aggrega import es tut. Die Quelle kann irgendwo auf diesem Rechner liegen, weil es eine Datei ist, auf die Sie gezeigt haben, und keine, die der Workspace enthält; die Entwürfe landen immer im Workspace.

Er zeigt den Fortschritt mit einer Cancel-Schaltfläche, und ein Druck auf Cancel stoppt die Konvertierung, statt nur das Warten des Editors zu beenden, weil der Importer als Plugin läuft, das der Compiler mitten im Lauf abwickeln kann.

Der Abschluss sagt, als was die Quelle erkannt wurde, wie viele Dateien entworfen wurden und wohin sie gingen, wobei die Entwürfe gezählt werden und nicht .aggrega-import.json, die Aufzeichnung dessen, was der Import geschrieben hat, die jeder Import neben seine Entwürfe schreibt; die eigenen Befunde des Importers und jede Datei, die auf der Festplatte gelandet ist, die Aufzeichnung eingeschlossen, gehen in den Aggrega-Ausgabekanal, weil sie eine Stelle in der Quelldatei benennen und nicht in einem Dokument, das Sie verfasst haben. Wenn ein Import, der seine Entwürfe schreibt, diese mit Werten zurücklässt, die sie noch schuldig bleiben und die keine Quelle enthalten kann, bietet der Editor an, Sie danach zu fragen, wie unter Die Werte beantworten, die ein Import noch schuldig bleibt beschrieben.

Die Werte beantworten, die ein Import noch schuldig bleibt

Manche Werte, die ein Entwurf braucht, kann keine Quelle enthalten — etwa das Image, in das Ihr eigener Code gebaut wird, die E-Mail-Adresse eines Eigentümerkontos oder die Herkunft eines Secrets. Wenn ein Import, der seine Entwürfe schreibt, solche Werte leer lässt, bietet der Editor einmal, in einer Benachrichtigung, die ihre Anzahl nennt, an, Sie danach zu fragen; das Verwerfen des Angebots ändert nichts. Einer Vorschau wird nichts angeboten, so wie aggrega import --dry-run nichts fragt, weil auf eine Vorschau keine Antwort angewendet wird; ihre Befunde im Ausgabekanal nennen dennoch jeden noch leeren Wert. Nehmen Sie das Angebot an, wird jeder Wert in einem eigenen Eingabefeld abgefragt, in der Reihenfolge, in der die Entwürfe sie aufführen: Der Titel des Felds nennt die entworfene Datei und den Schlüssel, unter dem der Wert steht, und die Frage verwendet die Beschreibung des Werts durch den Compiler selbst, also die Frage, die aggrega import in einem Terminal stellt. Das Feld eines Secrets fragt in den Worten des Compilers, woher das Secret stammt — nie nach dem Secret selbst — und verbirgt, was Sie eingeben. Ein Feld, das Sie leer lassen, lässt diesen Wert offen, sodass er später in der Antwortdatei beantwortet werden kann. Ein Druck auf Escape in einem beliebigen Feld beendet die Fragen und sendet nichts, auch nicht die bereits eingegebenen Antworten.

Der Editor sendet den Import dann erneut mit Ihren Antworten, mit demselben Fortschritt und derselben Cancel-Schaltfläche, und seine Befunde, seine Dateien und sein Abschluss gelangen in den Ausgabekanal wie die des ersten Imports. Die Antworten gehen mit einem Sync, weil die Entwürfe bereits auf der Festplatte liegen. Der Compiler schreibt jede Antwort in die Entwürfe und behält sie in der Antwortdatei, die aggrega import liest, sodass ein späterer Import oder Sync dieser Quelle nicht erneut danach fragt; ein Wert, den diese Datei bereits beantwortet, wird gar nicht abgefragt. Ein Secret, das mit etwas anderem als einem Namen für seine Herkunft beantwortet wird, lehnt der Compiler in eigenen Worten ab, und es bleibt offen. Was die Entwürfe nach dem erneut gesendeten Import noch schuldig bleiben, wird auf dieselbe Weise angeboten.