Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Impor ke Aggrega

Apa yang dibaca dan ditulis oleh impor, serta format yang dibacanya, dijelaskan di Impor; halaman ini membahas cara menjalankan impor dari editor.

Aggrega: Import into Aggrega — membuat draf berkas penulisan Aggrega dari sumber yang ditulis alat lain. Ini juga tombol Import di grup Author panel Commands, dan Import into Aggrega pada menu klik kanan berkas atau folder di Explorer, yang mengimpor berkas atau folder yang Anda klik: ketiganya adalah satu perintah, sehingga menanyakan pertanyaan yang sama, dalam urutan ini, masing-masing di input editor sendiri, kecuali bahwa entri Explorer tidak menanyakan sumber.

Pertama sumber: File… atau Folder…, lalu dialog buka editor Anda untuk jenis tersebut — pilihan ini didahulukan karena di Windows dan Linux satu dialog tidak dapat menawarkan keduanya. Lalu folder di dalam ruang kerja tempat draf dibuat, relatif terhadap root-nya, dan membiarkannya kosong membuat draf di bawah root ruang kerja, seperti yang dilakukan aggrega import tanpa --output-dir. Lalu opsi, sebuah daftar tempat Anda dapat mencentang Preview, Sync, keduanya, atau tidak keduanya: Preview adalah --dry-run — tidak ada yang ditulis, dan setiap berkas yang akan ditulis impor ditampilkan di kanal keluaran diikuti isinya — dan Sync adalah --sync, yang memperbarui apa yang dibuat draf oleh impor sebelumnya agar sesuai dengan sumber, hanya mengubah apa yang ditulis impor, dengan setiap bagian yang diperbaruinya dicantumkan di kanal dengan kata-kata yang dicetak aggrega import --sync untuknya; tidak mencentang keduanya menulis draf secara utuh. Terakhir, kapabilitas penyedia yang akan dibuatkan draf Manifest, seperti compose atau helm, dan membiarkannya kosong tidak membuat draf apa pun, seperti tanpa --target. Jawaban yang Anda biarkan kosong, dan opsi yang tidak Anda centang, sama sekali tidak dikirim, sehingga kompilator menerapkan default-nya sendiri, dan menutup pertanyaan atau dialog apa pun mengakhiri impor tanpa mengirim apa pun. Folder yang mengarah ke luar ruang kerja, dan kapabilitas yang tidak diikat oleh Recipe mana pun di katalog ruang kerja, ditolak oleh kompilator dengan kata-katanya sendiri sebelum apa pun ditulis.

Pertanyaan pertama impor, yang menanyakan apakah sumber berupa berkas atau folder.

Format dikenali dari bentuk sumber itu sendiri, seperti di terminal; jika kompilator menolak karena tidak ada format, atau lebih dari satu, yang mengenali sumber, editor menampilkan penolakan tersebut — yang menyebutkan format-formatnya — dan menanyakan format untuk membaca sumber, lalu mengirim impor yang sama lagi dengan membawanya, dan membiarkan pertanyaan itu kosong mengakhiri impor dengan penolakan tersebut. Perintah ini membaca berkas yang Anda sebutkan, atau berkas di direktori yang Anda sebutkan yang dibaca pengimpornya, dan tidak ada yang lain. Perintah ini tidak menjangkau jaringan, kecuali untuk mengambil apa yang dibutuhkan impor untuk berjalan dan belum dimiliki mesin ini — salah satu pengimpor inti kompilator, saat pertama kali sebuah format membutuhkannya, dan, di ruang kerja yang tidak menyebutkan folder katalog, snapshot katalog terbitan yang dibaca impor sebagai katalognya — masing-masing diambil dari registry default ruang kerja, diverifikasi, dan disimpan di cache konten, seperti yang dilakukan aggrega import. Sumber dapat berada di mana saja di mesin ini, karena itu adalah berkas yang Anda tunjuk, bukan berkas yang dimiliki ruang kerja; draf selalu berakhir di ruang kerja.

Perintah ini menampilkan progres dengan tombol Cancel, dan menekan Cancel menghentikan konversi, bukan hanya menghentikan editor menunggu, karena pengimpor berjalan sebagai plugin yang dapat dihentikan kompilator di tengah eksekusi.

Bagian akhir menyatakan sumber dikenali sebagai apa, berapa banyak berkas yang dibuat draf, dan ke mana berkas-berkas tersebut ditempatkan, dengan menghitung draf dan bukan .aggrega-import.json, catatan tentang apa yang ditulis impor yang ditulis setiap impor di samping drafnya; temuan pengimpor sendiri dan setiap berkas yang sampai ke disk, termasuk catatan tersebut, dikirim ke kanal keluaran Aggrega, karena semua itu menyebutkan suatu tempat di berkas sumber, bukan di dokumen yang Anda tulis. Jika impor yang menulis drafnya membiarkan draf itu masih menyisakan nilai yang tidak dapat dimuat sumber mana pun, editor menawarkan untuk menanyakannya kepada Anda, seperti dijelaskan di Menjawab nilai yang masih belum dipenuhi impor.

Menjawab nilai yang masih belum dipenuhi impor

Beberapa nilai yang dibutuhkan draf adalah nilai yang tidak dapat dimuat sumber mana pun — misalnya image tempat kode Anda sendiri dibangun, email akun pemilik, atau asal sebuah secret. Jika impor yang menulis drafnya membiarkan nilai seperti itu kosong, editor menawarkan sekali, dalam notifikasi yang menyebutkan jumlahnya, untuk menanyakannya kepada Anda; mengabaikan tawaran itu tidak mengubah apa pun. Pratinjau tidak ditawari apa pun, sebagaimana aggrega import --dry-run tidak menanyakan apa pun, karena tidak ada jawaban yang diterapkan pada pratinjau; temuannya di kanal keluaran tetap menyebutkan setiap nilai yang masih kosong. Jika Anda menerima tawaran itu, setiap nilai ditanyakan dalam kotak input tersendiri, sesuai urutan yang dicantumkan draf: judul kotak berisi berkas draf dan kunci tempat nilai itu berada, dan pertanyaannya memakai deskripsi nilai dari kompilator sendiri, yaitu pertanyaan yang diajukan aggrega import di terminal. Kotak untuk secret menanyakan dari mana secret itu berasal, dengan kata-kata kompilator sendiri — tidak pernah secret itu sendiri — dan menyembunyikan apa yang Anda ketik. Kotak yang Anda biarkan kosong membuat nilai itu tetap belum dipenuhi, untuk dijawab nanti di berkas jawaban. Menekan Escape di kotak mana pun mengakhiri pertanyaan dan tidak mengirim apa pun, termasuk jawaban yang sudah Anda ketik.

Editor kemudian mengirim impor itu lagi dengan jawaban Anda, dengan progres dan tombol Cancel yang sama, dan temuan, berkas, serta bagian akhirnya sampai ke kanal keluaran seperti pada impor pertama. Jawaban dikirim dengan sinkronisasi, karena draf sudah ada di disk. Kompilator menulis setiap jawaban ke dalam draf dan menyimpannya di berkas jawaban yang dibaca aggrega import, sehingga impor atau sinkronisasi berikutnya dari sumber tersebut tidak menanyakannya lagi; nilai yang sudah dijawab berkas itu sama sekali tidak ditanyakan. Secret yang dijawab dengan apa pun selain nama untuk asalnya ditolak oleh kompilator dengan kata-katanya sendiri dan tetap belum dipenuhi. Apa pun yang masih belum dipenuhi draf setelah impor dikirim lagi ditawarkan dengan cara yang sama.