YAML Biçimlendirici

Biçimlendirme bu tarayıcıda çalışır. YAML içeriğiniz hiçbir yere yüklenmez.

En fazla 1.000.000 karakter ve en fazla 100 belge içeren YAML yapıştırın. Biçimlendirme bu tarayıcıda yapılır.

YAML söz dizimi konusunda hoşgörülü, girinti konusunda acımasızdır. Tek bir kayan boşluk, bir anahtarı sessizce liste öğesine çevirebilir; karışık girinti ise kod incelemelerini işkenceye dönüştürür. Bu biçimlendirici girdinizi js-yaml motoruyla (YAML 1.2 core şeması) doğrudan tarayıcınızda ayrıştırır, ardından seçtiğiniz girinti, koleksiyon stili, tırnak kullanımı, anahtar sırası ve satır genişliğiyle yeniden üretir; böylece yapılandırmalar sürüm kontrolünde temiz diff verir ve tüm katkıda bulunanlar için okunabilir kalır.

YAML nasıl biçimlendirilir

  1. 1

    YAML'ı yapıştırın

    Tek akışta 1.000.000 karaktere ve 100 belgeye kadar. Hiçbir şey yüklenmez: ayrıştırma tarayıcınızda çalışır.

  2. 2

    Seçenekleri belirleyin

    Girinti genişliği, blok veya akış stili, tırnak kullanımı, anahtar sıralaması ve satır genişliği.

  3. 3

    Biçimlendirin

    Araç her belgeyi kanonik boşluklarla ve seçtiğiniz stille yeniden kurar.

  4. 4

    Kopyalayıp commit edin

    Çıktı, yapısal olarak birebir aynı YAML'dır; yapılandırmanıza geri yapıştırmaya hazırdır.

Önce ve sonra

Dağınık girdi:

server:
  port:   8080
  hosts: ["api.example.com",  "api2.example.com"]
  timeout:  30
  debug: true

Biçimlendirilmiş (2 boşluk, blok stili):

server:
  port: 8080
  hosts:
    - api.example.com
    - api2.example.com
  timeout: 30
  debug: true

Biçimlendirme seçenekleri

Seçenek Değerler Varsayılan
Girinti genişliği 2, 4 2
Koleksiyon stili Blok, akış Blok
Tırnak kullanımı Minimal, çift, tek Minimal
Anahtar sıralaması Orijinal, alfabetik Orijinal
Satır genişliği 80, 120, sınırsız 120

Tırnak kuralları

Minimal tırnak genellikle tam istediğiniz şeydir: çıplak bırakmak güvensiz olmadıkça dizeler tırnaksız kalır. Biçimlendirici şunlar için tırnağı otomatik ekler:

  • Dize olarak eski booleanlar: yes, no, on, off, y, n. YAML 1.2 bunları zaten dize olarak okur, ama birçok ayrıştırıcı hâlâ YAML 1.1’i izler; orada tırnaksız bir no, false olur. Biçimlendirici çıktıda bunları her zaman tırnak içine alır; böylece meşhur Norveç hatası (ülke listesinde NO değerinin false okunması) dosyanızı kullanan kimseyi ısıramaz.
  • Dize olarak sayılar: '007', '3.14'. Tırnaksız bırakılsalar tamsayı veya ondalık sayı olarak ayrıştırılırlar.
  • :, #, [, { gibi karakterler içeren ya da boşlukla başlayan dizeler; çıplak çıktı burada yapıyı değiştirirdi.

Her çalıştırmada yapılan temizlikler

  • Satır sonu boşlukları. Silinir.
  • Karışık veya düzensiz girinti. Seçtiğiniz girinti genişliğine normalleştirilir.
  • Koleksiyon içindeki boş satırlar. Kaldırılır.
  • Girintide sekme. YAML bunu yasaklar; ayrıştırıcı girdiyi, satırı gösteren net bir hatayla reddeder. Böylece başka ayrıştırıcıların geri çevireceği bir dosya göndermek yerine hatayı düzeltirsiniz.

Yorumlar, çapalar ve birleştirme anahtarları

Biçimlendirme belge modelini normalleştirir; commit etmeden önce bilmeniz gereken sınırlar vardır:

  • Yorumlar kaldırılır. Ayrıştırıcı belgeyi veriye çözer, bu yüzden # yorumları biçimlendirmeden sağ çıkmaz. Yorumlarınız önemliyse bir kopya saklayın.
  • Çapalar ve takma adlar çözülür. Takma adla paylaşılan düğümler paylaşılmış kalır, ancak &ref_0 gibi üretilmiş adlarla yeniden yazılır; özgün çapa adları korunmaz.
  • Birleştirme anahtarları (<<:) çözülür ve birleşmiş değerleri yerinde taşıyan düz eşlemelere dönüşür.

Çok belgeli akışlar

Birden çok belge içeren akışlar desteklenir: her belge bağımsız biçimlendirilir ve --- ayırıcısıyla yeniden birleştirilir; çalıştırma başına 100 belgeye kadar.

Sık Sorulan Sorular

Yapı ve değerler birebir aynı kalır: yalnızca gösterim değişir (girinti, tırnaklar, akış veya blok, sıralamayı açarsanız anahtar sırası). İki şey bilerek korunmaz: yorumlar kaldırılır ve çapa adları yeniden üretilir.

Çıplak bir dize başka bir şey olarak ayrıştırılacaksa güvenlik için tırnak gerekir. Sık görülen durumlar: yalnızca rakamlardan oluşan anahtarlar veya değerler, : ya da # içeren dizeler ve YAML 1.1 ayrıştırıcılarının true/false okuyacağı yes, no gibi eski booleanlar.

Hayır. Stil seçeneği belgenin tamamına uygulanır: blok her koleksiyonu kendi satırlarına açar, akış koleksiyonları satır içinde yazar. Karşılaştırmanız gerekiyorsa farklı seçeneklerle iki kez biçimlendirin.

Hayır. Ayrıştırma ve biçimlendirme, birlikte gelen js-yaml motoruyla tarayıcınızda çalışır. YAML’ınız sunucudan geçmez, saklanmaz ve sayfa adresine asla eklenmez; yalnızca bu tarayıcı oturumunda yaşar ki çok adımlı görünüm sonucunuzu gösterebilsin.

İlgili Araçlar