Re: [docbook] How to format a check-list like output.

[steven dot cogorno at sun dot com (Steven Cogorno)]

Philippe CHARLIER said:
> What I hear by "check-list" is something like this :
> 
> ------------------------------------------------------
> ENG ANTI ICE ................................. AS RQRD
>  If icing conditions description text blah blah descri
>  ption text blah blah description text blah blah descr
>  iption text blah blah
> 
> WING ANTI ICE ................................ AS RQRD
> 
> APU MASTER switch (if APU not required) .......... OFF
> 
> ANNOUNCE ....................... "CLEAR TO DISCONNECT"
> ------------------------------------------------------


As a pilot, I am especially aware of the need for good checklists.  In the
past when I have created modified checklists from the base manufacturer's
checklist, I ended up creating a special element structure rather than
trying to cram it into a DocBook element.

I think you might be able to force it into variable list with a style
role attribute.  It would be ugly, but you could do something like this:

<variablelist role="checklist">
  <varlisetentry>
    <term>ENG ANTI-ICE</term>
    <listitem>
      <para>AS RQRD</para>
      <para>if icing conditions...</para>
    </listitem>
  </varlistentry>
</variablelist>

You would have to modify the style so that the first para in a varlist
listitem is interpreted as the checklist setting and any subsequent para
item as description.

But in the true spirit of descriptive markup, you might want to create your
own markup structure as an extension.  It will make more sense to your
authors and to anyone who might consume your SGML/XML later.



Steve Cogorno
Sun Microsystems

To unsubscribe from this list, send a post to docbook-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.