Re: HOWTO duplicate the DocBook5 element reference synopsis

[Norman Walsh <ndw@nwalsh.com>]

Jeff Chimene <jchimene@gmail.com> writes:

> Hi:
>
> I'd like to duplicate the DocBook5 element reference synopsis layout.
>
> Looking at the generated HTML, I see the following:
>
>> <div class="refsynopsisdiv" title="Synopsis">
>> <h2>Synopsis</h2>
>> <div class="itemizedlist">
>> <ul class="itemizedlist" compact="compact" type="disc">
>> <li class="listitem">Zero or more of:
>
> In the <li> item above, what DocBook5 tags produce the "Zero or more
> of:" run-in with no markup?

The XML is generated from the RNG schema. The generated XML looks like
this:

  <refsynopsisdiv>
    <title>Synopsis</title>
    <para condition="expanded">listitem <phrase role="cceq">::=</phrase>
    </para>
    <itemizedlist spacing="compact" role="element-synopsis" condition="expanded">
      <listitem>
        <para>One or more of:</para>
        <itemizedlist spacing="compact" role="element-synopsis">
          <listitem>
            <para>
              <tag>annotation</tag>
            </para>
          </listitem>
          <!-- ... -->
          <listitem xml:id="d3e38755-db.indexing.inlines">
            <para>
              <emphasis role="patnlink" linkend="ipatn.db.indexing.inlines">Indexing inlines</emphasis>
            </para>
            <itemizedlist role="patnlist db.indexing.inlines" xml:id="l.d3e38755-db.indexing.inlines">
              <listitem>
                <para>
                  <tag>indexterm</tag> <phrase role="pattern">(db.indexterm.endofrange)</phrase>
                </para>
              </listitem>
              <listitem>
                <para>
                  <tag>indexterm</tag> <phrase role="pattern">(db.indexterm.singular)</phrase>
                </para>
              </listitem>
              <listitem>
                <para>
                  <tag>indexterm</tag> <phrase role="pattern">(db.indexterm.startofrange)</phrase>
                </para>
              </listitem>
            </itemizedlist>
          </listitem>

etc., ad nauseam.

There are then special rules for formatting that markup to produce HTML.
The one that gives you the list item with no markup is this one:

<xsl:template match="para[ancestor::itemizedlist[@role='element-synopsis']]"
	      priority="100">
  <!-- force this kind of list to be "compact" -->
  <xsl:apply-templates/>
</xsl:template>

The stylesheets are in the repository in /defguide5/en/stylesheets/

Hope that helps.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | If you understand: things are as
http://www.oasis-open.org/docbook/ | they are. If you do not
Chair, DocBook Technical Committee | understand: things are as they are.

PGP signature