Обсуждение: Odd formatting in on-line docs

Поиск
Список
Период
Сортировка

Odd formatting in on-line docs

От
Tom Lane
Дата:
The online copies of the documentation misformat <programlisting>
constructs, indenting lines after the first.  For example at

http://www.postgresql.org/docs/7.4/static/sql-syntax.html#SQL-SYNTAX-LEXICAL

the three example SQL statements should all be indented the same.  Older
versions look the same, as do the "interactive" versions.  But the
developer version of the docs is fine:

http://developer.postgresql.org/docs/postgres/sql-syntax.html#SQL-SYNTAX-LEXICAL

I think this must be some weird interaction between the docs themselves
and the HTML wrapper that's put around them to make the online pages.
Can anyone diagnose this and fix it?

            regards, tom lane

Re: Odd formatting in on-line docs

От
"Dave Page"
Дата:

> -----Original Message-----
> From: Tom Lane [mailto:tgl@sss.pgh.pa.us]
> Sent: 17 April 2004 17:56
> To: pgsql-www@postgresql.org; pgsql-docs@postgresql.org
> Subject: [pgsql-www] Odd formatting in on-line docs
>
> I think this must be some weird interaction between the docs
> themselves and the HTML wrapper that's put around them to
> make the online pages.
> Can anyone diagnose this and fix it?

Yup, think I got it. The kludge of a program that loads the docs into
the database was adding a space at the beginning of the second and
subsequent lines inside <pre> tags. It's fixed for the 7.4 docs - at
some point I will reload the rest of them but I'm a little pushed for
time right now.

Regards, Dave

Re: Odd formatting in on-line docs

От
Bruce Momjian
Дата:
Tom Lane wrote:
> The online copies of the documentation misformat <programlisting>
> constructs, indenting lines after the first.  For example at
>
> http://www.postgresql.org/docs/7.4/static/sql-syntax.html#SQL-SYNTAX-LEXICAL
>
> the three example SQL statements should all be indented the same.  Older
> versions look the same, as do the "interactive" versions.  But the
> developer version of the docs is fine:
>
> http://developer.postgresql.org/docs/postgres/sql-syntax.html#SQL-SYNTAX-LEXICAL
>
> I think this must be some weird interaction between the docs themselves
> and the HTML wrapper that's put around them to make the online pages.
> Can anyone diagnose this and fix it?

Someone must have fixed it:

SELECT * FROM MY_TABLE;
UPDATE MY_TABLE SET A = 5;
INSERT INTO MY_TABLE VALUES (3, 'hi there');

It isn't indented like the developer docs, but it isn't misaligned.

--
  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

Re: Odd formatting in on-line docs

От
"Dave Page"
Дата:

> -----Original Message-----
> From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
> Sent: 20 April 2004 02:04
> To: Tom Lane
> Cc: pgsql-www@postgresql.org; pgsql-docs@postgresql.org
> Subject: Re: [pgsql-www] Odd formatting in on-line docs
>
> Someone must have fixed it:
>
> SELECT * FROM MY_TABLE;
> UPDATE MY_TABLE SET A = 5;
> INSERT INTO MY_TABLE VALUES (3, 'hi there');
>
> It isn't indented like the developer docs, but it isn't misaligned.

I did, and I responded to the lists. I'm seeing some duplicate messages
and long posting delays at the moment - is there a problem Marc?

Regards, Dave.

Re: Odd formatting in on-line docs

От
"Marc G. Fournier"
Дата:
On Tue, 20 Apr 2004, Dave Page wrote:

>
>
> > -----Original Message-----
> > From: Bruce Momjian [mailto:pgman@candle.pha.pa.us]
> > Sent: 20 April 2004 02:04
> > To: Tom Lane
> > Cc: pgsql-www@postgresql.org; pgsql-docs@postgresql.org
> > Subject: Re: [pgsql-www] Odd formatting in on-line docs
> >
> > Someone must have fixed it:
> >
> > SELECT * FROM MY_TABLE;
> > UPDATE MY_TABLE SET A = 5;
> > INSERT INTO MY_TABLE VALUES (3, 'hi there');
> >
> > It isn't indented like the developer docs, but it isn't misaligned.
>
> I did, and I responded to the lists. I'm seeing some duplicate messages
> and long posting delays at the moment - is there a problem Marc?

any delays are most likely in that it, for some reason, is having to be
approved by myself ...

----
Marc G. Fournier           Hub.Org Networking Services (http://www.hub.org)
Email: scrappy@hub.org           Yahoo!: yscrappy              ICQ: 7615664