Önemli noktalar
- 01Konsistent girintilendirme ile YAML'i biçimlendir js-yaml ayrıştırıcısı kullanarak — Node.js yapı araçlarında kullanılan aynı kitaplık.
- 02Sözdizimini doğrula ve hatalara yönelik tam satır numaralarını bildir.
- 03YAML ve JSON arasında her iki yönde dönüştür, doğru tür korumasıyla.
- 04Hiçbir şey yüklenmiyor — tüm işlem yerel olarak tarayıcınızda çalışır.
Neden YAML Biçimlendirmesi Yapılandırma Dosyaları için Önemlidir
YAML, Kubernetes, GitHub Actions, Docker Compose, Helm grafikleri ve çok daha fazla aracı için varsayılan yapılandırma dilidir. Ayrıca meşhur derecede girintilendirmeye duyarlı — tek bir yanlış girintili satır sessiz bir tür uyumsuzluğu veya dağıtımı engelleyen sert ayrıştırma hatasını üretebilir. Düzenli biçimlendirme dosyaları tutarlı tutar ve sorunları CI'ya ulaşmadan önce yakalar.
YAML ve JSON arasında dönüştürmek eşit derecede kullanışlı. Bazı araçlar API çağrıları veya şema tanımları için yalnızca JSON'ı kabul ederken, insanlar genellikle uzun vadeli yapılandırma dosyaları için YAML'i tercih eder. Veri türlerini kaybetmeden — sayılar sayılar kalır, booleyanlar booleyanlar kalır — ikisi arasında gidiş-dönüş yapmak zaman tasarrufu yapar ve ince hataları önler.
YAML Nasıl Biçimlendirilir veya Dönüştürülür
- 01
YAML veya JSON'u yapıştır
Kubernetes bildirisini, GitHub Actions iş akışını, Helm değerleri dosyasını veya başka bir YAML belgesini yapıştır. JSON'dan YAML'a dönüşüm için bunun yerine JSON'ı yapıştırın.
- 02
Bir eylem seç
Girintilendirmeyi normalleştirmek ve belgeyi yerinde temizlemek için YAML Biçimlendir'i seçin. Format'ı tamamen değiştirmek için YAML'den JSON'a veya JSON'dan YAML'a seçin.
- 03
Varsa hataları gözden geçir
Girişte bir sözdizimi hatası varsa, araç js-yaml ayrıştırıcısından tam satır numarasını ve nedenini ortaya çıkarır — üretimde göreceğin şeyle eşleşen aynı ayrıştırıcı.
- 04
Çıktıyı kopyala
Biçimlendirilmiş veya dönüştürülen çıktıyı almak için Kopyala'ya tıkla. Yapılandırma dosyasına, bir API gövdesine veya şema tanımına geri yapıştır.
Bu Araç Zamanımızı Kurtarırken
- 01Kubernetes bildirimi sürüklenmişse — taahhüt etmeden önce girintilendirmeyi normalleştir.
- 02GitHub Actions iş akışı ayrıştırılmamışsa — tam hata satırını almak için doğrula.
- 03API yalnızca JSON kabul ediyor, ancak yapılandırma YAML olarak depolanmışsa — tek tıklamayla dönüştür.
- 04Yeni bir hizmet gemisi — Helm grafiği için YAML'ye JSON örneği yükünü dönüştür.
- 05Stack Overflow'dan YAML kopyalanıyorsa — projeni 2 boşluk stilini eşleştirmek için yeniden biçimlendir.
- 06Helm değerleri birleşimini hata ayıklamada — her values.yaml'in bireysel olarak temiz olduğunu doğrula.
Özel, Yükleme Gerekli Değil
Biçimlendirme ve dönüştürme, Webpack, Rollup ve çoğu JavaScript yapı araçlarına paketlenmiş js-yaml kullanarak tarayıcınızda tamamen çalışır. Yapılandırma dosyaları, gizli referanslar ve ortam değişken adları asla cihazınızdan ayrılmaz.
Ayrıştırıcı, Kubernetes, GitHub Actions ve Docker Compose'un tümünün kullandığı YAML 1.2'yi hedefler. Burada bir dosya doğrulanıyorsa, bu araçlarda doğru şekilde yüklenir.
YAML Biçimlendirici SSS
YAML biçimlendirmesi açıklamaları koruyacak mı?
Hayır. js-yaml ayrıştırıcı ayrıştırma sırasında açıklamaları çıkarır — bu tüm JavaScript YAML ayrıştırıcılarının sınırlaması. Önce biçimlendir, sonra açıklamaları manuel olarak geri ekle.
Hangi YAML sürümü bu destekler?
YAML 1.2, Kubernetes, GitHub Actions, Docker Compose ve Helm tarafından kullanılan sürüm. Burada doğrulanan şey bu araçlarda temiz yükler.
YAML'dan JSON'a dönüştürme türleri korur mu?
Evet. Sayılar, booleanlar, null ve tarih dizgeleri doğru gidiş-dönüş yapar. YAML'deki gerçek JSON'da boolean gerçeğine dönüşür, dize 'gerçeği' değil.
Biçimlendirme ve dönüştürme arasında fark nedir?
Biçimlendirme dosyayı YAML olarak tutar ve beyaz boşluk ve girintilendirmeyi normalleştirir. Dönüştürme çıktı biçimini tamamen değiştirir — YAML'dan JSON'a .json-uyumlu bir belge üretir.
YAML'im --- ile ayrılan çoklu belgeler var. Hepsi işlenecek mi?
İlk belge ayrıştırılır ve yeniden yayınlanır. Çoklu belgeli dosyalar için her bölümü --- ayırıcılarına ve işlem bölümlerine bölün.