跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

导入到 Aggrega

导入读取和写入什么、读取哪些格式,见导入;本页介绍如何从编辑器运行导入。

Aggrega: Import into Aggrega — 根据另一个工具编写的源起草 Aggrega 编写文件。它也是 Commands 面板 Author 组中的 Import 按钮,以及资源管理器中文件或文件夹右键菜单上的 Import into Aggrega,后者导入你点击的文件或文件夹:这三者是同一个命令,因此它们按相同顺序提出相同的问题,每个问题都在编辑器自己的输入框中提出,只是资源管理器中的入口不会询问源。

首先是源:File… 或 Folder…,然后是你的编辑器中用于该类型的打开对话框 — 先做这一选择,是因为在 Windows 和 Linux 上一个对话框无法同时提供两者。然后是工作区内要起草到的文件夹,相对于其根目录,留空则起草到工作区根目录下,与不带 --output-dir 的 aggrega import 相同。然后是选项,一个列表,你可以在其中勾选 Preview、Sync、两者都勾选或都不勾选:Preview 即 --dry-run — 不写入任何内容,导入将写入的每个文件都会显示在输出通道上,后跟其内容 — 而 Sync 即 --sync,使之前的导入所起草的内容与源保持同步,只更改导入所写入的内容,它更新的每个部分都会以 aggrega import --sync 为其打印的措辞列在通道上;两者都不勾选则完整写入草稿。最后是要为其起草 Manifest 的提供程序能力,例如 compose 或 helm,留空则不起草任何内容,与不带 --target 时相同。你留空的回答和你未勾选的选项根本不会发送,因此编译器会应用其自己的默认值;关闭任何问题或对话框都会结束导入且不发送任何内容。通向工作区之外的文件夹,以及工作区编目中没有任何 Recipe 绑定的能力,会在写入任何内容之前被编译器以其自己的措辞拒绝。

导入的第一个问题,询问源是文件还是文件夹。

格式根据源自身的形态识别,与在终端中相同;当编译器因没有任何格式或有多于一种格式识别该源而拒绝时,编辑器会显示该拒绝 — 其中指明了各种格式 — 并询问以哪种格式读取该源,然后再次发送携带该格式的同一导入;将该问题留空则以该拒绝结束导入。它只读取你指明的文件,或你指明的目录中其导入器会读取的文件,不读取其他文件。它不访问网络,除非要获取导入运行所依赖而本机尚未拥有的内容 — 某种格式首次需要时的某个编译器核心导入器,以及在未指定编目文件夹的工作区中,导入作为其编目读取的已发布编目快照 — 每一项都从工作区的默认注册表获取,经过验证并保存在内容缓存中,与 aggrega import 相同。源可以位于本机的任何位置,因为它是你指向的文件,而不是工作区所包含的文件;草稿始终落在工作区中。

它会显示带 Cancel 按钮的进度,按下 Cancel 会停止转换,而不仅仅是停止编辑器的等待,因为导入器作为编译器可以在运行中途回退的插件运行。

结束时会说明源被识别为什么、起草了多少个文件以及它们的去向,计数的是草稿,不包括 .aggrega-import.json,即每次导入都会在其草稿旁写入的、记录导入写入了什么的记录;导入器自己的发现以及每个写入磁盘的文件(包括该记录)都会进入 Aggrega 输出通道,因为它们指明的是源文件中的位置,而不是你编写的文档中的位置。当写入草稿的导入使草稿仍欠缺任何源都无法包含的值时,编辑器会提出向你询问这些值,如回答导入仍欠缺的值所述。

回答导入仍欠缺的值

草稿所需的某些值是任何源都无法包含的 — 例如,你自己的代码所构建成的镜像、所有者账户的电子邮件,或某个机密的来源。当写入草稿的导入将此类值留空时,编辑器会在一条注明其数量的通知中提出一次,向你询问这些值;忽略该提议不会改变任何内容。预览不会收到任何提议,正如 aggrega import --dry-run 不会提问,因为答案不会应用于预览;预览在输出通道中的发现仍会指明每个仍为空的值。接受该提议后,每个值都会按草稿列出的顺序,在各自的输入框中询问:输入框的标题是所起草的文件以及该值所在的键,并使用编译器自己对该值的描述来提问,即 aggrega import 在终端中提出的问题。机密的输入框以编译器自己的措辞询问该机密从何而来 — 绝不询问机密本身 — 并隐藏你输入的内容。你留空的输入框会使该值仍然欠缺,留待之后在答案文件中回答。在任何输入框中按 Escape 都会结束提问且不发送任何内容,包括你已输入的答案。

然后,编辑器会携带你的答案再次发送导入,带有相同的进度和 Cancel 按钮,其发现、文件和结束信息会像第一次导入那样进入输出通道。答案会通过同步发送,因为草稿已在磁盘上。编译器会将每个答案写入草稿,并将其保存在 aggrega import 读取的答案文件中,因此之后对该源的导入或同步不会再次询问;该文件已回答的值根本不会被询问。如果对某个机密的回答不是其来源的名称,编译器会以其自己的措辞拒绝,该值仍然欠缺。再次发送导入后草稿仍欠缺的任何值,都会以同样的方式提出。