public inbox for [email protected]
help / color / mirror / Atom feed7.4 official docs : Fonts?
24+ messages / 13 participants
[nested] [flat]
* 7.4 official docs : Fonts?
@ 2003-11-18 05:03 elein <[email protected]>
0 siblings, 1 reply; 24+ messages in thread
From: elein @ 2003-11-18 05:03 UTC (permalink / raw)
To: pgsql-docs; +Cc: elein <[email protected]>
Have the fonts gone wild in the new 7.4 documentation?
In the tables describing the functions and
operators and in the table of contents,
there are at least three different fonts
of varied sizes. The usage for different types
of objects seems to be fairly consistent,
however, the varied sizes of the different fonts
make things very hard to read.
Is there anything I or someone can do to help this problem?
elein
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-19 20:10 Josh Berkus <[email protected]>
parent: elein <[email protected]>
0 siblings, 3 replies; 24+ messages in thread
From: Josh Berkus @ 2003-11-19 20:10 UTC (permalink / raw)
To: elein <[email protected]>; pgsql-docs
People,
> of varied sizes. The usage for different types
> of objects seems to be fairly consistent,
> however, the varied sizes of the different fonts
> make things very hard to read.
Elein is correct, our variety of styles does look odd and can cause issues
with readability. See, for example,
http://www.postgresql.org/docs/current/static/functions-string.html
Can we experiment with different SGML-to-HMTL font styles to find one that's a
little easier on the eyes? What I find particularly difficult are the
function parameter columns; the mix of "normal" italics with "bold" italics.
Comments? Responses?
--
-Josh Berkus
Aglio Database Solutions
San Francisco
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-19 22:20 Robert Treat <[email protected]>
parent: Josh Berkus <[email protected]>
2 siblings, 1 reply; 24+ messages in thread
From: Robert Treat @ 2003-11-19 22:20 UTC (permalink / raw)
To: Josh Berkus <[email protected]>; +Cc: elein <[email protected]>; pgsql-docs
On Wed, 2003-11-19 at 15:10, Josh Berkus wrote:
> People,
>
> > of varied sizes. The usage for different types
> > of objects seems to be fairly consistent,
> > however, the varied sizes of the different fonts
> > make things very hard to read.
>
> Elein is correct, our variety of styles does look odd and can cause issues
> with readability. See, for example,
> http://www.postgresql.org/docs/current/static/functions-string.html
>
> Can we experiment with different SGML-to-HMTL font styles to find one that's a
> little easier on the eyes? What I find particularly difficult are the
> function parameter columns; the mix of "normal" italics with "bold" italics.
>
> Comments? Responses?
>
Whatever we had in 7.3 we should switch back to:
http://www.postgresql.org/docs/7.3/static/functions-string.html
Robert Treat
--
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-19 22:38 Randolf Richardson, DevNet SysOp 29 <[email protected]>
parent: Robert Treat <[email protected]>
0 siblings, 0 replies; 24+ messages in thread
From: Randolf Richardson, DevNet SysOp 29 @ 2003-11-19 22:38 UTC (permalink / raw)
To: pgsql-docs
[sNip]
>> http://www.postgresql.org/docs/current/static/functions-string.html
[sNip]
> Whatever we had in 7.3 we should switch back to:
>
> http://www.postgresql.org/docs/7.3/static/functions-string.html
I think the fancy fonts should be abandonded altogether in favour of
using the web browser's default fonts. In Opera, the text on both of those
page (quoted above) are difficult to read because the choice of font is
horrible.
--
Randolf Richardson - [email protected]
Inter-Corporate Computer & Network Services, Inc.
Vancouver, British Columbia, Canada
http://www.8x.ca/
This message originated from within a secure, reliable,
high-performance network ... a Novell NetWare network.
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-19 23:12 Peter Eisentraut <[email protected]>
parent: Josh Berkus <[email protected]>
2 siblings, 1 reply; 24+ messages in thread
From: Peter Eisentraut @ 2003-11-19 23:12 UTC (permalink / raw)
To: Josh Berkus <[email protected]>; +Cc: elein <[email protected]>; pgsql-docs
Josh Berkus writes:
> Elein is correct, our variety of styles does look odd and can cause issues
> with readability. See, for example,
> http://www.postgresql.org/docs/current/static/functions-string.html
>
> Can we experiment with different SGML-to-HMTL font styles to find one that's a
> little easier on the eyes? What I find particularly difficult are the
> function parameter columns; the mix of "normal" italics with "bold" italics.
Compare with the "original" version:
http://developer.postgresql.org/docs/postgres/functions-string.html
That looks fairly reasonable to me. So the problem appears to be in the
CSS stylesheets.
--
Peter Eisentraut [email protected]
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-20 00:10 Peter Eisentraut <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 0 replies; 24+ messages in thread
From: Peter Eisentraut @ 2003-11-20 00:10 UTC (permalink / raw)
To: Josh Berkus <[email protected]>; +Cc: elein <[email protected]>; pgsql-docs; [email protected]
Peter Eisentraut writes:
> > Elein is correct, our variety of styles does look odd and can cause issues
> > with readability. See, for example,
> > http://www.postgresql.org/docs/current/static/functions-string.html
> Compare with the "original" version:
>
> http://developer.postgresql.org/docs/postgres/functions-string.html
>
> That looks fairly reasonable to me. So the problem appears to be in the
> CSS stylesheets.
This page puts the discrepancies in words:
http://www.postgresql.org/docs/current/static/notation.html
--
Peter Eisentraut [email protected]
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-20 02:58 Michael Glaesemann <[email protected]>
parent: Josh Berkus <[email protected]>
2 siblings, 1 reply; 24+ messages in thread
From: Michael Glaesemann @ 2003-11-20 02:58 UTC (permalink / raw)
To: [email protected]; +Cc: elein <[email protected]>; pgsql-docs
On Thursday, November 20, 2003, at 05:10 AM, Josh Berkus wrote:
> Can we experiment with different SGML-to-HMTL font styles to find one
> that's a
> little easier on the eyes? What I find particularly difficult are the
> function parameter columns; the mix of "normal" italics with "bold"
> italics.
>
> Comments? Responses?
As Peter has pointed out, the CSS can handle a lot of it. It doesn't
have to be hardcoded into the SGML-to-HTML transformation. One option
would be to use colors as well (I'm not talking a rainbow of fruit
flavors here :). In particular, I find italics often difficult to read
on the web. I'll try to get a few styles worked up by tomorrow that
could just be added to the css file—we can change the actual structure
of the HTML later.
Michael
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-20 03:56 Bruce Momjian <[email protected]>
parent: Michael Glaesemann <[email protected]>
0 siblings, 1 reply; 24+ messages in thread
From: Bruce Momjian @ 2003-11-20 03:56 UTC (permalink / raw)
To: Michael Glaesemann <[email protected]>; +Cc: [email protected]; elein <[email protected]>; pgsql-docs
Michael Glaesemann wrote:
>
> On Thursday, November 20, 2003, at 05:10 AM, Josh Berkus wrote:
> > Can we experiment with different SGML-to-HMTL font styles to find one
> > that's a
> > little easier on the eyes? What I find particularly difficult are the
> > function parameter columns; the mix of "normal" italics with "bold"
> > italics.
> >
> > Comments? Responses?
>
> As Peter has pointed out, the CSS can handle a lot of it. It doesn't
> have to be hardcoded into the SGML-to-HTML transformation. One option
> would be to use colors as well (I'm not talking a rainbow of fruit
> flavors here :). In particular, I find italics often difficult to read
> on the web. I'll try to get a few styles worked up by tomorrow that
I think it is the monospace italics that really look bad.
--
Bruce Momjian | http://candle.pha.pa.us
[email protected] | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 05:11 Michael Glaesemann <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 2 replies; 24+ messages in thread
From: Michael Glaesemann @ 2003-11-20 05:11 UTC (permalink / raw)
To: [email protected]; pgsql-docs
On Thursday, November 20, 2003, at 12:56 PM, Bruce Momjian wrote:
> Michael Glaesemann wrote:
>>
>> On Thursday, November 20, 2003, at 05:10 AM, Josh Berkus wrote:
>>> Can we experiment with different SGML-to-HMTL font styles to find one
>>> that's a
>>> little easier on the eyes? What I find particularly difficult are
>>> the
>>> function parameter columns; the mix of "normal" italics with "bold"
>>> italics.
>>>
>>> Comments? Responses?
>>
>> As Peter has pointed out, the CSS can handle a lot of it. It doesn't
>> have to be hardcoded into the SGML-to-HTML transformation. One option
>> would be to use colors as well (I'm not talking a rainbow of fruit
>> flavors here :). In particular, I find italics often difficult to read
>> on the web. I'll try to get a few styles worked up by tomorrow that
>
> I think it is the monospace italics that really look bad.
I'd have to agree with you. Making them a color other than the text
(black) or the links (blue/purple depending on your eyes) would set
them off quite well. Serif fonts at small sizes can also be pretty
nasty, though this isn't an issue with the PostgreSQL docs.
Michael
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 16:36 Bruce Momjian <[email protected]>
parent: Michael Glaesemann <[email protected]>
1 sibling, 2 replies; 24+ messages in thread
From: Bruce Momjian @ 2003-11-20 16:36 UTC (permalink / raw)
To: Michael Glaesemann <[email protected]>; +Cc: [email protected]; pgsql-docs
Michael Glaesemann wrote:
> >> As Peter has pointed out, the CSS can handle a lot of it. It doesn't
> >> have to be hardcoded into the SGML-to-HTML transformation. One option
> >> would be to use colors as well (I'm not talking a rainbow of fruit
> >> flavors here :). In particular, I find italics often difficult to read
> >> on the web. I'll try to get a few styles worked up by tomorrow that
> >
> > I think it is the monospace italics that really look bad.
>
> I'd have to agree with you. Making them a color other than the text
> (black) or the links (blue/purple depending on your eyes) would set
> them off quite well. Serif fonts at small sizes can also be pretty
> nasty, though this isn't an issue with the PostgreSQL docs.
If we go with color, making them printable on a non-color printer
becomes a problem.
--
Bruce Momjian | http://candle.pha.pa.us
[email protected] | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 16:51 Michael Glaesemann <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 2 replies; 24+ messages in thread
From: Michael Glaesemann @ 2003-11-20 16:51 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: [email protected]; pgsql-docs
On Friday, November 21, 2003, at 01:36 AM, Bruce Momjian wrote:
> Michael Glaesemann wrote:
>>>> As Peter has pointed out, the CSS can handle a lot of it. It doesn't
>>>> have to be hardcoded into the SGML-to-HTML transformation. One
>>>> option
>>>> would be to use colors as well (I'm not talking a rainbow of fruit
>>>> flavors here :). In particular, I find italics often difficult to
>>>> read
>>>> on the web. I'll try to get a few styles worked up by tomorrow that
>>>
>>> I think it is the monospace italics that really look bad.
>>
>> I'd have to agree with you. Making them a color other than the text
>> (black) or the links (blue/purple depending on your eyes) would set
>> them off quite well. Serif fonts at small sizes can also be pretty
>> nasty, though this isn't an issue with the PostgreSQL docs.
>
> If we go with color, making them printable on a non-color printer
> becomes a problem.
Good point. A way to handle this is to use an additional style sheet
for media="print" that distinguishes between the
keywords/parameters/functions in a different way. If we make any
changes to how syntax is represented, the conventions page will need to
be rewritten, and an option would be to rewrite it in a way that does
not explicitly spell out the differences (e.g., "italics ( example )
indicate placeholders; "), but rather present a table or an example
showing the different parts. This way the style sheets will always be
in congruence with the notation explanation.
Just an idea. I think it's good to have some redundancy in
distinguishing these things. Not only for those without color printers
(poor souls ;) but also for people who have trouble distinguishing
color differences.
When I was experimenting with different color schemes, I thought about
perhaps matching the syntax coloring of my editor, BBEdit. However, I'm
sure not all editors use the same color scheme (the ANSI SQL language
module for BBEdit displays only blue (keywords), pink (strings), and
black (everything else). The blue would conflict with the current link
color, and I'd rather not use pink unless everyone else thinks it's a
good idea.) I'm interested in hearing what editors others use for
coding, and what syntax coloring schemes they use for SQL.
Michael
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 17:16 Bruce Momjian <[email protected]>
parent: Michael Glaesemann <[email protected]>
1 sibling, 1 reply; 24+ messages in thread
From: Bruce Momjian @ 2003-11-20 17:16 UTC (permalink / raw)
To: Michael Glaesemann <[email protected]>; +Cc: [email protected]; pgsql-docs
Michael Glaesemann wrote:
> When I was experimenting with different color schemes, I thought about
> perhaps matching the syntax coloring of my editor, BBEdit. However, I'm
> sure not all editors use the same color scheme (the ANSI SQL language
> module for BBEdit displays only blue (keywords), pink (strings), and
> black (everything else). The blue would conflict with the current link
> color, and I'd rather not use pink unless everyone else thinks it's a
> good idea.) I'm interested in hearing what editors others use for
> coding, and what syntax coloring schemes they use for SQL.
Yes, colorizing editors really help me understand the code. I use
Crisp, which is a commercial editor.
--
Bruce Momjian | http://candle.pha.pa.us
[email protected] | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 17:31 Roberto Mello <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 2 replies; 24+ messages in thread
From: Roberto Mello @ 2003-11-20 17:31 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Michael Glaesemann <[email protected]>; [email protected]; pgsql-docs
On Thu, Nov 20, 2003 at 12:16:58PM -0500, Bruce Momjian wrote:
> Michael Glaesemann wrote:
> > When I was experimenting with different color schemes, I thought about
> > perhaps matching the syntax coloring of my editor, BBEdit. However, I'm
> > sure not all editors use the same color scheme (the ANSI SQL language
> > module for BBEdit displays only blue (keywords), pink (strings), and
> > black (everything else). The blue would conflict with the current link
> > color, and I'd rather not use pink unless everyone else thinks it's a
> > good idea.) I'm interested in hearing what editors others use for
> > coding, and what syntax coloring schemes they use for SQL.
I use vim, it has good SQL coloring syntax. The one problem that I'd like
to fix in it is that the body of PL/pgSQL functions are shown as a big
string.
-Roberto
--
+----| Roberto Mello - http://www.brasileiro.net/ |------+
+ Computer Science Graduate Student, Utah State University +
+ USU Free Software & GNU/Linux Club - http://fslc.usu.edu/ +
YES!! eh, NO!!! oh, well MAYBE!!!!!!!!
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 17:43 Michael Glaesemann <[email protected]>
parent: Roberto Mello <[email protected]>
1 sibling, 0 replies; 24+ messages in thread
From: Michael Glaesemann @ 2003-11-20 17:43 UTC (permalink / raw)
To: Roberto Mello <[email protected]>; +Cc: Bruce Momjian <[email protected]>; [email protected]; pgsql-docs
On Friday, November 21, 2003, at 02:31 AM, Roberto Mello wrote:
> On Thu, Nov 20, 2003 at 12:16:58PM -0500, Bruce Momjian wrote:
>> Michael Glaesemann wrote:
>>> When I was experimenting with different color schemes, I thought
>>> about
>>> perhaps matching the syntax coloring of my editor, BBEdit. However,
>>> I'm
>>> sure not all editors use the same color scheme (the ANSI SQL language
>>> module for BBEdit displays only blue (keywords), pink (strings), and
>>> black (everything else). The blue would conflict with the current
>>> link
>>> color, and I'd rather not use pink unless everyone else thinks it's a
>>> good idea.) I'm interested in hearing what editors others use for
>>> coding, and what syntax coloring schemes they use for SQL.
>
> I use vim, it has good SQL coloring syntax. The one problem that I'd
> like
> to fix in it is that the body of PL/pgSQL functions are shown as a big
> string.
I know what you mean. Same thing in BBEdit. Really, that's what they
are, but it'd be nice if there were some way of distinguishing the
parts of the strings. One of the issues is that (at least for BBEdit)
the SQL syntax coloring is based on ANSI SQL, not PostgreSQL. I'd like
to hack my own language module for this, but haven't got around to
doing it.
On Friday, November 21, 2003, at 02:16 AM, Bruce Momjian wrote:
> Yes, colorizing editors really help me understand the code. I use
> Crisp, which is a commercial editor.
Visiting the CRiSP site, I see they have a Mac version for demo. I'll
give it a whirl, and see what their colors are like.
Michael
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 17:48 Tom Lane <[email protected]>
parent: Michael Glaesemann <[email protected]>
1 sibling, 0 replies; 24+ messages in thread
From: Tom Lane @ 2003-11-20 17:48 UTC (permalink / raw)
To: Michael Glaesemann <[email protected]>; +Cc: Bruce Momjian <[email protected]>; [email protected]; pgsql-docs
Michael Glaesemann <[email protected]> writes:
> Just an idea. I think it's good to have some redundancy in
> distinguishing these things. Not only for those without color printers
> (poor souls ;) but also for people who have trouble distinguishing
> color differences.
Yes. I don't have an objection to using color, but it has to be in
addition to a font difference, not a substitute for a font difference.
regards, tom lane
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 17:49 Josh Berkus <[email protected]>
parent: Roberto Mello <[email protected]>
1 sibling, 1 reply; 24+ messages in thread
From: Josh Berkus @ 2003-11-20 17:49 UTC (permalink / raw)
To: Roberto Mello <[email protected]>; Bruce Momjian <[email protected]>; +Cc: Michael Glaesemann <[email protected]>; [email protected]; pgsql-docs
Guys,
> > > color, and I'd rather not use pink unless everyone else thinks it's a
> > > good idea.)
Nooooo! pink on white == totally illegible
> I use vim, it has good SQL coloring syntax. The one problem that I'd like
> to fix in it is that the body of PL/pgSQL functions are shown as a big
> string.
Yeah. In Kate (with the PostgreSQL plug-in) I frequently wait until I'm done
writing the procedure to quote it. What we could really use is a postgresql
function editor with syntax highlighting, perhaps as a bonus to pgAdmin or
pgAccess.
--
Josh Berkus
Aglio Database Solutions
San Francisco
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 17:59 Michael Glaesemann <[email protected]>
parent: Josh Berkus <[email protected]>
0 siblings, 0 replies; 24+ messages in thread
From: Michael Glaesemann @ 2003-11-20 17:59 UTC (permalink / raw)
To: Josh Berkus <[email protected]>; +Cc: Roberto Mello <[email protected]>; Bruce Momjian <[email protected]>; [email protected]; pgsql-docs
On Friday, November 21, 2003, at 02:49 AM, Josh Berkus wrote:
> Guys,
>
>>>> color, and I'd rather not use pink unless everyone else thinks it's
>>>> a
>>>> good idea.)
Yes, Josh, I *am* your father.
> Nooooo!
(Sorry ;)
> pink on white == totally illegible
Tell me about it! (Guess I could just make a little trip to preferences
to change it...)
> Yeah. In Kate (with the PostgreSQL plug-in) I frequently wait until
> I'm done
> writing the procedure to quote it.
Nice to hear there are PostgreSQL-specific plug-ins out there. I assume
it picks up the additional PostgreSQL keywords?
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 19:14 Guillaume LELARGE <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 1 reply; 24+ messages in thread
From: Guillaume LELARGE @ 2003-11-20 19:14 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; Michael Glaesemann <[email protected]>; +Cc: [email protected]; pgsql-docs
Le Jeudi 20 Novembre 2003 16:36, Bruce Momjian a écrit :
> Michael Glaesemann wrote:
> > >> As Peter has pointed out, the CSS can handle a lot of it. It doesn't
> > >> have to be hardcoded into the SGML-to-HTML transformation. One option
> > >> would be to use colors as well (I'm not talking a rainbow of fruit
> > >> flavors here :). In particular, I find italics often difficult to read
> > >> on the web. I'll try to get a few styles worked up by tomorrow that
> > >
> > > I think it is the monospace italics that really look bad.
> >
> > I'd have to agree with you. Making them a color other than the text
> > (black) or the links (blue/purple depending on your eyes) would set
> > them off quite well. Serif fonts at small sizes can also be pretty
> > nasty, though this isn't an issue with the PostgreSQL docs.
>
> If we go with color, making them printable on a non-color printer
> becomes a problem.
This is not totaly true.
You can have alternate stylesheets depending on the media : on colorized for
screen, one black and white for printer. Latest releases of current browers
(mozilla, ie6) are able to handle these tags :
<link rel="stylesheet" type="text/css" href="2columnspg.css" media="screen"
title="TwoColumn">
<link rel="stylesheet" type="text/css" href="printpg.css" media="print">
Adding a title make them available for stylesheet switching in the browser
(mozilla).
--
Guillaume
<!-- http://absfr.tuxfamily.org/
http://pgsql-fr.tuxfamily.org/ -->.
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-20 21:55 elein <[email protected]>
parent: Guillaume LELARGE <[email protected]>
0 siblings, 0 replies; 24+ messages in thread
From: elein @ 2003-11-20 21:55 UTC (permalink / raw)
To: Guillaume LELARGE <[email protected]>; +Cc: Bruce Momjian <[email protected]>; Michael Glaesemann <[email protected]>; [email protected]; pgsql-docs
It is *much* more important to have legible black and
white text than it is to introduce colors.
Don't run off track with the colors--it would be a bonus
extra. Also, wrt colors, it is important to choose
colors in a way that handle color blindness. I had
a great URL on this that I can't find right now,
but the topic is google-able.
Also, especially since not everyone sees the same
colors, you will *never* agree on syntax colors.
(That is why I inevitably edit my vim syntax files.)
--elein
On Thu, Nov 20, 2003 at 07:14:53PM +0000, Guillaume LELARGE wrote:
> Le Jeudi 20 Novembre 2003 16:36, Bruce Momjian a écrit :
> > Michael Glaesemann wrote:
> > > >> As Peter has pointed out, the CSS can handle a lot of it. It doesn't
> > > >> have to be hardcoded into the SGML-to-HTML transformation. One option
> > > >> would be to use colors as well (I'm not talking a rainbow of fruit
> > > >> flavors here :). In particular, I find italics often difficult to read
> > > >> on the web. I'll try to get a few styles worked up by tomorrow that
> > > >
> > > > I think it is the monospace italics that really look bad.
> > >
> > > I'd have to agree with you. Making them a color other than the text
> > > (black) or the links (blue/purple depending on your eyes) would set
> > > them off quite well. Serif fonts at small sizes can also be pretty
> > > nasty, though this isn't an issue with the PostgreSQL docs.
> >
> > If we go with color, making them printable on a non-color printer
> > becomes a problem.
> This is not totaly true.
>
> You can have alternate stylesheets depending on the media : on colorized for
> screen, one black and white for printer. Latest releases of current browers
> (mozilla, ie6) are able to handle these tags :
> <link rel="stylesheet" type="text/css" href="2columnspg.css" media="screen"
> title="TwoColumn">
> <link rel="stylesheet" type="text/css" href="printpg.css" media="print">
>
> Adding a title make them available for stylesheet switching in the browser
> (mozilla).
>
>
> --
> Guillaume
> <!-- http://absfr.tuxfamily.org/
> http://pgsql-fr.tuxfamily.org/ -->.
>
>
> ---------------------------(end of broadcast)---------------------------
> TIP 9: the planner will ignore your desire to choose an index scan if your
> joining column's datatypes do not match
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-21 12:10 Dave Page <[email protected]>
0 siblings, 0 replies; 24+ messages in thread
From: Dave Page @ 2003-11-21 12:10 UTC (permalink / raw)
To: Josh Berkus <[email protected]>; Roberto Mello <[email protected]>; Bruce Momjian <[email protected]>; +Cc: Michael Glaesemann <[email protected]>; [email protected]; pgsql-docs
> -----Original Message-----
> From: Josh Berkus [mailto:[email protected]]
> Sent: 20 November 2003 17:49
> To: Roberto Mello; Bruce Momjian
> Cc: Michael Glaesemann; [email protected];
> [email protected]
> Subject: Re: [pgsql-www] [DOCS] 7.4 official docs : Fonts?
>
> Yeah. In Kate (with the PostgreSQL plug-in) I frequently
> wait until I'm done
> writing the procedure to quote it. What we could really use
> is a postgresql
> function editor with syntax highlighting, perhaps as a bonus
> to pgAdmin or pgAccess.
We have the basics in place in pgAdmin (it handles SQL quite happily).
Just need a suitable lexer for pl/pgsql for use with the Scintilla
Styled Text Control that we use.
Regards, Dave.
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-28 08:33 Henry B. Hotz <[email protected]>
parent: Michael Glaesemann <[email protected]>
1 sibling, 1 reply; 24+ messages in thread
From: Henry B. Hotz @ 2003-11-28 08:33 UTC (permalink / raw)
To: Michael Glaesemann <[email protected]>; [email protected]; pgsql-docs
At 2:11 PM +0900 11/20/03, Michael Glaesemann wrote:
>On Thursday, November 20, 2003, at 12:56 PM, Bruce Momjian wrote:
>
>>Michael Glaesemann wrote:
>>>
>>>On Thursday, November 20, 2003, at 05:10 AM, Josh Berkus wrote:
>>>>Can we experiment with different SGML-to-HMTL font styles to find one
>>>>that's a
>>>>little easier on the eyes? What I find particularly difficult are the
>>>>function parameter columns; the mix of "normal" italics with "bold"
>>>>italics.
>>>>
>>>>Comments? Responses?
>>>
>>>As Peter has pointed out, the CSS can handle a lot of it. It doesn't
>>>have to be hardcoded into the SGML-to-HTML transformation. One option
>>>would be to use colors as well (I'm not talking a rainbow of fruit
>>>flavors here :). In particular, I find italics often difficult to read
>>>on the web. I'll try to get a few styles worked up by tomorrow that
>>
>>I think it is the monospace italics that really look bad.
>
>I'd have to agree with you. Making them a color other than the text
>(black) or the links (blue/purple depending on your eyes) would set
>them off quite well. Serif fonts at small sizes can also be pretty
>nasty, though this isn't an issue with the PostgreSQL docs.
Color works well on-screen with html. Small-point-size italics are
hard to read on-screen, agreed.
Italics work well on B&W printout with PDF. (In general. I'm not
looking at the specific example.)
Can you map things somehow to get the best of both worlds?
--
The opinions expressed in this message are mine,
not those of Caltech, JPL, NASA, or the US Government.
[email protected], or [email protected]
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-28 10:30 Michael Glaesemann <[email protected]>
parent: Henry B. Hotz <[email protected]>
0 siblings, 1 reply; 24+ messages in thread
From: Michael Glaesemann @ 2003-11-28 10:30 UTC (permalink / raw)
To: Henry B. Hotz <[email protected]>; +Cc: [email protected]; pgsql-docs
On Friday, November 28, 2003, at 05:33 PM, Henry B. Hotz wrote:
> Color works well on-screen with html. Small-point-size italics are
> hard to read on-screen, agreed.
>
> Italics work well on B&W printout with PDF. (In general. I'm not
> looking at the specific example.)
>
> Can you map things somehow to get the best of both worlds?
If you're talking about printing from the browser, you can have
separate style sheets with different media targets, so media="screen"
could have the color, while media="print" could have italics. It's
really flexible. At work I have a form letter that's generated on
screen, and includes all of the navigation for moving around the site.
When you print the page, the media="print" style sheet omits the
navigation, restyles the page with different fonts and sizes, and adds
the number we want to fax it to (Yes, I know. We still use fax for a
large part of our interoffice correspondence. I'm trying to move us
away from that, but it's a hard slog.)
As for the PDF docs, they're formatting is indeed different. I assume
that the SGML to PDF path is different from the SGML to HTML path
(which is of course one of the benefits of using SGML).
Is this what you mean?
Michael
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: [DOCS] 7.4 official docs : Fonts?
@ 2003-11-29 10:40 Henry B. Hotz <[email protected]>
parent: Michael Glaesemann <[email protected]>
0 siblings, 1 reply; 24+ messages in thread
From: Henry B. Hotz @ 2003-11-29 10:40 UTC (permalink / raw)
To: Michael Glaesemann <[email protected]>; +Cc: [email protected]; pgsql-docs
At 7:30 PM +0900 11/28/03, Michael Glaesemann wrote:
>On Friday, November 28, 2003, at 05:33 PM, Henry B. Hotz wrote:
>
>>Color works well on-screen with html. Small-point-size italics are
>>hard to read on-screen, agreed.
>>
>>Italics work well on B&W printout with PDF. (In general. I'm not
>>looking at the specific example.)
>>
>>Can you map things somehow to get the best of both worlds?
>
>If you're talking about printing from the browser, you can have
>separate style sheets with different media targets, so
>media="screen" could have the color, while media="print" could have
>italics. It's really flexible. At work I have a form letter that's
>generated on screen, and includes all of the navigation for moving
>around the site. When you print the page, the media="print" style
>sheet omits the navigation, restyles the page with different fonts
>and sizes, and adds the number we want to fax it to (Yes, I know. We
>still use fax for a large part of our interoffice correspondence.
>I'm trying to move us away from that, but it's a hard slog.)
>
>As for the PDF docs, they're formatting is indeed different. I
>assume that the SGML to PDF path is different from the SGML to HTML
>path (which is of course one of the benefits of using SGML).
>
>Is this what you mean?
Pretty much, yes. I don't care much about printing html. If I want
to print I figure I'm better off getting a PDF.
I just don't want to have to use a color printer.
--
The opinions expressed in this message are mine,
not those of Caltech, JPL, NASA, or the US Government.
[email protected], or [email protected]
^ permalink raw reply [nested|flat] 24+ messages in thread
* Re: 7.4 official docs : Fonts?
@ 2003-11-29 21:06 Randolf Richardson <[email protected]>
parent: Henry B. Hotz <[email protected]>
0 siblings, 0 replies; 24+ messages in thread
From: Randolf Richardson @ 2003-11-29 21:06 UTC (permalink / raw)
To: pgsql-docs
[sNip]
> Pretty much, yes. I don't care much about printing html. If I want
> to print I figure I'm better off getting a PDF.
I prefer to print from PDF also because the formatting is always
perfect. Unfortunately this just hasn't been the case with any other format,
including HTML, WordPerfect (and those horrid Microsoft Word) documents, and
even plain old text files.
At least with PDF this problem has been solved.
> I just don't want to have to use a color printer.
When I'm reading large amounts of text on paper, black text is my
preference because so many people just pick the wrong colours (and pretty
much everyone has different tastes and expectations in this regard).
--
Randolf Richardson - [email protected]
Vancouver, British Columbia, Canada
Please do not eMail me directly when responding
to my postings in the newsgroups.
^ permalink raw reply [nested|flat] 24+ messages in thread
end of thread, other threads:[~2003-11-29 21:06 UTC | newest]
Thread overview: 24+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2003-11-18 05:03 7.4 official docs : Fonts? elein <[email protected]>
2003-11-19 20:10 ` Josh Berkus <[email protected]>
2003-11-19 22:20 ` Robert Treat <[email protected]>
2003-11-19 22:38 ` Randolf Richardson, DevNet SysOp 29 <[email protected]>
2003-11-19 23:12 ` Peter Eisentraut <[email protected]>
2003-11-20 00:10 ` Peter Eisentraut <[email protected]>
2003-11-20 02:58 ` Michael Glaesemann <[email protected]>
2003-11-20 03:56 ` Bruce Momjian <[email protected]>
2003-11-20 05:11 ` Michael Glaesemann <[email protected]>
2003-11-20 16:36 ` Bruce Momjian <[email protected]>
2003-11-20 16:51 ` Michael Glaesemann <[email protected]>
2003-11-20 17:16 ` Bruce Momjian <[email protected]>
2003-11-20 17:31 ` Roberto Mello <[email protected]>
2003-11-20 17:43 ` Michael Glaesemann <[email protected]>
2003-11-20 17:49 ` Josh Berkus <[email protected]>
2003-11-20 17:59 ` Michael Glaesemann <[email protected]>
2003-11-20 17:48 ` Tom Lane <[email protected]>
2003-11-20 19:14 ` Guillaume LELARGE <[email protected]>
2003-11-20 21:55 ` elein <[email protected]>
2003-11-28 08:33 ` Henry B. Hotz <[email protected]>
2003-11-28 10:30 ` Michael Glaesemann <[email protected]>
2003-11-29 10:40 ` Henry B. Hotz <[email protected]>
2003-11-29 21:06 ` Randolf Richardson <[email protected]>
2003-11-21 12:10 Re: [DOCS] 7.4 official docs : Fonts? Dave Page <[email protected]>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox