Context: trying to use Asciidoctor with Hugo (static site generator).
Hi,
Default Hugo uses the blackfriday MD processor.
When I use an
test.md
# H1ADOC
Hello world.
## H2ADOC
Asciidoctor and Hugo would be a great team.
* one
* two
## H2ADOC
Bye.
Converting it to html with blackfriday produces the expected
<h1>H1ADOC</h1>
<p>Hello world.</p>
<h2>H2ADOC</h2>
<p>Asciidoctor and Hugo would be a great team.</p>
<ul>
<li>one</li>
<li>two</li>
</ul>
<h2>H2ADOC</h2>
<p>Bye.</p>
When I use a similar Asciidoctor
test.adoc document
= H1ADOC
Hello world.
== H2ADOC
Asciidoctor and Hugo would be a great team.
* one
* two
== H2ADOC
Bye.
And convert it to html with
asciidoctor -a stylesheet=null.css -d article --no-header-footer test.adoc
(note: the null.css is just a hack to avoid all style inclusion in the result)
it produces the following html code
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>Hello world.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_h2adoc">H2ADOC</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Asciidoctor and Hugo would be a great team.</p>
</div>
<div class="ulist">
<ul>
<li>
<p>one</p>
</li>
<li>
<p>two</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_h2adoc_2">H2ADOC</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Bye.</p>
</div>
</div>
</div>
Note that
there is is no H1 and my text is gone.
Perhaps there is a reason for this behavior but it was very unexpected for me and it took some hacking to realize that this is creating issues in Hugo rendering compared to using .md. I really like Asciidoctor, but would expect this simple test.adoc with --no-header-footer option to give similar results like the markdown processing. Which has nothing to do with Hugo of course.
Personally, given the fact that my text "H1ADOC" is nowhere to be found in the resulting html, I would think this is bug? I thought it would be perfectly acceptable to use H1 in a .adoc file?
With and without the option of --no-header-footer.
Or is this on purpose?
All comment, solution or workaround is welcome.
Locked
