Cum comentez un bloc de linii în YAML?
YAML acceptă comentarii inline, dar nu are suport pentru bloc de comentarii.
De Wikipedia:
Comentarii începe cu semn de număr (
#
), poate începe de oriunde de pe o linie, și va continua până la sfârșitul liniei
O comparație cu JSON, de asemenea, de la Wikipedia:
sintaxa diferențele sunt subtile și foarte rar apar în practică: JSON permite extins charactersets ca UTF-32, YAML necesită un spațiu după separatoare ca virgula, egal, și de colon, în timp ce JSON nu, și unele implementări non-standard de JSON prelungi durata de gramatică pentru a include Javascript's
/* ... */
comentarii. Gestionarea unor astfel de cazuri de margine pot necesita lumina de pre-procesare a JSON înainte de parsare ca într-line YAML.
# If you want to write
# a block-commented Haiku
# you'll need three pound signs
Nu încearcă să fie inteligente despre asta, dar daca folosesc Sublime Text pentru editor, pașii sunt:
Am'd imaginați-vă că alți editori au funcționalități similare, de asemenea. Care sunt utilizați? Am'd fi fericit să fac niște cercetări.
În Vim puteți face unul dintre următoarele:
:%s/^/#
:10,15 s/^/#
:10,.s/^/#
:10,$s/^/#
sau folosind visual bloc:
O abordare alternativă:
Dacă
apoi
Exemplu:
În loc de
# This comment
# is too long
utilizarea
Description: >
This comment
is too long
sau
Comment: >
This comment is also too long
and newlines survive from parsing!
Mai multe avantaje:
Dacă sunteți folosind Eclipse cu yedit plugin (un editor .yaml fișiere), puteți comenta-out pe mai multe linii:
Și să ne-comentariu, urmați aceiași pași.
Emacs-ul nu a comentat-dwim (Fac ceea Ce vreau sa Spun) - doar selectați bloc și de a face o:
M-;
L's un comuta - l folosească pentru a comenta ȘI decomentați blocuri.
Dacă tu nu't au yaml-modul instalat, va trebui să-i spun Emacs pentru a utiliza caracterul diez (#).
Pentru Ruby a Mea utilizatorii de pe Windows:
Fișier deschis în editor Selectați blocul și apăsați Ctrl+slash, va fi selectat de bloc încep cu #.
Acum, dacă vrei să ne-comentariu comentat bloc, apăsați aceeași combinație de taste Ctrl+slash din nou
Pentru Visual Studio Cod (VSCode) utilizatori, comenzi rapide pentru a comenta mai multe linii este de a evidenția liniile doriți să adăugați un comentariu și apoi apăsați:
ctrl + /
Apăsarea ctrl + / din nou poate fi de asemenea utilizat pentru a comuta comentarii oprite pentru una sau mai multe linii selectate.
O modalitate de a bloca comentând în YAML este folosind un editor de text cum ar fi Notepad++ pentru a adăuga un # (comentariu) tag-ul pentru mai multe linii simultan.
În Notepad++ poti face asta folosind "Bloc Comentariu" opțiune, faceți clic dreapta pentru textul selectat.