rename bugs/Inlining_adds_newlines_which_can_break_markdown.html to bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn

1 files changed, 26 insertions, 0 deletions

diff --git a/doc/bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn b/doc/bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn
new file mode 100644
index 000000000..b40d5d0ff
--- /dev/null
+++ b/doc/bugs/Inlining_adds_newlines_which_can_break_markdown.mdwn
@@ -0,0 +1,26 @@
+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>
+
+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>
+
+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:
+>
+>     <table><tr>
+>     \[[!inline pages="link(/category/env)" feeds=no archive=yes sort=title template=tagtd]]
+>     </tr></table>
+>
+> where tagtd.tmpl is of the form `<td>your markup here</td>`.
+>
+> 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,
+> and be pathologically careful with whitespace. "Right tool for the job"
+> and all that :-) --[[smcv]]