HTML kodo lahko zapišemo na različne načine, vendar vsi načini niso enako pregledni. Brskalnik pri običajnem prikazu več zaporednih presledkov, tabulatorjev in praznih vrstic navadno ne pokaže tako, kot so zapisani v izvorni kodi. Zato je pomembno, da kodo oblikujemo predvsem zaradi preglednosti in lažjega vzdrževanja.
Pomni: Tudi če brskalnik neko napako v kodi sam popravi ali prezre, to še ne pomeni, da je koda pravilna in dovolj pregledna.
Osnovna pravila
- Kodo HTML zapisujemo pregledno in dosledno.
- Posamezne elemente je priporočljivo zapisovati v ločene vrstice.
- Gnezdene elemente običajno zamaknemo nekoliko v desno.
- Barvanje kode v urejevalniku pomaga pri branju in iskanju napak.
- Pred objavo je smiselno kodo preveriti z ustreznim validatorjem.
Primerjave
Nepregledna in pregledna koda
Načeloma bi lahko HTML kodo zapisali tudi v eni sami vrstici, vendar tak način ni priporočljiv, saj je koda zelo nepregledna in jo je težko vzdrževati.

Nepregledna koda HTML, zapisana v eni vrstici
Za večjo preglednost kode poskrbimo tako, da posamezne elemente zapisujemo v nove vrstice.

HTML koda, kjer je vsak element zapisan v svoji vrstici
Nezamaknjena in zamaknjena koda
Preglednost je še večja, če upoštevamo tudi strukturo dokumenta in gnezdene elemente zamikamo v desno. Tako iz kode lažje razberemo, kateri elementi spadajo skupaj.

HTML koda, kjer je posamezen del kode obarvan v svoji barvi

Oblikovana in strukturno pregledna HTML koda
Pozor: Pri zamikanju HTML kode ni najpomembnejše, koliko presledkov uporabimo, ampak to, da enak način uporabljamo dosledno v celotnem dokumentu.
Oblikovanje kode
Za dobro preglednost kode navadno upoštevamo tri osnovna načela: elemente zapisujemo v smiselne vrstice, gnezdene dele zamikamo in v urejevalniku uporabljamo označevanje sintakse. S tem je koda lažje berljiva, lažje jo popravljamo in hitreje opazimo napake.
| Način oblikovanja | Korist |
|---|---|
| nove vrstice | posamezne elemente lažje ločimo med seboj |
| zamiki | jasneje vidimo strukturo in gnezdenje elementov |
| barvanje kode | hitreje prepoznamo oznake, atribute, vrednosti in besedilo |
Pomni: Pregledna koda je pomembna predvsem za človeka, ki jo bere, popravlja ali dopolnjuje.
Preverjanje pravilnosti napisane kode
Napisano kodo lahko preverimo na različne načine. Mnogi sodobni urejevalniki kode in razvojna okolja imajo osnovno preverjanje že vgrajeno. Obstaja pa tudi več spletnih orodij za preverjanje HTML. Eno najbolj znanih je preverjevalnik organizacije W3C oziroma Nu HTML Checker.
Validator nas lahko opozori na napake v oznakah, nepravilno gnezdenje elementov, manjkajoče atribute in druge težave v dokumentu. Tudi če spletna stran v brskalniku na prvi pogled deluje pravilno, je smiselno kodo preveriti, saj s tem izboljšamo pravilnost, združljivost in vzdrževanje strani.
Priporočila
- HTML kodo zapisuj v več vrsticah in ne v eni sami dolgi vrstici.
- Pri gnezdenih elementih uporabljaj dosledne zamike.
- Za pisanje kode uporabljaj urejevalnik z označevanjem sintakse.
- Pred objavo preveri kodo z validatorjem HTML.
- Pri popravljanju napak najprej odpravi nepravilno zapisane ali nepravilno vgnezdene elemente.
Pogoste napake
- Koda je zapisana nepregledno, brez vrstic in brez jasnih zamikov.
- Gnezdeni elementi niso zapisani dosledno glede na strukturo dokumenta.
- Predpostavi se, da je koda pravilna že zato, ker jo brskalnik nekako prikaže.
- Koda pred objavo ni preverjena z validatorjem HTML.
- Napake v oznakah in atributih ostanejo neopažene, ker je zapis preveč nepregleden.
