Aggrega'ya içe aktarma
Bir içe aktarmanın neyi okuyup yazdığı ve hangi biçimleri okuduğu İçe aktarma sayfasında açıklanır; bu sayfa bir içe aktarmanın editörden çalıştırılmasını ele alır.
Aggrega: Import into Aggrega — başka bir aracın yazdığı bir kaynaktan Aggrega yazım dosyalarının taslağını oluşturur. Bu aynı zamanda Commands panelinin Author grubundaki Import düğmesi ve Gezgin’de bir dosyanın veya klasörün sağ tıklama menüsündeki Import into Aggrega öğesidir; ikincisi tıkladığınız dosyayı veya klasörü içe aktarır: üçü tek bir komuttur, bu nedenle aynı soruları aynı sırayla, her birini editörün kendi giriş alanında sorar; yalnızca Gezgin girdisi kaynağı sormaz.
Önce kaynak: File… veya Folder…, ardından editörünüzün o türe ait açma iletişim kutusu — seçim önce gelir, çünkü Windows ve Linux’ta tek bir iletişim kutusu ikisini birden sunamaz. Ardından, taslakların oluşturulacağı çalışma alanı içindeki klasör, köküne göre; boş bırakıldığında, --output-dir olmadan aggrega import komutunun yaptığı gibi taslaklar çalışma alanı kökünün altında oluşturulur. Ardından seçenekler; Preview, Sync, ikisini birden veya hiçbirini işaretleyebileceğiniz bir liste: Preview, --dry-run seçeneğidir — hiçbir şey yazılmaz ve içe aktarmanın yazacağı her dosya, ardından içeriğiyle birlikte çıktı kanalında gösterilir — Sync ise --sync seçeneğidir; önceki bir içe aktarmanın taslağını oluşturduklarını kaynakla güncel hâle getirir, yalnızca içe aktarmanın yazdıklarını değiştirir ve güncellediği her parça, aggrega import --sync komutunun onun için yazdırdığı sözcüklerle kanalda listelenir; hiçbirini işaretlememek taslakları bütünüyle yazar. Son olarak, Manifest taslağı oluşturulacak sağlayıcı yeteneği, örneğin compose veya helm; boş bırakıldığında, --target olmadan olduğu gibi hiçbir taslak oluşturulmaz. Boş bıraktığınız bir yanıt ve işaretlemediğiniz bir seçenek hiç gönderilmez, bu nedenle derleyici kendi varsayılanını uygular; herhangi bir soruyu veya iletişim kutusunu kapatmak, hiçbir şey göndermeden içe aktarmayı sona erdirir. Çalışma alanının dışına çıkan bir klasör ve çalışma alanının kataloğundaki hiçbir Recipe’nin bağlanmadığı bir yetenek, herhangi bir şey yazılmadan önce derleyici tarafından kendi ifadeleriyle reddedilir.

