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

Hoş geldiniz sayfası

Hoş geldiniz sayfası — Aggrega’nın kendi düzenleyici sekmesindeki kendi sayfası; Aggrega’nın ne olduğunu söyler, ardından bu çalışma alanında uzantının nelere ihtiyaç duyduğunu listeler ve her koşulu Met veya To do olarak işaretler. Her adım, gereken şeyi oluşturmanın bir yolunu ve zaten sahip olduğunuz birini göstermenin bir yolunu sunar, koşulu açıklar ve zaten karşılanmış bir adım size hiçbir şey sormaz. Met olarak işaretlenmiş bir adım, koşulu ortadan kalkarsa To do durumuna geri döner. Zaten karşılanmış bir adım katlanmış olarak açılır; böylece sayfa kalan iş üzerinde açılır. Her adım şu anda neyde durduğunu da gösterir — çalışma alanı kökü, derleyici, Release, kayıt defterleri — yönergelerden daha büyük ve daha kalın, önünde Selected: etiketiyle, adım katlanmışken başlığın altında, açıkken düğmelerin hemen üstünde gösterir ve henüz seçim yapmadığınız yerde bunu sözcüklerle söyler — seçilecek bir şey olduğunda None selected., seçilecek hiçbir şey olmadığında None available.. Altında, sayfanın başlangıçta açılıp açılmayacağına karar veren onay kutusu — ayarlar ekranındakiyle aynı anahtar —, onun altında çalıştırdığınız uzantının ve derleyicinin sürümleri ve son olarak dil sunucusunun çalışıp çalışmadığı ve bildirdiği sürüm bulunur. Commands paneli başlık çubuğundaki bir ev simgesi sayfayı istediğiniz zaman yeniden açar. Aggrega görünümünde yer kaplamaz.

Welcome to Aggrega! kendi düzenleyici sekmesinde açılır. Aggrega’nın ne olduğunu söyler, ardından açık olan çalışma alanında uzantının nelere ihtiyaç duyduğunu listeler:

  1. Aggrega’nın tanıdığı bir çalışma alanı — Ön koşullar bölümünde açıklanan keşif.
  2. Bu düzenleyicinin çalıştırabileceği bir derleyici — aggrega.server.binaryPath içinde belirtilen aggrega ikili dosyası.
  3. Üzerinde işlem yapılacak bir Release — derleme, önizleme ve topoloji grafiğinin her biri tek bir Release üzerinde işlem yapar.
  4. Çözümleme yapılacak bir kayıt defteri — bağımlılıkları çekme ve yayımlanmış kataloğu arama, yapılandırmanızın belirttiği kayıt defterlerine göre çözümlenir.

Her adım, koşulun ne işe yaradığını ve düzenleyicinin ona nasıl ulaştığını açıklar; böylece sayfa yalnızca bir denetim listesi değil, ürün hakkında okunacak bir yerdir.

Aggrega'nın henüz tanımadığı bir klasördeki Welcome to Aggrega! sekmesi; ilk adımı olan Aggrega'nın tanıdığı bir çalışma alanı, yapılacak olarak işaretlenmiş ve açıklaması açık.

Her adım birden fazla yol sunar ve bunlardan biri her zaman “Bu zaten bende var” seçeneğidir. Bir çalışma alanı yapılandırması oluşturabilir veya düzenleyiciyi zaten bir yapılandırma taşıyan bir klasöre yönlendirebilirsiniz; PATH üzerindeki derleyiciyi kullanabilir, başka bir yerde bulunan bir derlemeyi seçebilir veya bir tane indirebilirsiniz; bir Release taslağı oluşturabilir veya kendi Release’lerinizden birini seçebilirsiniz; resmî hub’ı ekleyebilir, kendi kayıt defterinizi adlandırabilir veya zaten sahip olduğunuz bir yapılandırmaya kayıt defteri ekleyebilirsiniz. Burada size bir dosya iletişim kutusu verip adımı hâlâ yapılacak olarak bırakan bir çıkmaz sokak yoktur.

