Định dạng YAML

Cách hoạt động

Toàn bộ thiết kế của YAML dựa trên thụt lề, khiến nó dễ đọc nhưng cũng dễ hỏng một cách bất thường. Một khoảng trắng thừa sẽ gây ra thông báo lỗi từ quy trình CI hai mươi phút sau. Công cụ này phân tích nó ngay tại đây và báo cho bạn ngay lập tức.

Kiểm tra hợp lệ kèm số dòng

Nếu tài liệu không phân tích được, bạn sẽ nhận được dòng và cột nơi nó lỗi cùng lý do của chính trình phân tích. Điều đó gần như luôn hữu ích hơn kết quả đã định dạng, và là lý do phần lớn mọi người mở một công cụ như thế này.

Định dạng lại

YAML hợp lệ được phân tích thành một cấu trúc dữ liệu rồi ghi ra lại từ đầu, nên thụt lề trở nên đồng nhất, dấu ngoặc kép được chuẩn hóa và khoảng trắng thừa ở cuối dòng biến mất. Vì nó đi qua dữ liệu chứ không chỉnh sửa văn bản, kết quả được đảm bảo hợp lệ.

Cái giá của việc đi qua dữ liệu

Chú thích bị mất. Chúng không thuộc về dữ liệu, nên trình phân tích bỏ chúng đi. Anchor và alias được khai triển thành giá trị đầy đủ thay vì được giữ nguyên. Nếu chú thích trong tệp của bạn quan trọng, hãy định dạng một bản sao rồi tự sửa thụt lề bằng tay.

Sắp xếp khóa

Sắp xếp theo thứ tự bảng chữ cái giúp hai tệp cấu hình thật sự so sánh được trong diff. Nhưng đó cũng là lựa chọn sai với tệp mà thứ tự có ý nghĩa với người đọc — một quy trình CI dễ đọc hơn khi theo thứ tự thực thi thay vì theo thứ tự bảng chữ cái.

Nhiều tài liệu

Tệp chứa nhiều tài liệu được ngăn cách bằng --- vẫn được xử lý, và từng tài liệu được định dạng lần lượt.