git.oblomov.eu Git - ikiwiki/blob - doc/todo/html.mdwn

   1 Create some nice stylesheets. Make RecentChanges use table for
   2 formatting, and images to indicate web vs svn commits and to link to diffs.
   3
   4 All of this should be doable w/o touching a single line of code, just
   5 editing the [[templates]] and/or editing [[style.css]] BTW.
   6
   7 ## html validation
   8
   9   * A doctype should be added: do we want XHTML 1.0 or HTML 4.01 Trans as
  10     default?
  11
  12         Need to choose a doctype that corresponds to what [[MarkDown]]
  13         generates. For example, it does generate &lt;hr /&gt;
  14         So xhtml seems a good fit and I'm going to add that to the
  15         templates.
  16
  17         One consideration of course is that regular users might embed html
  18         that uses deprecated presentational elements like &lt;center&gt;. At
  19         least firefox seems to handle that mixture ok.
  20         --[[Joey]]
  21
  22   * If XHTML: In templates &lt;hr&gt; should become &lt;hr /&gt; etc.
  23
  24     Done --[[Joey]]
  25
  26   * Image wikilinks should provide an alt text (maybe '$filname wiki-image'?).
  27
  28         Now it will be the text of the [[WikiLink]], which even allows
  29         setting a custom alt text like this: \[[my_alt_text|image.png]]
  30         --[[Joey]]
  31
  32   * &'s in (cgi-)url's must be escaped as &amp;amp;.
  33
  34         Fixed --[[Joey]]
  35
  36   * [ [inlinepage] ] gets wrapped in &lt;p&gt;...&lt;/p&gt; which has a high chance of invalidating the page.
  37
  38         Since markdown does this, the only way I can think to fix it is to
  39         make the inlined page text start with &lt;/p&gt; and end with
  40         &lt;p&gt;. Ugly, and of course there could be problems with
  41         markdown enclosing it in other spanning tags in some cases.
  42         I've implemented this hack now. :-/ --[[Joey]]
  43
  44         I used this 'hack' myself, but yesterday I came up with a better idea:
  45             &lt;div class="inlinepage"&gt;
  46             [ [inlinepage] ]
  47             &lt;/div&gt;
  48         This prevents markdown enclosing and even adds a useful css identifier. --[[JeroenSchot]]
  49
  50 This page is now valid.
  51 Test: [validate this page](http://validator.w3.org/check?url=referer)