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

Halaman sambutan

Halaman sambutan — halaman milik Aggrega di tab editornya sendiri, yang menjelaskan apa itu Aggrega lalu mencantumkan apa yang dibutuhkan ekstensi di ruang kerja ini, dengan menandai setiap kondisi sebagai Met atau To do. Setiap langkah menawarkan cara untuk membuat hal tersebut dan cara untuk menunjuk yang sudah Anda miliki, menjelaskan kondisinya, dan langkah yang sudah terpenuhi tidak menanyakan apa pun. Langkah yang bertanda Met kembali menjadi To do jika kondisinya hilang. Langkah yang sudah terpenuhi terbuka dalam keadaan terlipat, sehingga halaman terbuka pada pekerjaan yang tersisa. Setiap langkah juga menampilkan nilai yang sedang berlaku — root ruang kerja, kompiler, Release, registry — lebih besar dan lebih tebal daripada panduannya, diawali oleh Selected:, di bawah judul ketika langkah terlipat dan tepat di atas tombol ketika terbuka, dan menyatakannya dengan kata-kata jika Anda belum memilih — None selected. jika ada sesuatu untuk dipilih, None available. jika sama sekali tidak ada yang bisa dipilih. Bagian bawahnya memuat kotak centang yang menentukan apakah halaman terbuka saat startup, sakelar yang sama dengan yang ada di layar pengaturan, di bawahnya versi ekstensi dan kompiler yang sedang Anda jalankan, dan terakhir apakah server bahasa sedang berjalan serta versi yang dilaporkannya. Ikon rumah di bilah judul panel Commands membukanya lagi kapan saja. Halaman ini tidak menyita ruang tampilan Aggrega.

Welcome to Aggrega! terbuka di tab editornya sendiri. Halaman ini menjelaskan apa itu Aggrega, lalu mencantumkan apa yang dibutuhkan ekstensi di ruang kerja yang Anda buka:

  1. Ruang kerja yang dikenali Aggrega — penemuan yang dijelaskan di Prasyarat.
  2. Kompiler yang dapat dijalankan editor ini — biner aggrega yang ditunjuk di aggrega.server.binaryPath.
  3. Release untuk dikerjakan — build, pratinjau, dan grafik topologi masing-masing bekerja pada satu Release.
  4. Registry untuk resolusi — menarik dependensi dan mencari katalog yang diterbitkan diresolusikan terhadap registry yang ditunjuk konfigurasi Anda.

Setiap langkah menjelaskan untuk apa kondisi tersebut dan bagaimana editor mencapainya, sehingga halaman ini menjadi tempat untuk membaca tentang produk, bukan sekadar daftar periksa.

Tab Welcome to Aggrega! di folder yang belum dikenali Aggrega, dengan langkah pertamanya, Ruang kerja yang dikenali Aggrega, bertanda belum dikerjakan dan terbuka pada penjelasannya.

Setiap langkah menawarkan lebih dari satu jalan, dan salah satunya selalu “Saya sudah punya ini.” Anda dapat membuat konfigurasi ruang kerja atau mengarahkan editor ke folder yang sudah memuatnya; menggunakan kompiler di PATH Anda, memilih build yang Anda miliki di tempat lain, atau mengunduhnya; membuat draf Release atau memilih salah satu milik Anda; mengisi hub resmi, menunjuk registry Anda sendiri, atau menambahkan registry ke konfigurasi yang sudah Anda miliki. Tidak ada jalan buntu di sini yang hanya menyodorkan dialog file lalu membiarkan langkahnya tetap belum selesai.

Langkah yang sudah Anda penuhi dicentang dan tidak menanyakan apa pun. Halaman membaca keadaan yang sebenarnya alih-alih mengajukan pertanyaan yang sama kepada semua orang, sehingga jika Anda membangun konfigurasi dari baris perintah lalu membuka editor, setiap langkah sudah tercentang.

Setiap langkah dapat dilipat, dan halaman terbuka dengan menampilkan apa yang masih diperlukan. Tanda sisipan di kanan atas setiap langkah membuka dan menutupnya. Langkah yang kondisinya sudah terpenuhi terbuka dalam keadaan terlipat, dan langkah yang belum terpenuhi terbuka dengan penjelasannya di hadapan Anda — sehingga yang Anda baca adalah pekerjaan yang masih tersisa, bukan pekerjaan yang sudah selesai. Langkah yang terlipat tetap mempertahankan judul dan setiap tombolnya, dan hanya menyembunyikan penjelasan: setelah Anda tahu untuk apa sebuah langkah, Anda tetap dapat menjalankannya tanpa membacanya lagi.

