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>al4321@gmail.com</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>al4321@gmail.com</email>. (By the way, you can also use it inside a para.) The standard stylesheets render it as <al4321@gmail.com>. 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: opensuse-doc+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-doc+help@opensuse.org