Pemformat & Pengesah YAML

YAML menggunakan indentasi (ruang) untuk menentukan struktur dokumen dan penyisipan — tiada kurungan beralun atau tag penutup seperti dalam JSON atau XML. Tahap indentasi sesuatu elemen menentukan sama ada ia adalah anak kepada elemen di atasnya atau rakan sebaya. Satu ruang tambahan atau hilang boleh mengubah makna sepenuhnya: kunci yang sepatutnya menjadi sub-hartanah definisi perkhidmatan mungkin menjadi kunci peringkat atasan dan sebagainya, selalunya tanpa sebarang mesej ralat daripada pengesan YAML. Inilah sebabnya ralat YAML sangat sukar untuk dinyahpepijat — simptom (konfigurasi yang salah) boleh jauh dari punca (ruang yang tersalah letak pada baris 47).

Tidak. Spesifikasi YAML melarang dengan jelas penggunaan aksara tab untuk indentasi. Tab dibenarkan di dalam rantaian petikan, tetapi tidak pernah sebagai indentasi. Jika editor anda ditetapkan untuk memasukkan tab apabila anda menekan Tab, tukarkannya kepada memasukkan ruang untuk fail YAML. Banyak pepijat berkaitan YAML disebabkan oleh tab yang tidak kelihatan dalam fail yang nampak seperti mempunyai indentasi yang betul. Formatter ini mengesan dan menormalkan indentasi tab kepada ruang.

Formatter ini mengendalikan set ciri lengkap YAML 1.2: jenis skalar (strings, integers, floats, booleans, null), pemetaan blok (key: value), urutan blok (- item), gaya aliran (inline {} dan []), rantaian pelbagai baris (block literal | dan folded block >), komen (#), sauh (&anchor) dan alias (*alias), dokumen berganda (pemisah ---), dan tag jenis eksplisit (!!str, !!int, dll.). Struktur tersusun yang kompleks seperti pod Kubernetes dengan volum, tatasusunan env, dan had sumber diformat dengan betul.

Komen dikenali semasa pengesahan dan analisis. Semasa pemformatan, alat ini menyusun semula struktur data yang dianalisis — kerana kebanyakan pengesan YAML tidak melampirkan komen pada model data, komen mungkin tidak dipelihara sepenuhnya dalam output yang diformat. Untuk tujuan pengesahan (memeriksa kesahihan bentuk), komen dikendalikan dengan betul. Jika pemeliharaan komen secara tepat adalah kritikal, salin versi yang diformat kembali ke editor anda dan tambah semula komen secara manual.

Ralat yang paling kerap berlaku: (1) Indentasi tidak konsisten — mencampuradukkan indent 2-ruang dan 4-ruang, atau tab bercampur dengan ruang. (2) Kunci berganda dalam pemetaan yang sama. (3) Strings tanpa petikan yang ditafsir oleh YAML sebagai nilai khas — "yes", "no", "true", "false", "null", "on", "off" kesemuanya ditafsir sebagai boolean atau null dalam YAML 1.1 (biasa dalam konfigurasi Kubernetes lama). (4) Titik bertindih tanpa ruang dalam kunci tanpa petikan. (5) Ruang yang hilang selepas titik bertindih dalam pasangan key: value. (6) Strings tanpa petikan yang mengandungi aksara khas YAML (: { } [ ] # &).

YAML adalah superset kepada JSON — JSON yang sah juga merupakan YAML yang sah. YAML menambah ciri mesra manusia yang tidak ada pada JSON: komen, rantaian pelbagai baris, sauh/alias untuk menggunakan semula nilai, dan kurang tanda baca (tiada koma antara item tatasusunan, tiada petikan diperlukan untuk nilai string ringkas). JSON mempunyai kelebihan untuk data yang dijana mesin: ia tidak sensitif kepada indentasi, disokong secara asli oleh setiap bahasa, dan tidak mengelirukan. Untuk fail konfigurasi yang disunting dengan tangan, YAML biasanya lebih diutamakan. Untuk tindak balas API dan penyimpanan data, JSON adalah pilihan utama.

Tidak. Semua pemformatan dan pengesahan dijalankan dalam pelayar anda menggunakan pengesan YAML JavaScript. Fail konfigurasi anda, yang mungkin mengandungi pembolehubah persekitaran, kredensial, dan butiran infrastruktur, tidak akan meninggalkan peranti anda.