Zaten karşıladığınız bir adım işaretlenir ve size hiçbir şey sormaz. Sayfa herkese aynı soruları sormak yerine gerçek durumu okur; bu nedenle yapılandırmanızı komut satırından oluşturup ardından düzenleyiciyi açtıysanız her adım işaretlenmiş olarak gelir.

Her adım katlanır ve sayfa hâlâ gerekenleri göstererek açılır. Her adımın sağ üstündeki bir şapka işareti adımı açar ve kapatır. Koşulu zaten karşılanmış bir adım katlanmış olarak açılır, karşılanmamış bir adım ise açıklaması önünüzde olacak şekilde açılır — böylece okuduklarınız yapmış olduğunuz işle değil, hâlâ yapmanız gereken işle ilgilidir. Katlanmış bir adım başlığını ve tüm düğmelerini korur ve yalnızca açıklamayı gizler: bir adımın ne işe yaradığını öğrendikten sonra, onu yeniden okumadan üzerinde işlem yapabilirsiniz.

Düzen, sayfa oluşturulduğunda belirlenir ve bundan sonra size aittir. Siz okurken karşılanan bir adım işaretini günceller ve açık kalır — imlecinizin altında katlanmaz — ve bastığınız bir şapka işareti, sayfa çevresinde kaç kez yenilenirse yenilensin bıraktığınız yerde kalır. Sayfayı kapatıp yeniden açmak koşulları yeniden okur ve sayfayı baştan düzenler. Düzenleyiciniz uzantılarını yeniden başlattığında, açık olan sayfanın yerine çizilen sayfa da öyle yapar — tek bir klasörde açık bir pencereye klasör eklendiğinde olduğu gibi: sahip olduğunuz sayfa kapatılır ve sayfanın başlangıçta açılmak üzere ayarlanıp ayarlanmadığından bağımsız olarak aynı sekme grubunda yeni bir sayfa çizilir; böylece pencere tek bir sayfa tutmaya devam eder ve bu sayfa içinde bulunduğunuz çalışma alanını izler.

Her adım şu anda neyde durduğunu da gösterir; böylece sayfa yalnızca olup olmadığını değil hangisi olduğunu da yanıtlar: çalışma alanı kökü, derleyici, Release ve yapılandırmanın bildirdiği kayıt defterleri. Değer, çevresindeki açıklamadan daha büyük ve daha kalın yazılır, çünkü bir metin yığınıyla aynı kalınlıkta çizilmiş bir değeri aramanız gerekir. Katlanmış bir adım onu başlığın altında gösterir, böylece hiçbir şeyi açmadan seçiminizi doğrulayabilirsiniz; açık bir adım ise onu açıklamanın sonunda, düğmelerin hemen üstünde gösterir; orada, işlem yapmadan önce okunan son şeydir. Seçilen bir değerin önünde, değerin kendisinden daha küçük ve daha ince yazılan Selected: etiketi bulunur; böylece etiket değerle yarışmak yerine değeri işaret eder.

Yapılandırılmış bir çalışma alanındaki hoş geldiniz sayfası; derleyici, Release ve kayıt defteri adımları karşılanmış olarak işaretlenmiş ve katlanmış, her biri düğmelerinin üstünde seçili değerini gösteriyor; altta başlangıç onay kutusu, sürümler ve dil sunucusunun durumu yer alıyor.

