Re: [docbook] Markup for Protocol/Dialogue

[Stephane Bortzmeyer <bortzmeyer@nic.fr>]

On Fri, May 23, 2003 at 11:13:04AM +0200,
 Gisbert Amm <gia@webde-ag.de> wrote 
 a message of 39 lines which said:

> > Server: HERE
> > Client: HELO I am here
...
> <screen>
>   <systemitem class="systemname">Server</systemitem>:
> <computeroutput><command>HERE</command></computeroutput>
>   <systemitem class="systemname">Client</systemitem>:
> <computeroutput><command>HELO</command><replaceable> I am
> here</replaceable></computeroutput>

It is very heavy and the formal protocol is quite lost among these
many elements. I would suggest a custom markup allowing things like:

<server>HERE</server>
<client>HELO</client>

If you're not used to DocBook customization, here is an example in the
declaration:

<!ELEMENT server (#PCDATA)>
<!ELEMENT client (#PCDATA)>
<!ENTITY % local.para.char.mix
        "|server|client">

And a possible (untested) stylesheet customization, here for HTML:

<xsl:template match="server">
<CODE><xsl:text>Server: </xsl:text><xsl:value-of select="text()"</CODE>
</xsl:template>
<!-- Same thing for the client -->