do we have a style guide for this publication? I'm thinking along the lines of which fonts/effects to use in which circumstances, that sort of thing. regards Tony ___________________________________________________________ Copy addresses and emails from any email account to Yahoo! Mail - quick, easy and free. http://uk.docs.yahoo.com/trueswitch2.html --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-doc+help@opensuse.org
Hi Tony, On Thursday 21 December 2006 17:08, Tony Pattison wrote:
do we have a style guide for this publication?
Yes, it's available from the main Wiki page under "File Release" (right side) or use the following link: http://developer.novell.com/wiki/index.php/Special:File/lfl/styleguide-opens... Mainly Rebecca maintains the style guide. If you have specific questions she knows more than I.
I'm thinking along the lines of which fonts/effects to use in which circumstances, that sort of thing.
Well, from my perspective, the style guide covers more of structural issues of the text than of layout or font effects (Rebecca, please correct me if I tell nonsense! ;). Normally an author doesn't have to care about layout issues -- the layout is covered by the DocBook XSL stylesheets. An author just uses the right element name for a specific purpose. For example, if you want to mark up an email adress, you use <email>foo@example.com</email>. How it is rendered or displayed is the responsibility of the stylesheet(s). Does this answer your questions? Best wishes, 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
Well, from my perspective, the style guide covers more of structural issues of the text than of layout or font effects (Rebecca, please correct me if I tell nonsense! ;). Normally an author doesn't have to care about layout issues -- the layout is covered by the DocBook XSL stylesheets.
An author just uses the right element name for a specific purpose. For example, if you want to mark up an email adress, you use <email>foo@example.com</email>. How it is rendered or displayed is the responsibility of the stylesheet(s).
Does this answer your questions?
Tom is correct here. The style guide deals with writing and structural issues. Font issues are resolved by style sheets and I think we can change those pretty easily. This is the advantage of using docbook. We mark things for what they are (some info about what tags to use is also in the style guide) then the style sheet makes it look pretty. Right now we have an extremely simple (aka boring) style sheet. We need a better one soon, but Tom wanted to leave the details up to the community. So the question is really what does the community want things to look like? Thomas is very experienced with this stuff and we have several others on the team with experience with basic stylesheets (not me, I just whine when I don't like them) but we'd love the community to get involved here. All this means that we can extensively adjust the look and feel of the book without having to touch each and every file. I like this a lot. :-) Sincerely, Rebecca --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-doc+help@opensuse.org
participants (3)
-
Rebecca Walter
-
Thomas Schraitle
-
Tony Pattison