Error: Only book doctypes can contain level 0 sections about asciidoctor-latex

[mojavelinux]

Passing -d book is a workaround, but I don't understand why it works for latex but not html.

That's because, at the moment, the validation for heading levels as they pertain to the doctype happens in the converter, not in the parser. Ideally, that validation should be moved to the parser so that it is enforced regardless of the converter. This is just a current quirk of the Asciidoctor pipeline. This would need to be enforced in the LaTeX backend to be consistent.

Level-0 sections in the content (other than the document header) are not allowed unless the doctype is book. This requirement is mostly a side-effect of needing to generate valid DocBook. It doesn't make much sense in the HTML backend, to be honest. However, you can think of it as a way of communicate intended structure of the document.

[nh2]

Passing -d book is a workaround, but I don't understand why it works for latex but not html.

[jxxcarlson]

I'll take a look at it

Sent from my iPhone

On Jan 20, 2015, at 3:55 PM, Niklas Hambüchen [email protected] wrote:

Hi, a question:

If I use this diff

diff --git a/try-out/eqno-latex.adoc b/try-out/eqno-latex.adoc
index c98e741..207e51f 100644
--- a/try-out/eqno-latex.adoc
+++ b/try-out/eqno-latex.adoc
@@ -1,5 +1,6 @@
-== Numbered Equations
+= Numbered Equations

+== Something

The environment [env.equation] is automatically
numbered by default, as in the examples below.
that changes the == heading to a =, and run with asciidoctor -b html5 -r asciidoctor-latex --attribute=stem=latexmath --backend=html eqno-latex.adoc, then I get

asciidoctor: ERROR: eqno-latex.adoc: line 1: only book doctypes can contain level 0 sections
This only happens with the html backend, with the latex backend everything is fine.

What's going on here?

—
Reply to this email directly or view it on GitHub.