ตัวจัดรูปแบบ YAML

ก่อนและหลัง

อินพุตรกรุงรัง:

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

จัดรูปแบบแล้ว (เว้นวรรค 2 ช่อง, สไตล์บล็อก):

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

ตัวเลือกการจัดรูปแบบ

กฎของเครื่องหมายคำพูด

แบบน้อยที่สุดมักเป็นสิ่งที่คุณต้องการ: สตริงจะไม่มีเครื่องหมายคำพูด เว้นแต่การปล่อยไว้เปล่า ๆ จะไม่ปลอดภัย ตัวจัดรูปแบบจะเติมเครื่องหมายคำพูดให้อัตโนมัติสำหรับ:

• บูลีนแบบเก่าที่เป็นสตริง: yes, no, on, off, y, n ทั้งนี้ YAML 1.2 อ่านค่าเหล่านี้เป็นสตริงอยู่แล้ว แต่พาร์เซอร์จำนวนมากยังยึด YAML 1.1 ซึ่ง no ที่ไม่มีเครื่องหมายคำพูดจะกลายเป็น false ตัวจัดรูปแบบจะใส่เครื่องหมายคำพูดให้เสมอในผลลัพธ์ บั๊กนอร์เวย์อันโด่งดัง (NO ในรายชื่อประเทศถูกอ่านเป็น false) จึงกัดคนที่ใช้ไฟล์ของคุณไม่ได้
• ตัวเลขที่เป็นสตริง: '007', '3.14' หากไม่มีเครื่องหมายคำพูดจะถูกแยกวิเคราะห์เป็นจำนวนเต็มหรือทศนิยม
• สตริงที่มีอักขระอย่าง :, #, [, { หรือขึ้นต้นด้วยช่องว่าง ซึ่งถ้าปล่อยเปล่า ๆ โครงสร้างจะเปลี่ยน

การทำความสะอาดที่ได้ทุกครั้งที่รัน

• ช่องว่างท้ายบรรทัด ถูกลบออก
• การเยื้องที่ปะปนหรือไม่สม่ำเสมอ ถูกปรับให้เท่ากับความกว้างการเยื้องที่คุณเลือก
• บรรทัดว่างภายในคอลเลกชัน ถูกลบออก
• แท็บในการเยื้อง YAML ห้ามใช้แท็บ พาร์เซอร์จะปฏิเสธอินพุตพร้อมข้อความผิดพลาดที่ชี้บรรทัดให้ชัดเจน คุณจะได้แก้ไขแทนที่จะส่งไฟล์ที่พาร์เซอร์อื่นไม่ยอมรับ

คอมเมนต์ แองเคอร์ และคีย์ผสาน

การจัดรูปแบบทำให้โมเดลเอกสารเป็นมาตรฐาน ซึ่งมีข้อจำกัดที่ควรรู้ก่อนคอมมิต:

• คอมเมนต์ถูกลบออก พาร์เซอร์แปลงเอกสารให้เป็นข้อมูล คอมเมนต์ # จึงไม่รอดจากการจัดรูปแบบ เก็บสำเนาไว้หากคอมเมนต์ของคุณสำคัญ
• แองเคอร์และเอเลียสถูกแทนค่า โหนดที่แชร์ผ่านเอเลียสยังแชร์กันอยู่ แต่จะถูกเขียนออกมาใหม่ด้วยชื่อที่สร้างขึ้นอย่าง &ref_0 ชื่อแองเคอร์เดิมจะไม่ถูกเก็บไว้
• คีย์ผสาน (<<:) ถูกแทนค่า ให้เป็นแมปปิงธรรมดาที่มีค่าผสานอยู่ในตำแหน่ง

สตรีมหลายเอกสาร

รองรับสตรีมที่มีหลายเอกสาร: แต่ละเอกสารถูกจัดรูปแบบแยกกันแล้วต่อกลับเข้าด้วยกันด้วยตัวคั่น --- สูงสุด 100 เอกสารต่อการรันหนึ่งครั้ง