X'inhuma l-Kummenti HTML u Kif huma Użati
a Meta tara paġna tal-web f'xi browser, qed tara rappreżentazzjoni viżiva ta 'dak li dik il-biċċa software (il-web browser) qed turi fuq il-kodiċi ta' paġna web partikolari. Jekk tara dak il-kodiċi tas- sors tal-paġna web, tara dokument magħmul minn diversi elementi HTML, inklużi paragrafi, intestaturi, listi, links, stampi u aktar. Dawn l-elementi kollha huma mogħtija mill-browser fuq l-iskrin ta 'viżitatur bħala parti mill-wirja tal-websajt. Ħaġa waħda li tista 'ssib fil-kodiċi HTML li ma tingħatax fuq l-iskrin ta' persuna huma dak li huma magħrufa bħala "kummenti HTML".
X'inhi Kumment?
Kumment huwa sensiela ta 'kodiċi fi ħdan HTML, XML, jew CSS li mhix meqjusa jew li tkun ittieħdet fuqha mill-browser jew l-parser. Huwa sempliċement miktub fil-kodiċi biex jipprovdi informazzjoni dwar dak il-kodiċi jew feedback ieħor mill-iżviluppaturi tal-kodiċi.
Il-biċċa l-kbira tal-lingwi ta 'programmar għandhom kummenti, huma komunement użati mill-iżviluppatur tal-kodiċi għal wieħed jew aktar minn wieħed, bir-raġuni li ġejja:
- Iddeskrivi u tispjega kodiċi kkumplikat lil xi ħadd li jista 'jkollu jaħdem fuqha fil-futur - inkluż lilhom infushom! Jistgħu jiġu lura għall-kodiċi 3 jew 6 ta '12-il xahar jew aktar tard u ma jfakkrux għaliex għamlu xi ħaġa b'ċertu mod. Il-kummenti jistgħu jgħinu biex iwieġbu l-mistoqsijiet tagħhom u jfakkruhom dwar fejn kienu f'moħħhom meta kienu l-ewwel li żviluppaw dik il-paġna.
- Ipprovdi dettalji dwar meta l-kodiċi ġie editjat jew rivedut. Din tista 'tkun informazzjoni utli u taġixxi kemmxejn bħal log ta' żvilupp ta 'meta s-sit kien l-aħħar ħadem.
- Neħħi s-sezzjonijiet tal-kodiċi, iżda ħallihom disponibbli għal użu aktar tard. Dan spiss isir waqt l-ittestjar tas-sit u d-debugging. Jekk għandek problema fuq sit u m'intix ċert x'qed tikkawża, tista 'tikkummenta t-taqsimiet wieħed kull darba għall-kwarantina u tidentifika l-kwistjoni, u mbagħad taħdem fuq soluzzjoni għal kwalunkwe problema li qed ikollok.
- Chat ma 'żviluppaturi oħra li jaħdmu fuq il-kodiċi. Dan x'aktarx isir matul l-iżvilupp bħala mod biex jinqasmu d-dettalji ma 'oħrajn li jaħdmu fuq il-kodiċi fl-istess ħin. Jekk dawn il-kummenti huma konversazzjonijiet ta 'żvilupp purament, hija l-aħjar prattika li jitneħħew mill-kodiċi qabel ma jitnieda sit.
Tradizzjonalment, il-kummenti f'HTML jintużaw għal kważi kull element, minn spjegazzjonijiet ta 'strutturi kumplessi tal-mejda għal rimarki informattivi tal-kontenut tal-paġna nnifisha. Peress li l-kummenti mhumiex mogħtija fil-browser, tista 'żżidhom kullimkien fl-HTML u m'għandhom l-ebda tħassib dwar x'se tagħmel meta s-sit ikun meqjus minn klijent.
Kif tikteb Kummenti
Kitba ta 'kummenti f'HTML, XHTML, u XML hija faċli ħafna. Sempliċiment jdawru t-test li trid ikkummentaw b'dawn li ġejjin:
u ->Kif tistgħu taraw, dawn il-kummenti jibdew b '"inqas minn simbolu", flimkien ma' punt ta 'dikjarazzjoni u żewġ linji. Il-kumment jintemm b'żewġ linji oħra u simbolu "ikbar minn: Bejn dawk il-karattri tista 'tikteb dak kollu li trid tagħmel il-korp tal-kumment.
F'CSS, huwa ftit differenti, bl-użu ta 'kummenti ta' kodiċi C aktar milli HTML Tibda b'saqaf 'il quddiem imbagħad b'asterisk. Inti tispiċċa l-kumment bl-invers ta 'dak, asterisk segwit minn slash' il quddiem.
/ * kummentat it-test * /Il-kummenti huma Art li Jmut
Ħafna programmaturi jafu l-valur ta 'kummenti utli . Il-kodiċi kkummentat jagħmilha aktar faċli li dak il-kodiċi jiġi trasferit minn membru tat-tim għal ieħor. Il-kummenti jgħinuk tim ta 'QA biex jittestja l-kodiċi, għaliex jistgħu jgħidulek x'inhu l-intenzjoni tal-iżviluppatur - anki jekk ma ntlaħaqx. Sfortunatament, bil-popolarità ta 'pjattaformi tal-awtur tal-websajt bħal Wordpress, li jippermettulek tibda taħdem ma' tema magħżula li timmaniġġja ħafna, jekk mhux kollha, tal-HTML għalik, kummenti ma jintużawx spiss minn timijiet tal-web. Dan huwa minħabba li l-kummenti huma verament diffiċli biex tara fil-biċċa l-kbira ta 'għodda tal-kitba viżwali jekk ma tkunx qed taħdem direttament mal-kodiċi. Per eżempju, aktar milli jarah, fil-quċċata ta 'paġna web:
L-għodda viżwali turi ika żgħira biex tindika li hemm kumment. Jekk id-disinjatur ma jiftaħx fiżikament il-kumment, huwa qatt ma jista 'jarah. U fil-każ tal-paġna t'hawn fuq, jista 'jikkawża problemi jekk hija taġġorna l-paġna u dik l-editjar hija miktuba fuq l-iskrittura msemmija fil-kumment.
X'jista 'jsir?
- Ikteb kummenti utli u utli. Ma jistennewx nies oħra biex jaqraw il-kummenti tiegħek jekk huma twal wisq jew ma jinkludux informazzjoni utli.
- Bħala żviluppatur, għandek dejjem tirrevedi kwalunkwe kumment li tara fuq paġna.
- Uża l-għodod ipprovduti mill-programmi tal-awtur li jippermettu li żżid il-kummenti.
- Uża l-ġestjoni tal-kontenut biex tikkontrolla kif il-paġni huma editjati.
Anki jekk int l-unika persuna li taġġorna l-paġni web tiegħek, il-kummenti jistgħu jkunu utli. Jekk inti biss teditja paġna ikkumplikata darba fis-sena, huwa faċli li tinsa kif fasslet it-tabella jew għaqqad is-CSS. Bil-kummenti, m'għandekx tiftakar, kif hemm miktub hemmhekk għalik.
Artikolu oriġinali minn Jennifer Krynin. Editjat minn Jeremy Girard fil-5/5/17