urosm
/
ikiwiki
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

html5 bug closure, and documentation

master
Joey Hess 2010-05-02 17:16:15 -04:00
parent d37ff8d299
commit 34076e398c
4 changed files with 33 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/bugs/html5_support.mdwn
View File

@ -106,3 +106,9 @@ As a workaround:
## tidy plugin
Will reformat html5 to html4.
----
Ok, I consider this [[done]], at least as a first pass. Html5 mode
is experimental, but complete enough. --[[Joey]]

2
doc/features.mdwn
View File

@ -72,7 +72,7 @@ you would care to syndicate.
Ikiwiki aims to produce
[valid XHTML 1.0](http://validator.w3.org/check?url=referer).
(Experimental HTML5 support is also available.)
(Experimental [[tips/HTML5]] support is also available.)
Ikiwiki generates html using [[templates]], and uses [[css]], so you
can change the look and layout of all pages in any way you would like.

2
doc/roadmap.mdwn
View File

@ -80,7 +80,7 @@ Probably incomplete list:
* YADA format setup files per default?
* Enable tagbase by default (so that tag autocreation will work by default).
Note that this is already done for wikis created by `auto-blog.setup`.
* html5 on by default (some day..)
* [[tips/html5]] on by default (some day..)
In general, we try to use [[ikiwiki-transition]] or forced rebuilds on
upgrade to deal with changes that break compatability. Some things that

25
doc/tips/html5.mdwn 100644
View File

@ -0,0 +1,25 @@
First, if you just want to embed videos using the html5 `<video>` tag,
you can do that without switching anything else to html5.
However, if you want to fully enter the brave new world of html5, read on..
Currently, ikiwiki does not use html5 by default. There is a `html5`
setting that can be turned on, in your setup file. Rebuild with it set, and
lots of fancy new semantic tags will be used all over the place.
You may need to adapt your CSS for html5. While all the class and id names
are the same, some of the `div` elements are changed to other things.
Ikiwiki's default CSS will work in both modes.
The html5 support is still experimental, and may break in some browsers.
No care is taken to add backwards compatability hacks for browsers that
are not html5 aware (like MSIE). If you want to include the javascript with
those hacks, you can edit `page.tmpl` to do so.
[Dive Into HTML5](http://diveintohtml5.org/) is a good reference for
current compatability issues and workarounds with html5.
---
Known ikiwiki-specific issues:
* [[plugins/htmltidy]] uses `tidy`, which is not html5 aware, so if you
have that enabled, it will mangle it back to html4.