Added a comment

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

diff --git a/doc/bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn b/doc/bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn
index b40d5d0ffe1e4973629af84fc946da1e5fa49531..3928c219297971b316e927223716ab1f2c9cfe5b 100644 (file)
--- a/doc/bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn
+++ b/doc/bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn
@@ -1,26 +1,38 @@
 I'm trying to put a list of tags in a table, so I carefully make a newline-free taglist.tmpl and then do:
 
-<pre>
-| [ [!inline pages="link(/category/env)" feeds=no archive=yes sort=title template=taglist] ] |
-</pre>
+    | \[[!inline pages="link(/category/env)" feeds=no archive=yes sort=title template=taglist]] |
 
-but there's a line in <pre>inline.pm</pre> that does:
-<pre>
-        return "&lt;div class=\"inline\" id=\"$#inline\"&gt;&lt;/div&gt;\n\n";
-</pre>
+but there's a line in `inline.pm` that does:
+
+    return "&lt;div class=\"inline\" id=\"$#inline\"&gt;&lt;/div&gt;\n\n";
 
 And the extra newlines break the table.  Can they be safely removed?
 
 > If you want an HTML table, I would suggest using an HTML table, which
-> should pass through Markdown without being interpreted further:
+> should pass through Markdown without being interpreted further. To
+> avoid getting the `<div>` inside the `<table>` you can use:
+>
+>     \[[!inline pages="link(/category/env)" feeds=no archive=yes sort=title template=tagtable]]
 >
+> where tagtable.tmpl looks like
+>
+>     <TMPL_IF FIRST>
 >     <table><tr>
->     \[[!inline pages="link(/category/env)" feeds=no archive=yes sort=title template=tagtd]]
->     </tr></table>
+>     </TMPL_IF>
 >
-> where tagtd.tmpl is of the form `<td>your markup here</td>`.
+>     <td>your tag here</td>
+>
+>     <TMPL_IF LAST>
+>     </tr></table>
+>     </TMPL_IF>
 >
 > I don't think you're deriving much benefit from Markdown's table syntax
-> here, if you have to mix it with HTML::Template and ikiwiki directives,
+> if you have to mix it with HTML::Template and ikiwiki directives,
 > and be pathologically careful with whitespace. "Right tool for the job"
-> and all that :-) --[[smcv]]
+> and all that :-)
+>
+> When I edited this page I was amused to find that you used HTML,
+> not Markdown, as its format. It seems oddly appropriate to my answer, but
+> I've converted it to Markdown and adjusted the formatting, for easier
+> commenting.
+> --[[smcv]]