Làm thế nào để tôi nhận xét một khối các dòng trong YAML?
Câu trả lời:
YAML hỗ trợ bình luận nội tuyến, nhưng không hỗ trợ bình luận khối.
Từ Wikipedia :
Nhận xét bắt đầu bằng ký hiệu số (
#), có thể bắt đầu ở bất kỳ đâu trên một dòng và tiếp tục cho đến khi kết thúc dòng
Một so sánh với JSON, cũng từ Wikipedia :
Sự khác biệt về cú pháp là tinh tế và hiếm khi phát sinh trong thực tế: JSON cho phép các ký tự mở rộng như UTF-32, YAML yêu cầu một khoảng trắng sau các dấu phân cách như dấu phẩy, bằng và dấu hai chấm trong khi JSON không và một số triển khai JSON không chuẩn bao gồm các
/* ... */bình luận của Javascript . Xử lý các trường hợp cạnh như vậy có thể yêu cầu xử lý trước nhẹ JSON trước khi phân tích cú pháp như YAML nội tuyến.
# If you want to write
# a block-commented Haiku
# you'll need three pound signs
Thông số kỹ thuật chỉ mô tả một cách đánh dấu nhận xét:
Một nhận xét rõ ràng được đánh dấu bởi một chỉ số # #.
Đó là tất cả. Không có bình luận khối.
Không cố tỏ ra thông minh về điều đó, nhưng nếu bạn sử dụng Sublime Text cho trình soạn thảo của mình, các bước là:
Tôi tưởng tượng rằng các biên tập viên khác cũng có chức năng tương tự. Cái nào bạn đang dùng? Tôi rất vui khi được đào bới.
Trong Vim, bạn có thể thực hiện một trong các thao tác sau:
:%s/^/#:10,15s/^/# :10,.s/^/#:10,$s/^/#hoặc sử dụng khối trực quan:
"Vim, I did a thing. do it here, and here and here and here and here..."
:và gõ s/^/#để bình luận lựa chọn hiện tại.
qqI#<esc>jqsau đó @Q@Q@Q@Q@Q@Q(vì nó nhanh hơn để không cho tắt phím shift), là một thói quen, bạn có thể mở rộng đến các nhiệm vụ phức tạp hơn nhiều. Khởi đầu nhỏ. Thực hành thường xuyên. Bạn sẽ sớm tạo ra các macro rất phức tạp một cách hoàn hảo. Nếu bạn xóa đăng ký trước qqq, bạn có thể đưa vào @qtrước lần cuối qđể nhận đệ quy (nhưng chỉ đến cuối tệp).
@q, bạn có thể chỉ cần làm 6@qhoặc 10000@qnếu bạn muốn.
:h countsố nhân. Nhưng đối với tôi, trực quan mọi thứ trên 6 tuổi và tôi phải làm điều đó vì tôi không thể đoán được nó. Ngoại lệ là tôi biết tôi có hơn 60 hàng trên thiết bị đầu cuối của mình vì vậy tôi sẽ sử dụng số đó để ước tính cho các lần phát lại marco rất lớn. Như một phần thưởng, tôi sẽ đề nghị mọi người tìm hiểu về việc :h gngiúp dễ dàng thực hiện việc .lặp lại trên các kết quả tìm kiếm. Xem vimcasts.org/episodes/operating-on-search-matches-USE-gn
Một cách tiếp cận khác:
Nếu
sau đó
Thí dụ:
Thay vì
# This comment
# is too long
sử dụng
Description: >
This comment
is too long
hoặc là
Comment: >
This comment is also too long
and newlines survive from parsing!
Ưu điểm hơn:
Một cách để chặn nhận xét trong YAML là sử dụng trình soạn thảo văn bản như Notepad ++ để thêm thẻ # (nhận xét) vào nhiều dòng cùng một lúc.
Trong Notepad ++, bạn có thể thực hiện việc đó bằng cách sử dụng tùy chọn nhấp chuột "Chặn bình luận" cho văn bản đã chọn.
Nếu bạn đang sử dụng Eclipse với plugin yedit (trình soạn thảo cho các tệp .yaml), bạn có thể nhận xét nhiều dòng bằng cách:
Và để bỏ bình luận, hãy làm theo các bước tương tự.
Đối với người dùng Ruby Mine trên Windows:
Mở tệp trong trình chỉnh sửa Chọn khối và nhấn Ctrl+forward slash , bạn sẽ có khối được chọn bắt đầu bằng #.
Bây giờ nếu bạn muốn hủy nhận xét khối nhận xét, hãy nhấn cùng tổ hợp phím Ctrl+ forward slashlần nữa
Emacs có bình luận-dwim (Làm những gì tôi muốn nói) - chỉ cần chọn khối và thực hiện:
M-;
Đó là một sự thay đổi - sử dụng nó để bình luận VÀ các khối không ghi chú.
Nếu bạn chưa cài đặt chế độ yaml, bạn sẽ cần nói với Emacs sử dụng ký tự băm (#).
Đối với người dùng Visual Studio Code (VSCode), phím tắt để nhận xét nhiều dòng là làm nổi bật các dòng bạn muốn nhận xét và sau đó nhấn:
ctrl + /
Nhấn ctrl+ /lần nữa cũng có thể được sử dụng để tắt bình luận cho một hoặc nhiều dòng được chọn.
Trong trình duyệt Azure Devops (trình soạn thảo đường ống yaml),
Ctrl+ K+ CKhối nhận xét
Ctrl+ K+ UKhối không ghi chú
Ngoài ra còn có tùy chọn 'Toggle Block Comment' nhưng điều này không hiệu quả với tôi.
Cũng có nhiều cách 'wierd' khác: nhấp chuột phải để xem 'Bảng lệnh' hoặc F1
Sau đó chọn một tùy chọn con trỏ. 
Bây giờ chỉ là vấn đề #
hoặc thậm chí thông minh hơn [ Ctrl+ k] + [ Ctrl+ c]