docbook-apps

  • 1.  Re: [docbook-apps] Nested Itemized Lists

    Posted 06-25-2010 12:00
    A nested itemizedlist/listitem should be within the main listitem, like so:

    <itemizedlist>
    <listitem>
    item 1
    <itemizedlist>
    <listitem>
    item 1.1
    </listitem>
    </itemizedlist>
    </listitem>
    <listitem>
    item 2
    </listitem>
    </itemizedlist>

    (It’s the same in (X)HTML, if you are familiar with that)

    Bela

    On Friday 25 June 2010 13:49:56 Tom Browder wrote:
    > I want a nested, itemized list but haven't found a suitable
    > explanation on the lists or in either docbook book.
    >
    > I want a a nested, itemized list to look something like this:
    >
    > + item 1
    > - item 1.1
    > + item 2
    >
    > I have tried q ways:
    >
    > Method 1:
    >
    > <itemizedlist>
    > <listitem><para>item 1</para></listitem>
    > <listitem>
    > <itemizedlist>
    > <listitem><para>item 1.1</para></listitem>
    > </itemizedlist>
    > </listitem>
    > <listitem><para>item 2</para></listitem>
    > </itemizedlist>
    >
    > Yields:
    >
    > + item 1
    > + - item 1.1
    > + item 2
    >
    > Order is correct, but item 1.1 has two bullets.
    >
    > Method 2:
    >
    > <itemizedlist>
    > <listitem><para>item 1</para></listitem>
    > <itemizedlist>
    > <listitem><para>item 1.1</para></listitem>
    > </itemizedlist>
    > <listitem><para>item 2</para></listitem>
    > </itemizedlist>
    >
    > Yields:
    >
    > - item 1.1
    > + item 1
    > + item 2
    >
    > Bullets are correct, but items out of order.
    >
    > The lists basically look the same in html and pdf except both levels
    > of bullets are the same in pdf but different in html.
    >
    > What should I do to correct method 1's two bullets? Or is there a
    > better way altogether?
    >
    > Thanks.
    >
    > -Tom
    >
    > Thomas M. Browder, Jr.
    > Niceville, Florida
    > USA
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org



  • 2.  Re: [docbook-apps] Nested Itemized Lists

    Posted 06-25-2010 12:10
    On Fri, Jun 25, 2010 at 07:00, Bela Hausmann <post@belahausmann.name> wrote:
    > A nested itemizedlist/listitem should be within the main listitem, like so:
    >
    > <itemizedlist>
    >  <listitem>
    >    item 1
    >    <itemizedlist>
    ...

    Thanks, Bela.

    Can anyone point to a source of a good explanation of such details?

    -Tom



  • 3.  RE: [docbook-apps] Nested Itemized Lists

    Posted 06-25-2010 18:12
    Tom,

    The DocBook Definitive Guide is where I'd go. The syntax descriptions
    will give you that information. There are also examples, though as
    editor I'm embarrassed to say that the list examples, though they
    mention nesting, don't include a nested example.

    You can see an online version here:

    http://docbook.org/tdg5/en/html/docbook.html

    The print version is available through O'Reilly here:

    http://oreilly.com/catalog/9780596805012

    Best Regards,
    Dick Hamilton
    ---------------------------------
    XML Press
    XML for Technical Communicators
    http://xmlpress.net
    (970) 231-3624


    >


  • 4.  Re: [docbook-apps] Nested Itemized Lists

    Posted 06-25-2010 21:07
    On Fri, Jun 25, 2010 at 13:11, Dick Hamilton <rlhamilton@frii.com> wrote:
    > Tom,
    >
    > The DocBook Definitive Guide is where I'd go. The syntax descriptions
    > will give you that information.

    I have that book (DB v5), and the syntax was detailed, but not easy to
    use in a casual reading. I did try to figure it out by looking at the
    content models. but I got lost in the maze.

    What I should have done was taken the content models and broken them
    down in some kind of vertical fashion to make it easier to check by
    eye, Another problem was that Relax NG validation by both nvdl and
    xmllint didn't catch the errors in my two attempted nested forms

    > There are also examples, though as
    > editor I'm embarrassed to say that the list examples, though they
    > mention nesting, don't include a nested example.

    Yes, that would have helped, but you guys pack a LOT of info in that
    book! You can't cover examples of everything.

    A book (or web site) with detailed examples of output vs. input would
    be very useful. The tools are described in great detail lots of
    places, but hard-core complete book examples, including the
    customization style sheets are hard to find (I'm still looking). Any
    chance of getting such for Docbook 5? I scrounged all around
    O'Reilly's site and couldn't find anything except final examples
    generated by customized styles sheets which were not there.

    Thanks, Dick.

    Regards,

    -Tom



  • 5.  Re: [docbook-apps] Nested Itemized Lists

    Posted 06-26-2010 05:55
    On Saturday 26 Jun 2010 00:07:11 Tom Browder wrote:
    > On Fri, Jun 25, 2010 at 13:11, Dick Hamilton <rlhamilton@frii.com> wrote:
    > > Tom,
    > >
    > > The DocBook Definitive Guide is where I'd go. The syntax descriptions
    > > will give you that information.
    >
    > I have that book (DB v5), and the syntax was detailed, but not easy to
    > use in a casual reading. I did try to figure it out by looking at the
    > content models. but I got lost in the maze.
    >
    > What I should have done was taken the content models and broken them
    > down in some kind of vertical fashion to make it easier to check by
    > eye, Another problem was that Relax NG validation by both nvdl and
    > xmllint didn't catch the errors in my two attempted nested forms
    >
    > > There are also examples, though as
    > > editor I'm embarrassed to say that the list examples, though they
    > > mention nesting, don't include a nested example.
    >
    > Yes, that would have helped, but you guys pack a LOT of info in that
    > book! You can't cover examples of everything.
    >
    > A book (or web site) with detailed examples of output vs. input would
    > be very useful. The tools are described in great detail lots of
    > places, but hard-core complete book examples, including the
    > customization style sheets are hard to find (I'm still looking). Any
    > chance of getting such for Docbook 5? I scrounged all around
    > O'Reilly's site and couldn't find anything except final examples
    > generated by customized styles sheets which were not there.
    >

    Some of my latest essays are in DocBook 5 format:

    http://www.shlomifish.org/philosophy/

    Though they use the
    tag instead of <book>.

    And many of the manuals of the Mandriva distribution are in DocBook 5 format.

    Hope it helps.

    Regards,

    Shlomi Fish

    --
    -----------------------------------------------------------------
    Shlomi Fish http://www.shlomifish.org/
    "The Human Hacking Field Guide" - http://shlom.in/hhfg

    God considered inflicting XSLT as the tenth plague of Egypt, but then
    decided against it because he thought it would be too evil.

    Please reply to list if it's a mailing list post - http://shlom.in/reply .



  • 6.  Re: [docbook-apps] Nested Itemized Lists

    Posted 06-26-2010 11:46
    On Sat, Jun 26, 2010 at 00:55, Shlomi Fish <shlomif@iglu.org.il> wrote:
    > On Saturday 26 Jun 2010 00:07:11 Tom Browder wrote:
    >> On Fri, Jun 25, 2010 at 13:11, Dick Hamilton <rlhamilton@frii.com> wrote:
    ...
    > Some of my latest essays are in DocBook 5 format:
    >
    > http://www.shlomifish.org/philosophy/
    >
    > Though they use the
    tag instead of <book>.
    >
    > And many of the manuals of the Mandriva distribution are in DocBook 5 format.

    Thanks, Shlomi, and I enjoyed visiting your site,

    Regards,

    -Tom