\(\renewcommand{\vec}[1]{\mathbf{#1}} \DeclareMathOperator*{\sijoitus}{\Big/} \newcommand{\eval}[2]{\sijoitus_{\kern-0.7em#1}^{\kern0.7em#2}\!} \)

5.1.1.11 Merkkauksen muotoilu

Seuraavassa listassa on muutamia nykysuositusten mukaisia muotoiluohjeita, joita kannattaa opetella käyttämään, vaikka ne eivät olisikaan aina pakollisia.

  • Kirjoita tagit täydellisinä (ei pelkkä alkutagi)
  • Käytä otsikoissa HTML:n otsikkotyylejä h1 - h6. Niiden ulkoasua voi tarvittaessa muuttaa myöhemmin.
  • Kirjoita kaikki teksti jonkin lohkoelementin sisään (esim. <p>teksti</p> tai <div>teksti</div>)
  • Muokkaa tekstin ulkonäkö mahdollisimman paljon tyyliohjeen (CSS) avulla
  • Kirjoita tagimääritteet pienillä kirjaimilla
  • HTML-merkkaukseen voi lisätä kommentteja, eli merkkausta selittävää tekstiä, joka ei vaikuta nettisivuun mitenkään. Kommentti lisätään merkkien <!-- ja --> väliin. Sinne voi lisätä myös yhtäsuuruunmerkkejä lisäselvyyden vuoksi. Esimerkiksi merkkausta voi selventää seuraava kommentti:

    <!--==================== TÄSTÄ ALKAA LINKKIPALKKI =====================-->

    Kommentit ovat siis niitä varten, jotka yrittävät lukea ja ymmärtää merkkausta. Varsinkin pitkissä dokumenteissa kunnolliset kommentit ovat iso apu.