YAML'deki yorumları nasıl engellersiniz?

YAML'de bir satır bloğunu nasıl yorumlayabilirim?

YAML satır içi yorumları destekler, ancak blok yorumları desteklemez.

Gönderen Vikipedi :

Yorumlar sayı işaretiyle ( #) başlar, satırın herhangi bir yerine başlayabilir ve satırın sonuna kadar devam edebilir

Wikipedia'dan da JSON ile bir karşılaştırma :

Sözdizimi farklılıkları belirsizdir ve pratikte nadiren ortaya çıkar: JSON, UTF-32 gibi genişletilmiş karakter kümelerine izin verir, YAML, JSON olmasa da virgül, eşittir ve iki nokta gibi ayırıcılardan sonra bir boşluk gerektirir ve JSON'un standart olmayan bazı uygulamaları dilbilgisini Javascript'in /* ... */yorumlarını içerir. Bu tür kenar kasaları işlemek, satır içi YAML olarak ayrıştırmadan önce JSON'un hafif ön işleme tabi tutulması gerekebilir.

# If you want to write
# a block-commented Haiku
# you'll need three pound signs

Teknik özellik , yorumları işaretlemenin yalnızca bir yolunu açıklar:

Açık bir yorum “#” göstergesi ile işaretlenir.

Bu kadar. Blok yorum yok.

Bu konuda akıllı olmaya çalışmıyorum, ancak düzenleyiciniz için Sublime Text kullanıyorsanız, adımlar şunlardır:

1. Bloğu seçin
2. cmd/Mac üzerinde + veya Linux ve Windows üzerinde ctrl+/
3. kâr

Diğer editörlerin de benzer işlevselliğe sahip olduğunu hayal ediyorum. Hangisini kullanıyorsun? Biraz kazmaktan mutluluk duyarım.

Vim'de aşağıdakilerden birini yapabilirsiniz:

• Tüm satırları yorumlayın: :%s/^/#
• Yorum satırları 10-15: :10,15s/^/#
• Mevcut satıra 10 numaralı yorum satırı: :10,.s/^/#
• Sonuna kadar yorum satırı 10: :10,$s/^/#

veya görsel blok kullanarak:

1. Üzerinden görsel blok girdikten sonra çok satırlı bir sütun seçin Ctrl+v.
2. Basın rizledi #seçimi yerine çoklu-hat bloğunu açıklama ya Shift+i#Escseçiminden önce açıklama karakterleri girmek için.

Alternatif bir yaklaşım:

Eğer

• YAML yapınız, uygulamanız tarafından kullanılacak iyi tanımlanmış alanlara sahip
• VE uygulamanızla uğraşmayacak ek alanları özgürce ekleyebilirsiniz

sonra

• herhangi bir düzeyde "Açıklama" veya "Yorum" veya "Notlar" gibi bir blok metin alanı ekleyebilirsiniz.

Misal:

Onun yerine

# This comment
# is too long

kullanım

Description: >
  This comment
  is too long

veya

Comment: >
    This comment is also too long
    and newlines survive from parsing!

Diğer avantajlar:

1. Yorumlar büyük ve karmaşık hale gelirse ve yinelenen bir desene sahipse, bunları düz metin bloklarından nesnelere yükseltebilirsiniz.
2. Uygulamanız - gelecekte - bu yorumları okuyabilir veya güncelleyebilir

YAML'de yorum yapmayı engellemenin bir yolu, aynı anda birden çok satıra # (yorum) etiketi eklemek için Notepad ++ gibi bir metin düzenleyicisi kullanmaktır.

Notepad ++ uygulamasında, seçili metin için "Yorumu Engelle" sağ tıklatma seçeneğini kullanarak bunu yapabilirsiniz.

Eclipse'yi yedit eklentisiyle (.yaml dosyaları için bir düzenleyici) kullanıyorsanız, birden fazla satırı aşağıdaki yollarla yorumlayabilirsiniz:

1. yorumlanacak satırları seçme ve ardından
2. Ctrl+ Shift+C

Yorum kaldırmak için aynı adımları uygulayın.

Windows'ta Ruby Mine kullanıcıları için:

Dosyayı düzenleyicide aç Bloğu seçin ve Ctrl+ tuşuna basın forward slash, # ile başlayan bloğu seçmiş olacaksınız.

Şimdi yorum yapılan bloğun yorumunu kaldırmak istiyorsanız, aynı tuş kombinasyonuna Ctrl+ forward slashtekrar basın

Emacs, comment-dwim (Ne demek istediğimi yap) - sadece bloğu seç ve bir yap:

M-;

Bu bir geçiş - yorum ve yorum bloklarını yorumlamak için kullanın.

Yüklü mod modu yoksa Emacs'a karma karakterini (#) kullanmasını söylemeniz gerekir.

Visual Studio Code (VSCode) kullanıcıları için, birden çok satıra yorum yazmanın kısayolu, yorum yapmak istediğiniz satırları vurgulamak ve ardından şu tuşa basmaktır:

ctrl + /

ctrl+ Düğmesine /tekrar basılması , seçilen bir veya daha fazla satır için yorumları kapatmak için de kullanılabilir.

Azure Devops tarayıcısında (ardışık düzen yaml düzenleyicisi),

Ctrl+ K+ CYorum Bloğu

Ctrl+ K+ UOnay Engeli

Bir de 'Blok Açıklamasını Aç / Kapat' seçeneği var ama bu benim için işe yaramadı.

Başka 'garip' yollar da var: 'Komut Paleti'ni görmek için sağ tıklayın veya F1

Ardından bir imleç seçeneği seçin.

Şimdi bu sadece #

hatta daha akıllı [ Ctrl+ k] + [ Ctrl+ c]