Re: Proposal: syntax highlight in html manual - Mailing list pgsql-docs

From Kevin Grittner
Subject Re: Proposal: syntax highlight in html manual
Date
Msg-id 4DA585A9020000250003C794@gw.wicourts.gov
Whole thread Raw
In response to Proposal: syntax highlight in html manual  (Daniele Varrazzo <daniele.varrazzo@gmail.com>)
Responses Re: Proposal: syntax highlight in html manual  (Thom Brown <thom@linux.com>)
List pgsql-docs
Daniele Varrazzo <daniele.varrazzo@gmail.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

pgsql-docs by date:

Previous
From: Susanne Ebrecht
Date:
Subject: Re: Proposal: syntax highlight in html manual
Next
From: Thom Brown
Date:
Subject: Re: Proposal: syntax highlight in html manual