Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Importer dans Aggrega

Ce qu’un import lit et écrit, et les formats qu’il lit, sont décrits dans Import ; cette page explique comment en lancer un depuis l’éditeur.

Aggrega: Import into Aggrega — rédige des fichiers d’authoring Aggrega à partir d’une source écrite par un autre outil. C’est aussi le bouton Import du groupe Author du panneau Commands, et Import into Aggrega dans le menu contextuel d’un fichier ou d’un dossier dans l’Explorer, qui importe le fichier ou le dossier sur lequel vous avez cliqué : les trois sont une seule commande, ils posent donc les mêmes questions, dans cet ordre, chacune dans la saisie propre de l’éditeur, sauf que l’entrée de l’Explorer ne demande pas la source.

D’abord la source : File… ou Folder…, puis la boîte de dialogue d’ouverture de votre éditeur pour l’un ou l’autre — ce choix vient en premier car sous Windows et Linux une boîte de dialogue ne peut pas proposer les deux. Ensuite le dossier du workspace dans lequel rédiger, relatif à sa racine, où le laisser vide rédige sous la racine du workspace, comme le fait aggrega import sans --output-dir. Ensuite les options, une liste dans laquelle vous pouvez cocher Preview, Sync, les deux ou aucune : Preview correspond à --dry-run — rien n’est écrit, et chaque fichier que l’import écrirait est affiché sur le canal de sortie suivi de son contenu — et Sync correspond à --sync, qui met à jour par rapport à la source ce qu’un import précédent a rédigé, en ne modifiant que ce que l’import a écrit, chaque partie mise à jour étant listée sur le canal avec les mots que aggrega import --sync affiche pour elle ; n’en cocher aucune écrit les brouillons en entier. Enfin, la capacité de provider pour laquelle rédiger un Manifest, comme compose ou helm, où la laisser vide n’en rédige aucun, comme sans --target. Une réponse que vous laissez vide, et une option que vous laissez décochée, n’est pas envoyée du tout, de sorte que le compilateur applique sa propre valeur par défaut, et fermer toute question ou boîte de dialogue met fin à l’import sans rien envoyer. Un dossier qui sort du workspace, et une capacité à laquelle aucune Recipe du catalogue du workspace ne se lie, sont refusés par le compilateur avec ses propres mots avant que quoi que ce soit soit écrit.

La première question de l’import, qui demande si la source est un fichier ou un dossier.

Le format est reconnu à partir de la forme propre de la source, comme dans un terminal ; lorsque le compilateur refuse parce qu’aucun format, ou plus d’un, ne reconnaît la source, l’éditeur affiche ce refus — qui nomme les formats — et demande le format selon lequel lire la source, puis renvoie le même import en l’incluant, et laisser cette question vide met fin à l’import avec le refus. Il lit le fichier que vous nommez, ou les fichiers du répertoire que vous nommez que son importeur lit, et aucun autre. Il n’atteint aucun réseau, sauf pour récupérer ce sur quoi un import s’appuie et que cette machine ne possède pas encore — l’un des importeurs de base du compilateur, la première fois qu’un format en a besoin, et, dans un workspace qui ne nomme aucun dossier de catalogue, l’instantané publié du catalogue que l’import lit comme son catalogue —, chacun récupéré depuis le registre par défaut du workspace, vérifié et conservé dans le cache de contenu, comme le fait aggrega import. La source peut se trouver n’importe où sur cette machine, car c’est un fichier que vous avez désigné et non un fichier que contient le workspace ; les brouillons arrivent toujours dans le workspace.

Il affiche sa progression avec un bouton Cancel, et presser Cancel arrête la conversion plutôt que d’arrêter seulement l’attente de l’éditeur, car l’importeur s’exécute comme un plugin que le compilateur peut interrompre en cours d’exécution.

La conclusion indique en quel format la source a été reconnue, combien de fichiers ont été rédigés et où ils sont allés, en comptant les brouillons et non .aggrega-import.json, l’enregistrement de ce que l’import a écrit que chaque import écrit à côté de ses brouillons ; les constats propres de l’importeur et chaque fichier arrivé sur le disque, enregistrement compris, vont dans le canal de sortie Aggrega, car ils nomment un endroit du fichier source plutôt que d’un document que vous avez rédigé. Lorsqu’un import qui écrit ses brouillons les laisse en attente de valeurs qu’aucune source ne peut contenir, l’éditeur propose de vous les demander, comme le décrit Répondre aux valeurs encore dues par un import.

Répondre aux valeurs encore dues par un import

Certaines valeurs dont un brouillon a besoin sont des valeurs qu’aucune source ne peut contenir — l’image dans laquelle votre propre code est construit, par exemple, l’adresse e-mail d’un compte propriétaire, ou la provenance d’un secret. Lorsqu’un import qui écrit ses brouillons laisse de telles valeurs vides, l’éditeur propose une seule fois, dans une notification qui indique leur nombre, de vous les demander ; ignorer la proposition ne change rien. Rien n’est proposé pour un aperçu, de même que aggrega import --dry-run ne demande rien, car aucune réponse n’est appliquée à un aperçu ; ses constats sur le canal de sortie nomment toutefois chaque valeur encore vide. Si vous acceptez la proposition, chaque valeur est demandée dans une zone de saisie distincte, dans l’ordre où les brouillons les listent : la zone a pour titre le fichier rédigé et la clé où se trouve la valeur, et pose la question avec la description de la valeur fournie par le compilateur lui-même, la question que aggrega import pose dans un terminal. La zone d’un secret demande d’où provient le secret, avec les mots du compilateur — jamais le secret lui-même — et masque ce que vous tapez. Une zone que vous laissez vide laisse cette valeur due, à fournir plus tard dans le fichier de réponses. Appuyer sur Échap dans n’importe quelle zone met fin aux questions et n’envoie rien, y compris les réponses que vous aviez déjà tapées.

L’éditeur renvoie ensuite l’import avec vos réponses, avec la même progression et le même bouton Cancel, et ses constats, ses fichiers et sa conclusion arrivent sur le canal de sortie comme ceux du premier import. Les réponses sont envoyées avec une synchronisation, car les brouillons sont déjà sur le disque. Le compilateur écrit chaque réponse dans les brouillons et la conserve dans le fichier de réponses que lit aggrega import, de sorte qu’un import ou une synchronisation ultérieurs de cette source ne la redemandent pas ; une valeur à laquelle ce fichier répond déjà n’est pas demandée du tout. Un secret auquel on répond par autre chose qu’un nom désignant sa provenance est refusé par le compilateur avec ses propres mots et reste dû. Tout ce que les brouillons doivent encore après le nouvel envoi de l’import est proposé de la même façon.