İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Topoloji grafiği

Topology graph — seçili Release’in derlenmiş IR’ını etkileşimli bir grafik olarak çizer: sınır ve alt sistem kapsayıcıları (başka bir sınır veya alt sistemin içinde bildirilen her sınır ya da alt sistem onun içinde çizilir), kökene göre biçimlendirilmiş kenarlar, kaydırma ve yakınlaştırma, bir düğümü seçmek için tıklama ve kaynak dosyasını açmak için çift tıklama ve bir kenarın çizdiği bağlantıyı seçmek için o kenara tıklama.

Bir Release'in topoloji grafiği: hiçbir sınırın veya alt sistemin bildirmediği düğümleri tutan kutuların içinde üç bileşen, web bileşeninden veritabanına ve önbelleğine giden kenarlar ve sol alttaki gösterge.

Her kapsayıcının başlığı, gruplamasının yanı sıra türünü de belirtir; böylece dış kutu ile iç kutu, ikisini de bildirmeyen bir çalışma alanında bile birbirinden ayırt edilebilir — aksi takdirde ikisi de aynı adı taşırdı. Kimsenin bildirmediği bir gruplama, yani derleyicinin bir Release’in veya bir Aggregate’in en üst düzeyde listelediği bileşenler için oluşturduğu gruplama, hiçbirinin bildirilmediğini belirten bir başlık alır ve kutusu bildirilmiş bir gruplamanınkinden farklı çizilir — noktalı, nötr bir kenarlıkla — böylece o adda bir gruplama olarak okunmaz; sizin bildirdiğiniz bir gruplama, default dahil, adı ne olursa olsun adını korur.

Her kenar, işaret ettiği uçta bir ok başı taşır: bir kenar, tüketen bileşenden hedefine doğru uzanır ve ok başı kenarın kendi rengi ve kesik çizgi deseniyle çizilir. Bir düğümün kutusu, çizdiği metin ölçülerek boyutlandırılır; hem düğümün adı hem de altındaki bileşen ölçülür, böylece bileşen adı ne kadar uzun olursa olsun ikisi de kenarlığın dışına taşmaz.

Sol alttaki gösterge, her gruplamayı onu bildiren belgeye göre adlandırır — bir sınırı Release’e, bir alt sistemi Aggregate’e göre — ve çizimde varsa, hiçbir gruplamada olmayan düğümleri tutan kutuyu, içerdikleriyle birlikte adlandırır; bir kenarın hangi ucunun hedefi olduğunu belirtir; ayrıca bir düğümün ön kenarı boyunca uzanan renk çubuğunu ve çizimin ona verdiği her rengi, o rengin temsil ettiği component.aggrega.ai/type değerinin yanında, etiketin yazıldığı şekliyle adlandırır ve böyle bir etiket taşımayan düğümler varsa onlar için bir satır ekler. Bu renklerin ne anlama gelmediğini de belirtir: renkler her grafik çizildiğinde atanır, bu nedenle düğümleri bir grafik içinde türe göre gruplar ve başka bir grafikteki aynı renk aynı tür değildir. Çizime ne yaparsanız yapın gösterge yerinde kalır; bu nedenle çizim panele her sığdırıldığında — ilk çiziminde ve grafiği her istediğinizde — panelin göstergenin üstünde kalan kısmına sığdırılır: panelin tüm genişliği ve göstergenin üstünde kalan yükseklik içinde, yatay olarak ortalanarak; böylece gösterge kaç satır içerirse içersin çizimin hiçbir kısmını örtmez. Göstergenin üstünde hiç yer bırakmayacak kadar alçak bir panelde çizim tüm panele sığdırılır.

Bir düğüm seçildiğinde, ona eklenenleri listeleyen bir panel açılır: her ekin Feature’ı ve çözümlenmiş sürümü, doldurduğu yuva veya bildirilmiş hiçbir yuvayı doldurmadığı, derlenmiş grafik bir tane adlandırdığında onu gerçekleştiren FeatureRecipe’nin adı ve sürümü, nereden geldiği, bildirdiği etiketler ve yazarının yazdığı değerler. Bileşenin bağlantılarından birine yazılmış bir ek — Aggregate’te veya Release’te bir uses girdisindeki features: altında — bu listede yer almaz: derlenmiş grafiğin kaydettiği şekilde ait olduğu bağlantı üzerinde çizilir ve düğümün bağlantılarında ek bulunduğunda düğümün paneli bunu belirtir.

