OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Recommended docbook element for a "Problems section"

<formalpara> might do it, one for each problem

On 01/10/2016 05:55 PM, Erik Leunissen wrote:
Hi all,

I'm in the process of writing an educational textbook. The textbook is a
docbook book, containing several chapters. Each chapter contains several
sections with "explained content", a "Problems section" and a
bibliography. Like the sections, the "Problems section" and the
bibliography occur at the same level just below a chapter.

(B.t.w. the word "section" in "Problems section" is just a matter of
speak, not meant to be a docbook element, not yet anyway)

Sample document structure:

Table of contents
Chapter 1
   1.1 First section
   1.2 Second section
   1.3 Third section

Chapter 2


My question relates to the "Problems" section in each chapter. Like the
bibliography it must not have a label, but must occur in the table of

I've been looking for a docbook element for such a "Problems section",
and I have difficulty finding an appropriate one:
- I can't make it a docbook section because these are processed to
display a label.
- a Q&A set seems inappropriate since there are only questions (which
are not "Frequently asked" anyway; and answers are not supposed to be
provided in the same structural element)
- I've been thinking about using a section element with a dedicated role
attribute, that triggers customized processing, but that's just a wild
idea for now.

In case it matters: my processing toolchain is:
   docbook5 XML | xsltproc | fop | pdf

I'd appreciate very much any suggestions,

Erik Leunissen.

To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

Ron Catterall Ph.D, DSc

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]