Akiru la faktojn kun ĉi tiu paŝo post paŝo
Se vi interesas aldoni referencajn komentojn al via XML-kodo, uzu ĉi tiun paŝan lernilon por gvidado. Vi povas lerni kiel ekzekuti ĉi tiun funkcion en nur kvin minutoj. Dum la procezo estas facile kompletigi, vi ankoraŭ devas scii iujn bazojn pri XML-komentoj kaj ilian utilecon antaŭ ol vi komencu.
Kial XML Rimarkoj Estas Utilaj
Komentoj en XML estas preskaŭ identaj al komentoj en HTML, ĉar ili ambaŭ havas la saman sintakson. Uzante komentojn permesas kompreni kodon, kiun vi skribis jarojn antaŭe. Ĝi ankaŭ povas helpi alian programiston, kiu revizias la kodon, kiun vi disvolvis komprenas, kion vi skribis. En definitiva, ĉi tiuj komentoj havigas kuntekston por la kodo.
Per komentoj, vi facile povas lasi noton aŭ provizore forigi parton de XML-kodo. Eĉ kvankam XML estas desegnita por esti "mem-priskribanta datumon," en okazo vi eble bezonos lasi XML-komenton.
Komencante
Komentaj etikedoj estas konsistitaj el du partoj: la parto komencante la komenton kaj la parton finante ĝin. Komenci, aldonu la unuan parton de la komento etikedo ajnan komenton, kiun vi volas. Nur certigu, ke vi ne nestumas komentojn en aliaj komentoj (vidu konsiletojn por pli da detaloj).
Post tio, vi fermos la komenton etikedo ->
Utilaj Konsiletoj
Aldonante referencajn komentojn al via XML-kodo, memoru, ke ili ne povas ĉe la plej alta parto de via dokumento. En XML, nur la XML-deklaro povas veni unue:
Kiel menciita supre, komentoj eble ne nestumas unu inter alia. Vi devas fermi vian unuan komenton antaŭ ol vi malfermu duan. Ankaŭ, komentoj ne povas okazi ene de etikedoj, ekz.
Neniam uzu la du paŝojn (-) ie ajn ĉe la komenco kaj fino de viaj komentoj. Ĉio en komentoj estas vere nevidebla al la XML-analizilo, do estu tre zorga, ke kio restas ankoraŭ valida kaj bone formita.
Envolvado
Se vi ankoraŭ havas demandojn pri aldonado de komentoj al XML-kodo, vi eble volas legi libron por doni al vi detalan bildon pri kiel funkcias la procezo. Libroj kiel ekzemple C # 5.0's Programmer's Reference de Rod Stephens povas esti utilaj. Kontrolu enretaj komercistoj aŭ via loka biblioteko por similaj libroj.