Bir kenara tıklamak, kenarın çizdiği bağlantıyı seçer ve onun panelini açar; panelin başlığı tüketen bileşen ve hedefidir, soket ve takma ad da belirtilir ve o bağlantının ekleri bir düğümünkiler gibi gösterilir — her birinin Feature’ı ve çözümlenmiş sürümü, doldurduğu yuva, derlenmiş grafik bir tane adlandırdığında onu gerçekleştiren FeatureRecipe ve değerleri — ya da ona hiçbir şey eklenmediğini söyleyen bir cümle gösterilir. Bir düğüm seçmek seçili bir bağlantıyı temizler ve tersi de geçerlidir; Escape veya panelin kapatma düğmesi ikisini de temizler ve yeniden çizim, yeniden oluşturulan grafik düğümü ya da aynı bileşenden aynı soket üzerinden aynı takma adla çıkan bağlantıyı çizmeye devam ettiği sürece seçimi korur.

Bir düğümün eklerinin altında, May attach başlığı altında panel, panelin gösterdiği Release’in grafiğinde o düğümün etiketlerinin bildirilmiş uygulanabilirliğini karşıladığı Features’ı listeler — o Release’in okuduğu çalışma alanındaki belgelerin bildirdiği Features (yalnızca başka Releases’in okuduğu bir katalog dizinindekiler hariç) ve o Release’in derlendiği katalog dizinlerinde bulunanlar — her biri türüyle ve onu bildiren çalışma alanı dosyasıyla ya da çözümlendiği yapılandırılmış katalogla birlikte adlandırılır. Bu liste, o Features’ın uygulandığını bildirdiği şeydir; birini eklemenin başarılı bir derleme üreteceğine dair bir karar değildir — liste boş olduğunda ise hiçbir Feature’ın bildirilmiş uygulanabilirliğinin o etiketlerle eşleşmediğini söyler; bu, hiçbir şeyin eklenemeyeceği ifadesinden daha dar bir ifadedir. Dil sunucusunun yanıtlayamadığı bir istek, listeyi boş bırakmak yerine listenin yerinde bunu belirtir. Çalışma alanının dışına çıkan bir linkin ardında bildirilen bir Feature — dışarıdaki bir dizine giden bir link ya da bir YAML dosyası gibi adlandırılmış olup dışarıdaki bir dosyaya giden bir link — sunulmaz, çünkü dil sunucusu böyle bir link üzerinden hiçbir varlık okumaz; düzenleyicinizin dosya ağacı Feature’ı gösterse bile. Çalışma alanında böyle bir link bulunduğunda, listenin altında ya da boş bir listenin yerini alan cümlenin altında bir satır bunu belirtir: Features reached through this link are not offered, because it leads outside the Aggrega workspace: (Bu link üzerinden ulaşılan Features sunulmaz, çünkü link Aggrega çalışma alanının dışına çıkar:) ardından linkin çalışma alanına göre göreli yolu — ya da birden fazlası için Features reached through these links are not offered, because each leads outside the Aggrega workspace: (Bu linkler üzerinden ulaşılan Features sunulmaz, çünkü her biri Aggrega çalışma alanının dışına çıkar:), önce dizinlere giden linkler. Satır, dil sunucusunun bildirdiği linkleri panelin gösterdiği Release’e göre adlandırır; Catalog paneli de seçili Release’e göre aynısını yapar. Bu bildirim okunamadığında liste satır olmadan çizilir ve neden Aggrega çıkış kanalına yazılır; üretilemeyen bir listede satır bulunmaz.

web bileşeni seçili olan topoloji grafiği ve yanında, ona hiçbir şey eklenmediğini belirten ve May attach altında eklenebilecek Features'ı her biri bir Attach denetimiyle listeleyen panel.