Henüz seçim yapmadığınız yerde adım bunu boş bir satır bırakmak yerine sözcüklerle söyler; boş satır, sayfanın çizilemediği şeklinde okunurdu — ve okurun farklı biçimde hareket ettiği iki durumu birbirinden ayırır. None selected., seçilecek bir şey olduğu ancak hiçbirinin seçilmediği anlamına gelir. None available., burada seçilecek hiçbir şey olmadığı anlamına gelir; bu nedenle adımın “I already have one” seçeneğine basmak size yalnızca boş bir liste gösterebilir ve istediğiniz şey adımın diğer yoludur. Yalnızca liste sunan iki adım — çalışma alanı ve Release — None available. gösterebilir. Bir derleyici adıyla belirtilir ve bir kayıt defteri doğrudan kaydedilir; bu nedenle bu adımların hiçbirinde boş olabilecek bir liste yoktur. Kayıt defteri adımı, derleyiciye sorulamadığı durum için üçüncü bir gösterim olan Not read yet. gösterimini tutar: hiçbir şey yanıt veremezken hiçbir şey yapılandırmadığınızı söylemek, sayfanın bildiğinden fazlasını söylemek olurdu.

Bir adımın işareti, koşulunu her iki yönde de izler. Her adım, işaretin yanında durumunu sözcüklerle belirtir — Met veya To do — çünkü işaretin kendisi bir gliftir ve tek başına bir glif anlamını tahmine bırakır. Bir adım, koşulu doğru olduğunda Met, koşul daha sonra ortadan kalkarsa yeniden To do gösterir — yanıt vermeyi bırakan bir derleyici, seçimi kaldırılan bir Release. Sayfa, bir zamanlar doğru olanı hatırlamak yerine her yenilendiğinde gerçek durumu okur; bu nedenle o zamandan beri kaybettiğiniz bir şeyi asla bildirmez. Ortadan kalkmanın önemli olduğu yerde bu, zaten baktığınız yerde de bildirilir: durum çubuğu yanıt vermeyi bırakmış bir derleyiciyi gösterir ve Commands panelinin üstündeki Project folder, Aggrega workspace ve Release satırları geçerli seçimi adlandırır.

Bir iletişim kutusu yerine sıradan bir düzenleyici sekmesi olması bilinçli bir tercihtir: her adım sizden kendi çalışma alanınızdaki bir şeyi göstermenizi ister ve bir iletişim kutusu yanıtları içeren dosyaların üzerini örterdi. Aggrega görünümünde değil düzenleyici alanında yer alır; böylece kenar çubuğunda yer kaplamaz ve ürünün ne olduğunu söyleyebilir — dar bir sütunun buna yeri yoktur. Aggrega’nın kendi sekmesidir, kendi koşullarıyla açılır ve kapanır ve düzenleyicinin kendi hoş geldiniz sayfasına bir yol sunmaz.

Sayfa bu kararı altında, ortalanmış olarak taşır ve Komut Paleti de taşır. Her ikisi de tek bir ayarı, aggrega.getStarted.show ayarını değiştirir ve bu ayar sizin kendi ayarlarınıza yazılır — asla depoya yazılmaz; bu nedenle seçiminiz depoyu açan başka birine taşınmaz. Alttaki denetim, Show Aggrega welcome page on startup yazan bir onay kutusudur ve sayfa başlangıçta açılırken işaretlidir — yani ayarı değiştirecek eylemi sunmak yerine ayarın mevcut durumunu bildirir. Ayarlar ekranında kapatırsanız onay kutusu bunu izler; onay kutusuna basarsanız ayarlar ekranı bunu izler. İki anahtar değil, iki yerde bulunan tek bir anahtardır. Onay kutusu basıldığında klavye odağını korur; bu nedenle Space tuşu onu sırayla işaretler ve işaretini kaldırır.

Kapatmak, sayfanın başlangıçta açılmasını durdurur, sayfayı erişilemez hâle getirmez ve tek yönlü bir kapı değildir: Komut Paleti’ndeki Aggrega: Get started ayarı yeniden açar ve sayfayı açar; Aggrega: Stop opening the welcome page on startup ise paletin aynı ayara giden kendi yoludur.

Commands paneli, dişli simgesinin yanında sayfaya geri dönmenin bir yolunu taşır. Sağ üstteki ev simgesidir ve araç ipucu Open the welcome page şeklindedir — böylece sayfaya geri dönmek, yazmayı bilmeniz gereken bir şey değil, Aggrega görünümüne bakarak bulduğunuz bir şeydir. Sayfayı açar ve başlangıç ayarınızı tam bıraktığınız yerde bırakır: sayfaya yeniden bakmak ayarı yeniden açmaz. Bunu palet komutu yapar, çünkü ayarı yeniden açmak bir göz atma değil bir karardır.