Susunannya ditentukan saat halaman dibuat dan setelah itu menjadi milik Anda. Langkah yang menjadi terpenuhi saat Anda sedang membacanya memperbarui tandanya dan tetap terbuka — langkah itu tidak terlipat di bawah kursor Anda — dan tanda sisipan yang Anda tekan tetap di posisi yang Anda tetapkan, berapa kali pun halaman disegarkan di sekitarnya. Menutup dan membuka kembali halaman akan membaca ulang kondisinya dan menyusunnya dari awal. Begitu pula halaman yang digambar sebagai pengganti halaman yang sedang Anda buka ketika editor memulai ulang ekstensinya — seperti saat folder ditambahkan ke jendela yang terbuka pada satu folder: halaman yang Anda miliki ditutup dan halaman baru digambar di grup tab yang sama, terlepas dari apakah halaman diatur untuk terbuka saat startup, sehingga jendela tetap memuat satu halaman dan halaman itu mengikuti ruang kerja tempat Anda berada.

Setiap langkah juga menampilkan nilai yang sedang berlaku, sehingga halaman menjawab yang mana dan bukan hanya apakah: root ruang kerja, kompiler, Release, dan registry yang dideklarasikan konfigurasi. Nilai ditampilkan lebih besar dan lebih tebal daripada penjelasan di sekitarnya, karena nilai yang digambar dengan ketebalan yang sama dengan sekumpulan teks harus dicari-cari. Langkah yang terlipat menampilkannya di bawah judul, sehingga Anda dapat memastikan pilihan Anda tanpa membuka apa pun; langkah yang terbuka menampilkannya di akhir penjelasan, tepat di atas tombol, sehingga menjadi hal terakhir yang dibaca sebelum Anda bertindak. Nilai yang dipilih diawali oleh Selected:, yang ditampilkan lebih kecil dan lebih tipis daripada nilainya sendiri sehingga label tersebut menunjuk ke nilai alih-alih bersaing dengannya.

Halaman sambutan di ruang kerja yang telah dikonfigurasi, dengan langkah kompiler, Release, dan registry bertanda terpenuhi dan terlipat, masing-masing menampilkan nilai yang dipilih di atas tombolnya, serta di bagian bawah kotak centang startup, versi, dan status server bahasa.

Jika Anda belum memilih, langkah tersebut menyatakannya dengan kata-kata alih-alih meninggalkan baris kosong, yang akan terbaca seolah halaman gagal digambar — dan langkah itu membedakan dua keadaan yang ditanggapi pembaca secara berbeda. None selected. berarti ada sesuatu untuk dipilih tetapi Anda belum memilih satu pun. None available. berarti sama sekali tidak ada yang bisa dipilih di sini, sehingga menekan “I already have one” pada langkah tersebut hanya akan menampilkan daftar kosong dan yang Anda perlukan adalah jalan lainnya. Hanya dua langkah yang menawarkan daftar yang dapat menampilkan None available. — ruang kerja dan Release. Kompiler ditunjuk namanya dan registry didaftarkan secara langsung, sehingga kedua langkah tersebut tidak memiliki daftar yang bisa kosong. Langkah registry mempertahankan tampilan ketiga, Not read yet., untuk saat kompiler tidak dapat ditanyai: memberi tahu Anda bahwa Anda belum mengonfigurasi apa pun ketika tidak ada yang dapat menjawab berarti menyatakan lebih dari yang diketahui halaman.

Tanda sebuah langkah mengikuti kondisinya ke dua arah. Setiap langkah menyatakan statusnya dengan kata-kata di samping tandanya — Met atau To do — karena tanda itu sendiri adalah glif, dan glif saja membiarkan maknanya ditebak. Sebuah langkah menampilkan Met ketika kondisinya menjadi benar dan kembali menampilkan To do jika kondisinya kemudian hilang — kompiler yang berhenti merespons, Release yang batal dipilih. Halaman membaca keadaan yang sebenarnya setiap kali disegarkan alih-alih mengingat apa yang pernah benar, sehingga halaman tidak pernah melaporkan sesuatu yang sejak itu telah hilang dari Anda. Jika hilangnya kondisi itu penting, hal itu juga dilaporkan di tempat yang sudah Anda lihat: bilah status menampilkan kompiler yang berhenti merespons, dan baris Project folder, Aggrega workspace, dan Release di bagian atas panel Commands menyebutkan pilihan saat ini.

Halaman ini sengaja berupa tab editor biasa, bukan dialog: setiap langkah meminta Anda menunjuk sesuatu di ruang kerja Anda sendiri, dan dialog akan menutupi file-file yang memuat jawabannya. Halaman berada di area editor, bukan di tampilan Aggrega, sehingga tidak menyita ruang bilah samping dan dapat menjelaskan apa produk ini — hal yang tidak muat di kolom sempit. Ini adalah tab milik Aggrega sendiri, dibuka dan ditutup dengan caranya sendiri, dan tidak menawarkan jalan masuk ke halaman sambutan milik editor.

