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



On Mon, Dec 2, 2013 at 10:40 AM, David Goss <[email protected]> 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>
>     <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" <[email protected]>
> *To: *[email protected]
> *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
>
>


-- 
Fabián Mandelbaum
IS Engineer

Reply via email to