Biçim, terminalde olduğu gibi kaynağın kendi şeklinden tanınır; hiçbir biçim veya birden fazla biçim kaynağı tanıdığı için derleyici reddettiğinde, editör bu reddi — biçimleri adlandıran reddi — gösterir ve kaynağın hangi biçimde okunacağını sorar, ardından aynı içe aktarmayı bu biçimle yeniden gönderir; bu soruyu boş bırakmak içe aktarmayı bu retle sona erdirir. Yalnızca belirttiğiniz dosyayı veya belirttiğiniz dizindeki, içe aktarıcısının okuduğu dosyaları okur, başka hiçbirini okumaz. Ağa erişmez; tek istisna, bir içe aktarmanın üzerinde çalıştığı ve bu makinede henüz bulunmayan şeyi getirmektir — bir biçimin ilk kez ihtiyaç duyduğu, derleyicinin çekirdek içe aktarıcılarından biri ve hiçbir katalog klasörü belirtmeyen bir çalışma alanında, içe aktarmanın kendi kataloğu olarak okuduğu yayımlanmış katalog anlık görüntüsü — her biri, aggrega import komutunun yaptığı gibi, çalışma alanının varsayılan kayıt defterinden getirilir, doğrulanır ve içerik önbelleğinde tutulur. Kaynak bu makinenin herhangi bir yerinde bulunabilir, çünkü çalışma alanının barındırdığı bir dosya değil, sizin gösterdiğiniz bir dosyadır; taslaklar her zaman çalışma alanına yerleşir.
Bir Cancel düğmesiyle ilerlemeyi gösterir ve Cancel’a basmak yalnızca editörün beklemesini durdurmakla kalmaz, dönüştürmeyi durdurur; çünkü içe aktarıcı, derleyicinin çalışmanın ortasında geri sarabileceği bir eklenti olarak çalışır.
Bitişte, kaynağın ne olarak tanındığı, kaç dosyanın taslağının oluşturulduğu ve nereye gittiği belirtilir; sayılan taslaklardır, her içe aktarmanın taslaklarının yanına yazdığı ve içe aktarmanın ne yazdığını kaydeden .aggrega-import.json sayılmaz; içe aktarıcının kendi bulguları ve diske ulaşan her dosya, bu kayıt da dahil, Aggrega çıktı kanalına gider, çünkü bunlar sizin yazdığınız bir belgedeki değil, kaynak dosyadaki bir yeri belirtir. Taslaklarını yazan bir içe aktarma, onları hiçbir kaynağın tutamayacağı değerlere borçlu bıraktığında, editör bunları size sormayı önerir; bu, Bir içe aktarmanın hâlâ borçlu olduğu değerleri yanıtlama bölümünde açıklanmıştır.
Bir içe aktarmanın hâlâ borçlu olduğu değerleri yanıtlama
Bir taslağın ihtiyaç duyduğu bazı değerler, hiçbir kaynağın tutamayacağı değerlerdir — örneğin kendi kodunuzun derlendiği imaj, bir sahip hesabının e-posta adresi veya bir gizli bilginin nereden geldiği. Taslaklarını yazan bir içe aktarma bu tür değerleri boş bıraktığında, editör kaç tane olduklarını belirten bir bildirimde bunları size sormayı bir kez önerir; öneriyi kapatmak hiçbir şeyi değiştirmez. Bir önizlemeye hiçbir şey önerilmez, tıpkı aggrega import --dry-run komutunun hiçbir şey sormaması gibi, çünkü bir önizlemeye hiçbir yanıt uygulanmaz; önizlemenin çıktı kanalındaki bulguları yine de hâlâ boş olan her değeri belirtir. Öneriyi kabul ederseniz her değer, taslakların onları listelediği sırayla kendi giriş kutusunda sorulur: kutunun başlığı, taslağı oluşturulan dosya ve değerin bulunduğu anahtardır; kutu, derleyicinin değere ilişkin kendi açıklamasıyla, yani aggrega import komutunun terminalde sorduğu soruyla sorar. Bir gizli bilginin kutusu, gizli bilginin nereden geldiğini derleyicinin kendi ifadeleriyle sorar — asla gizli bilginin kendisini değil — ve yazdıklarınızı gizler. Boş bıraktığınız bir kutu, o değeri daha sonra yanıtlar dosyasında yanıtlanmak üzere borçlu bırakır. Herhangi bir kutuda Escape tuşuna basmak soruları sona erdirir ve daha önce yazdığınız yanıtlar dahil hiçbir şey göndermez.
Editör ardından içe aktarmayı yanıtlarınızla, aynı ilerleme göstergesi ve Cancel düğmesiyle yeniden gönderir; bulguları, dosyaları ve bitişi, ilk içe aktarmanınkiler gibi çıktı kanalına ulaşır. Yanıtlar bir eşitlemeyle gönderilir, çünkü taslaklar zaten disktedir. Derleyici her yanıtı taslaklara yazar ve aggrega import komutunun okuduğu yanıtlar dosyasında saklar; böylece o kaynağın sonraki bir içe aktarması veya eşitlemesi onu yeniden sormaz; o dosyanın zaten yanıtladığı bir değer hiç sorulmaz. Nereden geldiğini belirten bir addan başka bir şeyle yanıtlanan bir gizli bilgi, derleyici tarafından kendi ifadeleriyle reddedilir ve borçlu kalır. Yeniden gönderilen içe aktarmadan sonra taslakların hâlâ borçlu olduğu her şey aynı şekilde sunulur.