This is the mail archive of the
davenport@berkshire.net
mailing list for the Davenport project.
DAVENPORT: Docbook DTD
- To: davenport@amber.ora.com
- Subject: DAVENPORT: Docbook DTD
- From: "M.C.N. Harper" <mcnh2@hermes.cam.ac.uk>
- Date: Mon, 28 Jun 1999 18:31:15 +0100 (BST)
- Reply-To: davenport@berkshire.net
I'm new at this SGML fun, and I've looked through all the documentation
I can find, but still have two questions I need to ask. :(
1) Is there anyway I can influence what gets put on the ALT tag of a
Graphic when the SGML is exported to HTML?
(that's the quick one)
2) I need to document the menu system of a window, and I'm unclear what
SGML structure I should use. Currently I have a system something
like this:
<variablelist>
<title><menuchoice>
<guimenu><accel>F</accel>ile</guimenu>
</menuchoice></title>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo>
<keycap>Alt</keycap>
<keycap>L</keycap>
</keycombo>
</shortcut>
<guimenuitem><accel>L</accel>oad</guimenuitem>
</menuchoice></term>
<listitem>
<para>Yada Yada Yada</para>
</listitem>
</varlistentry>
<varlistentry>
*ETC*
</varlistentry>
*ETC*
</variablelist>
<variablelist>
*ETC
</variablelist>
*ETC*
My problem with this structure is that I think it is an incorrect use of
the <menuchoice> tag, from my reading of the documentation, and the
examples, which suggest that
<menuchoice> should specify full instructions for activating the menu
item, IE the complete...
<menuchoice>
<shortcut>
<keycombo>
<keycap>Alt</keycap>
<keycap>L</keycap>
</keycombo>
</shortcut>
<guimenu><accel>F</accel>ile<guimenu>
<guimenuitem><accel>L</accel>oad</guimenuitem>
</menuchoice>
But that won't fit into a heirachical list, instead the result would be
something like:
File...Load
File...Save
File...Quit
Edit...Cut
*ETC*
which isn't what I want.
So how do I sort this out?
Thanks for any help,
Martin Harper
mcnh2@cam.ac.uk