Her satır, onu uygulayan bir Attach denetimi taşır: derleyiciye seçili bileşeni hangi belgenin bildirdiği ve o belgenin içinde böyle bir ekin nereye ait olduğu sorulur ve girdi düzenleyici aracılığıyla oraya yazılır — böylece geri alma geçmişine katılır, diske en son kaydedilen sürüme değil baktığınız arabelleğe düşer ve çevresindeki yorumları ve biçimlendirmeyi yazdığınız gibi bırakır. Sizin adınıza hiçbir şey kaydedilmez; düzenleme diğerleri gibi bir değişikliktir ve derleyici onu herhangi bir düzenlemeden sonra yapacağı gibi yeniden doğrular. Grafik kaydettiğinizde yeniden çizilir, çünkü topoloji belgelerin diskteki hâlinden derlenir ve hâlâ arabellekte duran bir ek henüz onun parçası değildir. Ek, Feature’ın adını alır ve o adla zaten eklenmiş bir Feature’ı eklemek iki kez yazılmak yerine reddedilir. Bir alt sistemin içinde bildirilen bir bileşen, en üst düzeyde bildirilen bir bileşenle aynı tıklamayla eklenir ve ikisi de aynı nedenle çalışır: grafik bir bileşeni derlenmiş topolojideki konumuyla tanımlar, bu konum bileşenin yazarının hangi anahtarları yazdığını söylemez ve bu nedenle eklenti yeniden oluşturmak yerine sorar — yanıt belgeyi ve içindeki bloğa giden yolu adlandırır ve ikisi de geldikleri gibi düzenlemeye aktarılır. Adlandırılacak böyle bir yer olmadığında — grafiğin taşımadığı bir kimlik, grafiğin hiçbir belge kaydetmediği bir düğüm ya da kendi bloğu yazıldığı belgede adlandırılamayan bir bileşen — panelin gösterdiği, bu eklentinin kendi ifadesi değil, derleyicinin verdiği nedendir.

Seçili bir bağlantının panelinin kendine ait bir May attach bölümü vardır: o bağlantının socket’inin bildirdiği slotlar, bileşenin onları bildirdiği sırayla, her biri zorunlu olup olmadığı, onu dolduran şeyin hassas malzeme işleyip işlemediği, izin verdiği teslim biçimi, seçicisi ve açıklamasıyla birlikte; her slotun altında da dil sunucusunun o bağlantıda o slotu doldurabileceğini yanıtladığı Features — bildirilen uygulanabilirliklerini tüketen bileşenin etiketlerinin karşıladığı ve kendi etiketleri slotun seçicisini karşılayanlar. Hiçbir slotun doldurulamadığı yerde panel nedenini dil sunucusunun terimleriyle söyler — bağlantıyı bir Feature çizmiştir, socket bileşenin bildirmediği bir socket’tir ya da socket hiç slot bildirmez — ve eklenecek hiçbir şey sunmaz. Bir slotun altındaki Attach düğmesine basmak, Feature’ı slotun adıyla, type: alanı Feature’ı adlandıran bir <slot>: girdisi olarak, bağlantıyı çizen belgedeki o bağlantının girdisine yazar: Release’in çizdiği bir bağlantı için Release’e, aksi halde Aggregate’e. Bir belgedeki girdisinden Aggrega: Attach a Feature to the connection at the cursor ile seçilen bir bağlantı ise bunun yerine o belgeye yazılır — Aggregate’in çizdiği bir bağlantı için Release’in kendi girdisinde, Release’e — ve panelin May attach altındaki satırı bu durumda Feature’ın, komutun çalıştırıldığı belgedeki o bağlantının girdisine yazıldığını söyler. Bu girdinin o belgede nereye gideceği derleyiciye sorulur, belgenin henüz içermediği yol parçaları da onunla birlikte yazılır ve düzenleme, bir düğümünkü gibi kaydedilmemiş olarak düzenleyiciye düşer. Grafiğin o bağlantıda zaten dolu gösterdiği bir slot, herhangi bir şey sorulmadan önce reddedilir ve derleyiciden gelen bir ret, derleyicinin kendi sözcükleriyle gösterilir.

