[ZWeb] Zope Book typog. conventions

Peter Sabaini peter at sabaini.at
Tue Jan 6 15:32:07 EST 2004

Hello list,

I'm doing some cleanup on the Zope Book (2.6) and I noticed that the 
"typographical conventions", ie. using italics for new terms and 
fixed-with for code etc. aren't followed too closely. Call me anal but 
this bothers me.

Partly this may be because the definition of those conventions is a 
little ambiguous. From the Preface:

Conventions Used in This Book

This book uses the following typographical conventions:

     Italics indicate variables and names and is also used to introduce 
new terms.

Fixed width
     Fixed width text indicates objects, commands, hyperlinks, and code 

Python and Zope don't make much difference between "variables" and 
objects; also its not clear what "names" should be.

I'd like to change this to:

Italic -- new terms and UI interface elements

Fixed width -- variables, objects, attributes, properties, commands, 
hyperlinks, code listings

and fixup the typography in the book according to this.


  - peter.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/x-pkcs7-signature
Size: 2823 bytes
Desc: S/MIME Cryptographic Signature
Url : http://mail.zope.org/pipermail/zope-web/attachments/20040106/b70b706a/smime.bin

More information about the Zope-web mailing list