Re: [docbook-apps] Adding an additional "section" between a sect1 and a sect2

[David Goss <goss@fstrf.org>]

I just wanted to point out the renderas ("render as") attribute, which actually might be closer to what you're looking for. This would let you use section levels correctly, but you could select individual ones to be formatted differently, e.g.

<sect1>
    <title>Application Basics</title>
    <sect2 renderas="sect3">
        <title>Setting Up a Project</title>
        ....
    <sect2>
        <title>How to Setup a Project</title>
        ...

See http://www.sagehill.net/docbookxsl/Typography.html#UsingRenderas

---
David Goss, M.A.
Technical Writer, Laboratory Division
Frontier Science & Technology Research Foundation
4033 Maple Road
Amherst, NY 14226
(716) 834-0900 x7218

---

From: "Jen" <jennee@gmail.com>
To: docbook-apps@lists.oasis-open.org
Sent: Thursday, November 28, 2013 5:32:43 AM
Subject: [docbook-apps] Adding an additional "section" between a sect1 and a sect2

Hi,

I'm trying to convert an existing document to DocBook and I'm struggling with a structure that is not (I think!) supported in DocBook (H3 between H1 and H2).

Right now, the layout of this section is (in HTML) something like:

<h1>Application Basics</h1>                   -> chapter name

<p>Description of application.</p>

<h3>Setting Up a Project</h3>

<p>Short description of project setup, plus links to relevant topics.</p>

<h3>Setting Up A Task</h3>

<p>Short description of task setup, plus links to relevant topics.</p>

<h2>How to Set Up a Project</h2>             -> first "true" section

<p>Procedure for setting up a project.</p>

Now, I don't think this can work in DocBook, since you can't have sect1>sect3>sect2... but I'd like to maintain the smaller headings in the chapter introduction. Is there a tag that I can use for this? Worst case scenario, I'll just have an <emphasis role="bold">, but I'd prefer to use a dedicated tag so I could also change the font size and so on.

Thanks in advance,

Jen