summaryrefslogtreecommitdiff
path: root/doc/bugs/html5_support.mdwn
blob: 14c2597e956259e73749a61f6177c49f5f2e59a0 (plain)

Some elements of HTML5 can be safely supported by ikiwiki. There are several differences between HTML4 and HTMl5. Unsupported new elements should degrade gracefully.

However as an early adopter I would like to start using HTML5 as much as possible. The more pragmatic solution would be to use elements supported by the browsers of your readership I guess. I'm following other early adopters like Anne for clues on how to proceed.

I'm unsure how to turn off the test validation by the very old wdg-html-validator. So I have been unable to test my initial patches as I can't build ikiwiki. I would like to know how to edit the rules/Makefile to temporarily disable this.

validator.nu incidentally is the HTML5 validator, however it is almost impossible to sanely introduce as a build dependency because of its insane Java requirements. :( I test locally via cURL, though Debian packages cannot be built with a network dependency.

Notes

  • the time element ideally needs the datatime= attribute set with iso8601 time
  • I suspect the migration to the new semantic elements of HTML5 like article, header & footer to take some time, due to browser support. Though they sure make the template code look much nicer.
  • <br> and too many <div>s usually indicates poor semantics.
  • Many of the header <span>s should be proper header elements