Derleyicinin hassas olarak bildirdiği bir değer, dil sunucusu tarafından gönderdiği grafikte saklanır ve grafik görünüme verilmeden önce uzantı tarafından bir kez daha saklanır; böylece gösterilmek üzere görünümde bulunmaz — panel alanı adlandırır ve neden saklandığını söyler; hassasiyet işareti panelin tanımadığı bir biçimde olan bir ek ise tahmin yürütmek yerine tüm değerleri saklar. Bir bağlantı üzerinde çizilen bir ek, bir düğüm üzerinde çizilen bir ekle tam olarak aynı kurala göre, aynı ayar altında saklanır. aggrega.graph.showSensitiveValues, yazdığını geri okuması gereken bir yazar için saklamayı kapatır: grafik isteği bu değerleri dil sunucusundan yalnızca bu ayar açıkken ister ve ayarlar sayfası bunun neyi gösterdiğini söyler.

Düğümler, Release’in dalgalarının ayağa kaldırıldığı sıraya göre yerleştirilir; böylece syncWave: bildiren bir boundary, onu bekleyen boundary’lerin önünde görünür. Bir düğümün üzerine gelindiğinde bileşeni ve çözümlenmiş sürümü, etiketleri, bildirilen dalgası ve katalog varlığının kendi meta verileri — lisans, depo, ana sayfa, anahtar sözcükler ve bakımcılar — gösterilir; yalnızca varlığın gerçekten bildirdiği alanlar gösterilir.

Açık bir grafik, çalışma alanındaki yazılmış bir belge her kaydedildiğinde kendini yeniden işler; böylece yeniden açılmadan düzenlemelerinizi izler. Topoloji diskteki içerikten derlendiği için her tuş vuruşunda değil, kaydetmede yeniden çizilir. Seçili Release’in kilit dosyası yazıldığında da — Aggrega: Pull ile, Auto pull etkin bir derlemeyle ya da bir terminalde aggrega pull ile — yeniden çizilir, çünkü grafik o kilit dosyasına sabitlenmiştir; ayrıca dil sunucusu yeniden yanıt verebilir hale geldiğinde de yeniden çizilir, böylece bir yeniden başlatma boyunca açık bırakılan bir grafik kendi kendine toparlanır.

İstemediğiniz bir yeniden çizim, görünümünüzü koyduğunuz yerde bırakır: yeniden oluşturulan topoloji farklı olsun ya da olmasın, sahip olduğunuz kaydırma ve yakınlaştırma korunur; böylece yeniden oluşturulan düzenin eski yerine koyduğu bir düğüm panelin aynı bölümünün altında kalır, başka bir yere koyduğu bir düğüm ise — eklenen bir bileşen çevresindekileri kaydırabilir — görünümü kendisiyle birlikte götürmek yerine koruduğunuz görünüm içinde hareket eder. Bu, grafik başka bir sekmenin arkasındayken gerçekleşen bir yeniden çizimi de kapsar; o sekmeye döndüğünüzde onu bıraktığınız gibi bulursunuz.

Aggrega: Show topology graph çizimi panele yeniden sığdırır; bir bölümünü yakınlaştırdıktan sonra bütün şekle dönmenin yolu budur. Büyük bir topoloji kırpılmak yerine bütün olarak sığdırılır, bu yüzden büyük bir topoloji küçük görünür: nasıl bir araya getirildiğini görürsünüz ve adlara yakınlaştırarak ulaşırsınız. Tek bir kutuda tutulan iki veya daha fazla gruplamanın genişliğinden daha uzun yerleşeceği yerde, bunlar tek bir sütunda üst üste yığılmak yerine yan yana çizilir; böylece büyük bir topoloji panelin genişliğini kullanır ve ilk sığdırması onu tek bir sütunun izin vereceğinden daha büyük çizer.

Derleyicinin reddettiği bir yeniden oluşturma, sahip olduğunuz çizimi boşaltmak yerine korur — topoloji hâlâ okunmaya değerdir ve hâlâ çalıştığınız yerdedir — ve onu soluklaştırır; böylece artık güncel olmayan bir çizim güncel bir çizim sanılmaz; üstündeki bildirim derleyicinin kendi gerekçesini taşır. Yeni bir çizim oluşturulur oluşturulmaz çizim tam canlılığına döner. Düzen görünümde hesaplanır; derleyici topolojiyi gönderir, asla koordinatları göndermez.