Hi Alexey,
On Monday 08 January 2007 01:01, Alexey Eremenko wrote:
> [...]
> 1. Is there any ability to add author's email in the <author> section?
Yes, use:
<author>
<firstname>Alexey</firstname>
<surname>Eremenko</surname>
<email>[EMAIL PROTECTED]</email>
</author>
See http://www.docbook.org/tdg/en/html/author.html for a more verbose
example.
> 1.a. What is the correct syntax for email integration (so that it will
> be clickable)?
It's only <email>[EMAIL PROTECTED]</email>. (By the way, you can also use
it inside a para.)
The standard stylesheets render it as <[EMAIL PROTECTED]>. The text itself
is clickable of course (a "mailto:"; scheme is automatically inserted.)
> 2. what's the conceptual difference between <orderlist><listitem> and
> <procedure><step>,
Good point! :-) To answer your question: There is a *semantic* difference.
Rebecca noted already some points. I just want to highlight the official
definitions, according to "DocBook: The Definitive Guide":
procedure:
A list of operations to be performed in a well-defined sequence
orderedlist:
A list in which each entry is marked with a sequentially
incremented label
Although it looks the same in HTML and PDF, it doesn't mean it will be in
the future too.
For example, according to the layout spec for our openSUSE manuals a
procedure is rendered with bold numerals. An orderedlist has just normal
style. It would be impossible to apply these different looks if we would
use ordinary orderedlists only.
> As it looks the same in html output?
At the moment yes. But it's always good to be prepared for the future,
isn't it? ;-)
Bye,
Tom
--
----------------------------------------------------------------------
SUSE LINUX Products GmbH >o) Documentation Team
Maxfeldstrasse 5 /\\ Technical Editor
90409 Nuernberg, Germany _\_v http://en.opensuse.org/Documentation_Team
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
