G'day Rolf,

++ Thanks for responding. I think we're very much on the same page here.

If I take the HTML produced by the "Textile to HTML converter", then modify it such that it renders the same (or at least equivalent) perldoc output, I have: 

<h1 id="test-pod-to-wiki-textile">Test POD to Wiki (Textile)</h1>
<p>Test conversion of various POD elements to Textile format.</p>
<h2 id="lists">Lists</h2>
<p>Test nesting.</p>
<ul>
<li>Point 1
<p>Point 1 Para 1</p>
<p>Point 1 Para 2</p>
<pre><code>    Point 1 Para 2 Code1

    Point 1 Para 2 Code2</code></pre>
<p>Point 1 Para 3</p>

<ul>
<li>Point 1.1
<p>Point 1.1 Para 1</p>
<p>Point 1.1 Para 2</p>
<pre><code>    Point 1.1 Para 2 Code1

    Point 1.1 Para 2 Code2</code></pre>
<p>Point 1.1 Para 3</p>
</li>

<li>Point 1.2
<p>Point 1.2 Para 1</p>
<p>Point 1.2 Para 2</p>
<pre><code>    Point 1.2 Para 2 Code1

    Point 1.2 Para 2 Code2</code></pre>
<p>Point 1.2 Para 3</p>
</li>
</ul>

</li>

<li>Point 2
<p>Point 2 Para 1</li>
<p>Point 2 Para 2</p>
<pre><code>    Point 2 Para 2 Code1

    Point 2 Para 2 Code2</code></pre>
<p>Point 2 Para 3</p>
</li>
</ul>

[download]

If I look at that in my browser, the only difference between it and perldoc is the characters used for the dot points: browser has disc (level 1) and circle (level 2); perldoc has asterisk for both levels (the indentation is correctly rendered in both cases).

If I pass the HTML (above) through an HTML to Textile converter, everything after the "Test nesting." paragraph is pure HTML (there's no Textile at all here). It looks like this: 

h1(#test-pod-to-wiki-textile). Test POD to Wiki (Textile)

Test conversion of various POD elements to Textile format.

h2(#lists). Lists

Test nesting.

<ul>
<li><p>Point 1</p>
<p>Point 1 Para 1</p>
<p>Point 1 Para 2</p>
<pre>
    Point 1 Para 2 Code1

    Point 1 Para 2 Code2
</pre>

<p>Point 1 Para 3</p>
<ul>
<li><p>Point 1.1</p>
<p>Point 1.1 Para 1</p>
<p>Point 1.1 Para 2</p>
<pre>
    Point 1.1 Para 2 Code1

    Point 1.1 Para 2 Code2
</pre>

<p>Point 1.1 Para 3</p></li>
<li><p>Point 1.2</p>
<p>Point 1.2 Para 1</p>
<p>Point 1.2 Para 2</p>
<pre>
    Point 1.2 Para 2 Code1

    Point 1.2 Para 2 Code2
</pre>

<p>Point 1.2 Para 3</p></li>
</ul>
</li>
<li><p>Point 2</p>
<p>Point 2 Para 1</p></li>
</ul>

[download]

The converter I've been using throughout is Pandoc.

Although I've used Textile a lot, I wouldn't claim to be an expert. In HTML, an <li> is a block element allowing the inclusion of other block elements; e.g. <p>, <ul>, and so on. In Textile, you can implement <li> nesting only with very simple constructs, such as: 

* Level 1
** Level 1.1
** Level 1.2
* Level 2
* Level 3
** Level 3.1
** Level 3.2

[download]

You can't turn any of those * contructs into real, block-level <li> constructs that allow complex block structures to be included.

I believe this to be the fundamental, underlying problem. Textile neither has the capacity for, nor was designed for, this level of markup complexity.

"Otherwise share your tests with the author of Pod::Simple::Wiki and file a bug report."

Yes, I was definitely thinking along these lines myself; however, looking at https://github.com/jmcnamara/pod-simple-wiki/issues, I was wondering if a fix would be provided in a timely manner, or if I'd just get "Thanks for the report. Can you provide a patch?".

I'll await other input and then make a decision on how to procede. Thanks again for your response.

— Ken

In reply to Re^2: Pod::Simple::Wiki::Textile alternatives by kcott
in thread Pod::Simple::Wiki::Textile alternatives by kcott

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.