html validation fixes:
[ikiwiki.git] / doc / todo / html.mdwn
index ba167ea6231ae80557d3fee6bb92465ea28e6b58..cb77774b5d83fdbf4748e1871718fbd790b3cf6a 100644 (file)
@@ -6,8 +6,35 @@ editing the [[templates]] BTW.
 
 Current problems:
 
-  * A doctype should be added: do we want XHTML 1.0 or HTML 4.01 Trans as default?
-  * If XHTML: In templates <hr> should become <hr\> etc.
+  * A doctype should be added: do we want XHTML 1.0 or HTML 4.01 Trans as
+    default?
+    
+       Need to choose a doctype that corresponds to what [[MarkDown]]
+       generates. For example, it does generate <hr />
+       So xhml seems a good fit and I'm going to add that to the
+       templates. 
+       
+       One consideration of course is that regular users might embed html
+       that uses deprecated presentational elements like <center>.
+       --[[Joey]]
+       
+  * If XHTML: In templates <hr> should become <hr /> etc.
   * Image wikilinks should provide an alt text (maybe '$filname wiki-image'?).
+
+       Now it will be the text of the [[WikiLink]], which even allows
+       setting a custom alt text like this: \[[my_alt_text|image.png]]
+       --[[Joey]]
+       
   * &'s in (cgi-)url's must be escaped as &.
+  
+       Fixed --[[Joey]]
+       
   * [ [inlinepage] ] gets wrapped in <p>...</p> which has a high chance of invalidating the page.
+
+       Since markdown does this, the only way I can think to fix it is to
+       make the inlined page text start with </p> and end with
+       <p>. Ugly, and of course there could be problems with
+       markdown enclosing it in other spanning tags in some cases.
+       I've implemented this hack now. :-/ --[[Joey]]
+
+Test: [validate this page](http://validator.w3.org/check?url=referer)