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] Adding an additional "section" between a sect1 and a sect2

Why not just ditching <sect1>, <sect2>, etc. and stick to <section>?

On Mon, Dec 2, 2013 at 10:40 AM, David Goss <goss@fstrf.org> wrote:
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.

    <title>Application Basics</title>
    <sect2 renderas="sect3">
        <title>Setting Up a Project</title>
        <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


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,

Fabián Mandelbaum
IS Engineer

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