markdown's overzelous _ and * expansion inside words can't really be fixed

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

diff --git a/doc/todo/html.mdwn b/doc/todo/html.mdwn
index e7ba8bc42a0fbdee1f64dda8ab18c4f0f567e1fa..9f5dc836e67bfc701e6e22a95c7f5a97d0047ece 100644 (file)
--- a/doc/todo/html.mdwn
+++ b/doc/todo/html.mdwn
@@ -6,33 +6,13 @@ editing the [[templates]] and/or editing [[style.css]] BTW.
 
 ## 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. 
-       
+  * Doctype is XHTML 1.0 Strict
+       
        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]]
 
-  * 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
@@ -45,7 +25,22 @@ editing the [[templates]] and/or editing [[style.css]] BTW.
            <div class="inlinepage">  
            [ [inlinepage] ]  
            </div>  
-       This prevents markdown enclosing and even adds a useful css identifier. --[[JeroenSchot]]
+       This prevents markdown enclosing and even adds a useful css identifier. Problem is that this should be added to every page and not in the template(s). --[[JeroenSchot]]
+
+       I can make ikiwiki add that around every inlined page easily
+       enough. However, where is it documented? Came up dry on google.
+       --[[Joey]]
+
+       From <http://daringfireball.net/projects/markdown/syntax#html>:
+       > The only restrictions are that block-level HTML elements \97 e.g. &lt;div&gt;, &lt;table&gt;, &lt;pre&gt;, &lt;p&gt;, etc. \97 must be separated from surrounding content by blank lines, and the start and end tags of the block should not be indented with tabs or spaces. Markdown is smart enough not to add extra (unwanted) &lt;p&gt; tags around HTML block-level tags. [snip]
+       > Note that Markdown formatting syntax is not processed within block-level HTML tags. E.g., you can\92t use Markdown-style \*emphasis\* inside an HTML block.
+
+       Because [ [inlinepage] ] isn't separated by a blank line it gets treated as a block-level element. Hmm, will this stop all formatting, including *'s to em-tags? --[[JeroenSchot]]
+
+    Ah didn't realize you meant it fixed it at the markdown level. I'll
+    think about making [[postprocessordirective]]s into
+    preprocessordirectives instead, then I could use that fix (but I'm not
+    sure how feasible it is to do that). --[[Joey]]
 
 This page is now valid.
 Test: [validate this page](http://validator.w3.org/check?url=referer)