(no commit message)

[ikiwiki.git] / doc / bugs / pages_under_templates_are_invalid.mdwn

diff --git a/doc/bugs/pages_under_templates_are_invalid.mdwn b/doc/bugs/pages_under_templates_are_invalid.mdwn
index 9a363a76d0d1d3218aeee06156be5e083d8da1e3..f7e115d48feb5d7cecc5204e2dbd1a744b9a8f7e 100644 (file)
--- a/doc/bugs/pages_under_templates_are_invalid.mdwn
+++ b/doc/bugs/pages_under_templates_are_invalid.mdwn
@@ -1,5 +1,16 @@
-ages under templates/ are invalid (in fact, not only invalid, but also not well-formed) xhtml pages.
+Pages under templates/ are invalid (in fact, not only invalid, but also not well-formed) xhtml pages.
 
-This problem is especially serious when you change extension from .html to .xhtml in ikiwiki.setup and use Firefox. Since Firefox will display a error message only for not well-formed application/xhtml+xml pages.
+This problem is especially serious when you change extension from .html to
+.xhtml in ikiwiki.setup and use Firefox. Since Firefox will display a error
+message only for not well-formed application/xhtml+xml pages.
 
-It seems that HTML::Template also support <!--Variable--> syntax instead of <Variable>.  Chaning to this syntax will solve this problem, I guess.
+It seems that HTML::Template also support `<!--Variable-->` syntax instead
+of `<Variable>`.  Chaning to this syntax will solve this problem, I guess.
+
+
+Even if changed to `<!-- TMPL_VAR -->` style, the problem may still exist if the template contains if else block.
+
+Maybe just encode all &lt; and &gt; when compling pages within the templates folder will solve this problem.
+
+> I never noticed this bug, since it only happens if the htmlscrubber is
+> disabled. --[[Joey]]