On 16/12/11 05:44, Dag Wieers wrote:
On Thu, 15 Dec 2011, Stuart Rackham wrote:
On 15/12/11 02:21, Dag Wieers wrote:
I investigated the error, and made this particular check DocBook specific
(as
some of the other checks are already checking for the docbook backend),
however
if I do that, asciidoc no longer complains but silently drops the section
titles
from the output:
You are correct that DocBook enforces this restriction but it's because of
what we mean by sections and subsections and applies equally to AsciiDoc
source. Sections and nested subsections are the basic document unit and are
hierarchically ordered from a top level. They contain a section title and a
section body -- you can't put a section out of order into a document.
I don't know what this means (putting a section out of order). Maybe the fact
that ODF calls a piece of the document (with specific layout controls) a section
is the basis for the confusion. I don't want to break the hierarchical structure
at all (not like eg. sidebars or admonitions).
Ok, I need the simplest possible example that illustrates the problem (keep in
mind that I'm not familar with ODF or the columns feature).
What I functionally require is a way to make a part of a document, or the whole
document content using columns, including titles, sections, subtitles,
subsections, paragraphs other blocks. This is typically used for eg. booklets or
technical flyers. And it's not theoretical, someone writing a booklet for an
organisation is interested in using asciidoc over libreoffice for generating the
monthly "magazine", using 2 columns for articles.
Currently this example would use 2 columns for a complete chapter:
== Report on group activity
[columns,2]
--
=== Welcome participants
Very early in the day ...
=== Embarking on the trip
The bus arrived on time even though ...
=== First stop at ...
Our breakfast plans included ...
--
My implementation would translate a columns-style openblock into a section with
X columns. This works fine, except no titles are allowed inside this openblock
(which is called a section in ODF).
But you can can insert titles that are not bound to a section body anywhere,
so long as you set the style to 'float' (this marks the title a stand-alone
entity, see: http://www.methods.co.nz/asciidoc/userguide.html#_floating_titles).
The fact that floating titles do not appear in the TOC is in itself a problem,
but I don't see why we cannot use normal titles in the normal text-flow in an
openblock (which is split into 2 columns). The subsection content is included,
only the titles are missing.
--
You received this message because you are subscribed to the Google Groups
"asciidoc" group.
To post to this group, send email to asciidoc@googlegroups.com.
To unsubscribe from this group, send email to
asciidoc+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/asciidoc?hl=en.
