web commit by joey

[git.ikiwiki.info.git] / doc / todo / html.mdwn

diff --git a/doc/todo/html.mdwn b/doc/todo/html.mdwn
index ba167ea6231ae80557d3fee6bb92465ea28e6b58..46d4815ffce2f50be4c425838f250c329b143b06 100644 (file)
--- a/doc/todo/html.mdwn
+++ b/doc/todo/html.mdwn
@@ -1,13 +1,44 @@
-Make the html valid. Add css and prettify. Make RecentChanges use table for
+Add css and prettify. Make RecentChanges use table for

 formatting, and images to indicate web vs svn commits and to link to diffs.
 
 All of this should be doable w/o touching a single line of code, just
 editing the [[templates]] BTW.
 
 formatting, and images to indicate web vs svn commits and to link to diffs.
 
 All of this should be doable w/o touching a single line of code, just
 editing the [[templates]] BTW.
 

-Current problems:
+## html validation
+
+  * 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 xhtml 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>. At
+        least firefox seems to handle that mixture ok. 
+       --[[Joey]]
+       
+  * If XHTML: In templates <hr> should become <hr /> etc.
+        
+    Done --[[Joey]]

 
 

-  * 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.

   * Image wikilinks should provide an alt text (maybe '$filname wiki-image'?).
   * 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 &.
   * &'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.
   * [ [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)