Sayfa, altında neyi çalıştırdığınızı bildirir. Orada iki sürüm göstergesi bulunur: düzenleyicinizin bu uzantının hangi derlemesini yüklediğini gösteren Extension ve dil sunucusunun çalıştırdığı aggrega ikili dosyasının kendisi hakkında söylediğini gösteren Compiler. Extension göstergesi, uzantı derlendiğinde, o andaki kaynağın durumundan, derleyicinin kendi derlemesinin sürümü için kullandığı biçimle kaydedilir — böylece bir geliştirme penceresi, yüklü bir kopya ve düzenlenmiş bir ağaçtan paketlenmiş bir kopya her biri hangisi olduğunu söyler:

  • 0.2.0 gibi tek başına bir sürüm etiketi, derlemenin tam olarak o sürüm olduğu anlamına gelir;
  • 0.2.0-3-g1a2b3c4 gibi ardından bir sayı ve bir commit gelen bir etiket, o sürümden üç commit sonraki 1a2b3c4 commit’inden bir derleme anlamına gelir — 1a2b3c4 gibi tek başına bir commit ise öncesinde hiçbir sürüm bulunmayan o commit’ten bir derleme anlamına gelir;
  • bunlardan herhangi birindeki -dirty soneki, derlemenin commit edilmemiş değişiklikler taşıyan bir kaynak kopyasından yapıldığı anlamına gelir;
  • dev, derlemenin kaynağın geçmişinin okunamadığı bir yerde yapıldığı anlamına gelir.

Göstergelerin hiçbiri sayfaya yazılmaz — ikisi de sayfa çizildiğinde okunur; bu nedenle bir geliştirme derlemesi hiçbir şey göstermemek yerine kendini geliştirme derlemesi olarak bildirir ve farklı bir derleyiciyle yeniden başlatmak göstergeyi değiştirir. Bir gösterge alınamadığında — uzantı hangi derleme olduğu kaydedilmeden derlenmişse, sorulacak çalışan bir şey yoksa veya çalışan şey yanıt vermediyse — etiket yerinde kalır ve sürümün bildirilmediğini söyler; böylece eksik bir gösterge asla gözünüzden kaçmış bir gösterge sanılmaz.

Sayfanın son satırı, dil sunucusunun çalışıp çalışmadığını ve hangi derleme olduğunu söyler. Durum çubuğu ve bildirimlerle aynı sözcüklerle Language server running, starting, not running veya failed to start gösterir; failed to start, en son başlatma denemesinin başarısız olduğu ve o zamandan beri hiçbirinin çalışmadığı anlamına gelir. Nedenini Aggrega çıktı kanalı söyler; ilk başlatma veya yeniden başlatma başarısız olduğunda gösterilen bildirim de söyler. Sunucu çalışırken satır, uzantı sunucuya bağlandığında çalışan sunucunun kendisi hakkında bildirdiği sürümü, Compiler göstergesinin sürüm yazdığı biçimde ekler. Üstündeki Compiler göstergesi farklı bir olgudur: sunucunun başlatıldığı ikili dosyanın sorulduğunda söylediğidir ve o yoldaki dosya değiştirilirken ondan başlatılmış sunucu çalışmaya devam ettiğinde ikisi farklılaşır; bu nedenle sayfa her ikisini de gösterir. Kendi sürümünü bildirmeyen bir dil sunucusu, ikili dosyanınkini ödünç almak yerine orada version not reported gösterir. Satır ve üstündeki iki gösterge, sayfa yeniden açılmadan sunucuyu başlarken, dururken, yeniden başlarken veya başarısız olurken izler; adımlar yeniden başlatma boyunca işaretlerini korur.