แนะนำ YAML และวิธีการเขียนไฟล์ YAML

YAML คืออะไร?

• ภาษา YAML เป็นภาษาสำหรับการจัดแจงข้อมูล คล้ายกับภาษาอย่าง JSON หรือ XML
• ถูกออกแบบมาให้มนุษย์สามารถอ่านข้อมูลภายในได้รู้เรื่อง
• หลีกเลี่ยงการใช้ Markup ที่เป็นสัญลักษณ์ที่คนทั่วไปไม่ใช้ ในภาษาปกติ เช่นเครื่องหมายปีกกาหรือวงเล็บแปลกๆ { } ( ) < > ที่ไม่ได้อยู่ในรูปแบบการอ่านเขียนข้อมูลทั่วไป
• การแบ่งลำดับข้อมูลของ YAML จะใช้การเว้นย่อหน้าด้วย spacebar เป็นตัวกำหนดลำดับชั้นข้อมูลแทน ทำให้การเว้นวรรค Indent เป็นเรื่องสำคัญที่สุดใน YAML

วิธีการทำงานของ YAML

1. อ่านจากบนลงล่าง
2. เริ่มกลุ่มข้อมูลด้วยเครื่องหมายขีด (-) เสมอ
3. ข้อมูลแต่ละชุด จะมีชื่อชุดข้อมูล ตามด้วยเครื่องหมายจุดคู่ (:) และต่อด้วยค่าของข้อมูลนั้นๆ หลังเครื่องหมาย
4. ข้อมูลในขีด ( - ) เดียวกัน จะนับว่าเป็นข้อมูลกลุ่มเดียวกัน
5. ข้อมูลที่ไม่ได้อยู่บรรทัดเดียวกับขีด ใช้การเว้นวรรคด้วย Spacebar 2 ครั้ง 
6. สามารถมีชุดข้อมูลซ้อนในข้อมูลได้ โดยใช้การเว้นวรรคย่อหน้า ด้วย spacebar เพิ่มต่อหนึ่งระดับชั้น

ตัวอย่างโค้ด YAML

การแบ่งกลุ่มข้อมูลใน YAML

การเขียนไฟล์ YAML ใน BuzzDe Engine

โปรแกรมที่แนะนำให้ใช้สำหรับทำงานเขียนบท มี 2 โปรแกรม คือ

1. Notepad++

2. Visual Studio Code

ซึ่งทั้งสองโปรแกรมจะมีข้อดีข้อเสียต่างกันดังนี้

การตั้งค่า Notepad++ สำหรับทำงาน

- ในเมูนู View เลือกที่ Show Symbol และติ๊กถูกที่ช่อง Show White Space and TAB จะทำให้ เห็นการเว้นวรรคแสดงเป็นรูปจุด ดังภาพ

- ในเมนู Language เลือกภาษา เป็น YAML จะทำให้แสดงสี ข้อความที่เป็นตัวแปร ทำให้ดูง่ายขึ้น ดังภาพ

- หน้าต่างที่พร้อมทำงานของโปรแกรม Notepad++ จะปรากฎดังนี้

- การบันทึกไฟล์เป็นนามสกุลที่ถูกต้องบนโปรแกรม Notepad++ จะต้องเป็นลักษณะดังนี้

การตั้งค่า Visual Studio Code สำหรับทำงาน

- ในเมนู View ให้ติ๊กถูกที่ช่อง Render Whitespace จะทำให้เห็นการเว้นวรรคแสดงเป็นรูปจุด

- ที่ตัวเลือกด้านขวาล่าง เปลี่ยนจาก Plain Text เป็น YAML จะทำให้แสดงสี ข้อความที่เป็นตัวแปร ทำให้ดูง่ายขึ้น

- หน้าต่างที่พร้อมทำงานของโปรแกรม Visual Studio Code จะปรากฎดังนี้

- การบันทึกไฟล์ที่ถูกต้องบนโปรแกรม Visual Studio Code จะต้องกดดังนี้