[ZWeb] Zope.org feedback: Zope Documentation / Zope book online
Chris McDonough
chrism@zope.com
01 Sep 2002 16:55:49 -0400
The test looks kinda unreadable in Mozilla at least. Maybe bump up the
font size to 10pt or 12pt or so... and I'm not sure about the blue.. but
I'll let others weigh in on that. ;-)
I must admit that I do like the current green on green scheme, although
I sympathize with folks who think it's distracting... I like it because
it calls attention to the fact that the comments are not actually part
of the text. If we can do this with another scheme that's not quite as
obtrusive, I'm all for it...
Thanks so much for experimenting and letting us see the results, I don't
mean to sound negative... I just don't want it any worse than it already
is. ;-) I'd be happy to change the Zope Book/Dev Guide to a less goofy
scheme, so if you come up with a different stylesheet that is complete
and still looks good in most browsers, let me know, and I'll consider
changing it.
Thanks again,
- C
On Fri, 2002-08-30 at 12:30, Philippe Jadin wrote:
> On Tue, 27 Aug 2002 17:27:39 -0400 Chris McDonough <chrism@zope.com> wrote:
>
> > Sure. If you want to help, visit http://backtalk.sourceforge.net .
> > Any stylesheet or feature work you wish to do with it is possible
> > (one main stylesheet controls all output), and I'd accept any
> > contribution of time to perform the work. I unfortunately cannot do
> > anything with it at the moment.
> >
> > Thanks,
> > - C
>
> Would you prefer this one ?
>
> http://212.190.116.26:8080/test_book/intro
>
> then the css would be :
>
> .comment
> {
> color:#333366;
> font-family:monospace;
> font-size:8pt;
> margin-bottom:10px;
> margin-top:10px;
> padding:2px;
> border:dotted gray 1px;
> display:<dtml-var css_comment_display_style>
> }
>
> (very quick test, and most probably not worth using "as is". If I find
> something nice for the whole css, may I send it?)
>
> Philippe
>
>
> >
> > ----- Original Message -----
> > From: "Trevor Toenjes" <zope@toenjes.com>
> > To: "Chris McDonough" <chrism@zope.com>; "Zope.org Mailinglist"
> > <zope-web@zope.org>; "Carsten (via www.zope.org)"
> > <carsten.siedentopf@digital-spirit.de>
> > Sent: Tuesday, August 27, 2002 4:29 PM
> > Subject: RE: [ZWeb] Zope.org feedback: Zope Documentation / Zope
> > book online
> >
> >
> > > I think Carsten's feedback is pretty accurate.
> > > Turning off Com is not the solution, because he is addressing what
> > the
> > > comments look like when they are on.
> > > I think most people are interested in reading the Comments (some
> > of them are
> > > actually helpful) but not having them pop-out the way they do now.
> > So this
> > > is just a style preference discussion.
> > >
> > > I agree that presenting Comments as more subdued elements makes
> > the main
> > > text in a BackTalk chapter easier to read in HTML. After all,
> > Comments are
> > > not endorsed content by the author and therefore should not
> > overpower the
> > > main text as they do now.
> > >
> > > As a happy medium, if you think the current strong display is
> > better, a
> > > possible solution is to make an additional option just like COM
> > ON/OFF.
> > > Give the option to make Comments display as STRONG or LIGHT.
> > >
> > > $.02
> > >
> > > > -----Original Message-----
> > > > From: zope-web-admin@zope.org [mailto:zope-web-admin@zope.org]On
> > Behalf
> > > > Of Chris McDonough
> > > > Sent: Tuesday, August 27, 2002 9:34 AM
> > > > To: Zope.org Mailinglist; Carsten (via www.zope.org)
> > > > Subject: Re: [ZWeb] Zope.org feedback: Zope Documentation / Zope
> > book
> > > > online
> > > >
> > > >
> > > > Did you try the COM OFF button at the top of the page to turn
> > the
> > > > comments off?
> > > >
> > > > ----- Original Message -----
> > > > From: "Carsten (via www.zope.org)"
> > > > <carsten.siedentopf@digital-spirit.de>
> > > > To: "Zope.org Mailinglist" <zope-web@zope.org>
> > > > Sent: Tuesday, August 27, 2002 6:45 AM
> > > > Subject: [ZWeb] Zope.org feedback: Zope Documentation / Zope
> > book
> > > > online
> > > >
> > > >
> > > > > hi,
> > > > >
> > > > > please change the css for the online version of the zope book.
> > It
> > > > will end up unreadable (some chapters already are).
> > > > > I am new to zope, tried to read the Introduction etc.
> > > > > I ended up reading all the comments first, just because they
> > > > caught my eyes much more than the basic text. It was hard to
> > > > actively ignore them.
> > > > >
> > > > > My suggestions:
> > > > > comments should have less visual contrast than the main text.
> > They
> > > > are comments, not the "core information".
> > > > >
> > > > > - no background color, as it disrupts the reading flow
> > > > > - textcolor should be dark grey or blue-grey (less contrast
> > than
> > > > main text)
> > > > > - the typeface shouldn't be "bolder" than the main typeface
> > > > > - a border just on the left or right, not all around. Or no
> > border
> > > > at all
> > > > > - don't use a yellow image for the comment link. It absorbs
> > > > attention. A grey text link on the bottom right of every
> > paragraph
> > > > would do the job well.
> > > > >
> > > > > These are just suggestions, but they really would increase the
> > > > readability of the zope book online.
> > > > >
> > > > > Greetings, Carsten
> > > > >
> > > > > ----------------------------------------------------------
> > > > > This email was generated from the Zope.org feedback form
> > > > > It was invoked from a link on
> > http://www.zope.org/Documentation
> > > > >
> > > > >
> > > > > _______________________________________________
> > > > > Zope-web maillist - Zope-web@zope.org
> > > > > http://lists.zope.org/mailman/listinfo/zope-web
> > > > >
> > > >
> > > >
> > > > _______________________________________________
> > > > Zope-web maillist - Zope-web@zope.org
> > > > http://lists.zope.org/mailman/listinfo/zope-web
> > >
> > >
> > > _______________________________________________
> > > Zope-web maillist - Zope-web@zope.org
> > > http://lists.zope.org/mailman/listinfo/zope-web
> > >
> >
> >
>
>
> ----
> Philippe Jadin
> 123piano.com
>
>
> _______________________________________________
> Zope-web maillist - Zope-web@zope.org
> http://lists.zope.org/mailman/listinfo/zope-web