Thread: Re: [DOCS] 7.4 official docs : Fonts?
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
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 pgman@candle.pha.pa.us | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup. | Newtown Square, Pennsylvania 19073
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
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 pgman@candle.pha.pa.us | (610) 359-1001 + If your life is a hard drive, | 13 Roberts Road + Christ can be your backup. | Newtown Square, Pennsylvania 19073
Michael Glaesemann <grzm@myrealbox.com> 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
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
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?
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
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/ -->.
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!!!!!!!!
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. Henry.B.Hotz@jpl.nasa.gov, or hbhotz@oxy.edu