docbook-apps

Back to discussions
Expand all | Collapse all

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

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

    Posted 12-02-2013 13:41
    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>

    <sect2 renderas="sect3">

    ....
    <sect2>

    ...


    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




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

    Posted 12-02-2013 16:22
    Why not just ditching <sect1>, <sect2>, etc. and stick to
    ?



    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.
    >
    > <sect1>
    >
    > <sect2 renderas="sect3">
    >
    > ....
    > <sect2>
    >
    > ...
    >
    > 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:
    >
    >

    Application Basics

    -> chapter name
    >

    Description of application.


    >

    Setting Up a Project


    >

    Short description of project setup, plus links to relevant topics.


    >

    Setting Up A Task


    >

    Short description of task setup, plus links to relevant topics.


    >

    How to Set Up a Project

    -> first "true" section
    >

    Procedure for setting up a project.


    >
    > 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
    >
    >


    --
    Fabián Mandelbaum
    IS Engineer



Related Content