Re: Proposal: syntax highlight in html manual

From: "Kevin Grittner" <Kevin(dot)Grittner(at)wicourts(dot)gov>
To: "Daniele Varrazzo" <daniele(dot)varrazzo(at)gmail(dot)com>, <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Proposal: syntax highlight in html manual
Date: 2011-04-13 16:14:49
Message-ID: 4DA585A9020000250003C794@gw.wicourts.gov
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Daniele Varrazzo <daniele(dot)varrazzo(at)gmail(dot)com> wrote:

> - http://pgmp.projects.postgresql.org/highlight/psql.html
> - http://pgmp.projects.postgresql.org/highlight/postgres.html
>
> Is there any interest in applying highlighted syntax to the html
> rendering of the manual?

When using an editor I like some color highlighting, as long as I
can control the colors. Documentation is very different, especially
since the user probably wouldn't have any control over the colors.
The examples in the links above are very hard for me to read, and
definitely *not* something I would want in the documentation.

There might be room to do something limited and subtle, like maybe
making comments a dark gray while other text is black or possibly
making computer-generated output very dark blue versus black for
user input. It should be subtle enough not to draw attention to it,
but rather to give subtle cues. If the display screams "HEY! LOOK
HERE!" about anything, it's just wrong.

Overall, I'm dubious about whether it would be worth the effort,
even if you can come up with a scheme which people like.

-Kevin

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Thom Brown 2011-04-13 16:21:49 Re: Proposal: syntax highlight in html manual
Previous Message Susanne Ebrecht 2011-04-13 15:48:52 Re: Proposal: syntax highlight in html manual