Halaman memuat keputusan itu di bagian bawahnya, di tengah, dan Command Palette juga memuatnya. Keduanya mengubah satu pengaturan yang sama, aggrega.getStarted.show, yang ditulis ke pengaturan Anda sendiri — tidak pernah ke repositori, sehingga pilihan Anda tidak terbawa ke orang lain yang membukanya. Kontrol di bagian bawah adalah kotak centang bertuliskan Show Aggrega welcome page on startup, yang tercentang selama halaman terbuka saat startup — sehingga kotak itu melaporkan pengaturan sebagaimana adanya alih-alih menawarkan tindakan yang akan mengubahnya. Matikan di layar pengaturan dan kotak centang mengikutinya; tekan kotak centang dan layar pengaturan mengikutinya. Ini adalah satu sakelar di dua tempat, bukan dua sakelar. Kotak centang tetap memegang fokus keyboard saat ditekan, sehingga tombol Space mencentang dan menghapus centangnya secara bergantian.

Mematikannya hanya menghentikan halaman terbuka saat startup, bukan membuatnya tidak terjangkau, dan ini bukan pintu satu arah: Aggrega: Get started di Command Palette menyalakannya kembali dan membuka halaman, dan Aggrega: Stop opening the welcome page on startup adalah jalan palet sendiri menuju pengaturan yang sama.

Panel Commands menyediakan jalan kembali ke halaman, di samping ikon roda gigi. Itu adalah ikon rumah di kanan atas, dan tooltip-nya berbunyi Open the welcome page — sehingga kembali ke halaman adalah sesuatu yang Anda temukan dengan melihat tampilan Aggrega, bukan sesuatu yang harus Anda ketahui untuk diketik. Ikon itu membuka halaman dan membiarkan pengaturan startup Anda tepat seperti yang Anda tetapkan: melihat halaman lagi tidak menyalakannya kembali. Perintah palet yang melakukannya, karena menyalakannya kembali adalah sebuah keputusan, bukan sekilas pandang.

Halaman melaporkan apa yang sedang Anda jalankan, di bagian bawahnya. Ada dua tampilan versi di sana: Extension, build ekstensi ini mana yang dimuat editor Anda, dan Compiler, apa yang dinyatakan biner aggrega yang dijalankan server bahasa tentang dirinya sendiri. Tampilan Extension dicatat saat ekstensi dibangun, dari keadaan sumbernya pada saat itu, dalam bentuk yang sama dengan yang digunakan build kompiler sendiri untuk versinya — sehingga jendela pengembangan, salinan yang terpasang, dan salinan yang dikemas dari pohon yang telah diedit masing-masing menyatakan dirinya yang mana:

  • tag rilis saja, seperti 0.2.0, berarti build tersebut tepat rilis itu;
  • tag yang diikuti hitungan dan commit, seperti 0.2.0-3-g1a2b3c4, berarti build dari commit 1a2b3c4, tiga commit setelah rilis tersebut — dan commit saja, seperti 1a2b3c4, berarti build dari commit itu ketika tidak ada rilis yang mendahuluinya;
  • akhiran -dirty pada salah satu bentuk ini berarti build dibuat dari salinan sumber yang memuat perubahan yang belum di-commit;
  • dev berarti build dibuat di tempat riwayat sumber tidak dapat dibaca.

Tidak satu pun tampilan ditulis ke dalam halaman — keduanya dibaca saat halaman digambar, sehingga build pengembangan melaporkan dirinya sebagai build pengembangan alih-alih tidak menampilkan apa pun, dan memulai ulang dengan kompiler lain akan mengubah tampilannya. Jika suatu tampilan tidak dapat diambil — ekstensi dibangun tanpa mencatat build mana dirinya, tidak ada yang berjalan untuk ditanyai, atau yang berjalan tidak menjawab — labelnya tetap ada dan menyatakan bahwa versinya tidak dilaporkan, sehingga tampilan yang tidak ada tidak pernah disangka sebagai tampilan yang luput dari perhatian Anda.

Baris terakhir halaman menyatakan apakah server bahasa sedang berjalan, dan build mana itu. Baris itu berbunyi Language server running, starting, not running, atau failed to start, dengan kata-kata yang sama yang digunakan bilah status dan notifikasi; failed to start berarti upaya terakhir untuk memulainya gagal dan tidak ada yang berjalan sejak itu. Kanal output Aggrega menyebutkan alasannya, begitu pula notifikasi yang muncul ketika start pertama atau mulai ulang gagal. Selama server berjalan, baris itu menambahkan versi yang dilaporkan server yang berjalan tentang dirinya saat ekstensi terhubung dengannya, ditulis dengan cara tampilan Compiler menulis versi. Tampilan Compiler di atasnya adalah fakta yang berbeda: itu adalah apa yang dinyatakan biner tempat server dimulai ketika ditanyai, dan keduanya berbeda ketika file di path tersebut diganti sementara server yang dimulai darinya terus berjalan, sehingga halaman menampilkan keduanya. Server bahasa yang tidak melaporkan versinya sendiri menampilkan version not reported di sana, alih-alih meminjam versi biner. Baris itu dan dua tampilan di atasnya mengikuti server saat server dimulai, berhenti, dimulai ulang, atau gagal, tanpa perlu membuka ulang halaman; langkah-langkah mempertahankan tandanya selama mulai ulang.