Re: Documentation - Mailing list pgadmin-hackers

From Thom Brown
Subject Re: Documentation
Date
Msg-id AANLkTimHWmDuPebBpwDppfEyqwKBuK5iEwwqZJu1EnY7@mail.gmail.com
Whole thread Raw
In response to Re: Documentation  (Magnus Hagander <magnus@hagander.net>)
Responses Re: Documentation
List pgadmin-hackers
On 27 September 2010 09:06, Magnus Hagander <magnus@hagander.net> wrote:
> On Mon, Sep 27, 2010 at 10:00, Dave Page <dpage@pgadmin.org> wrote:
>> On Sun, Sep 26, 2010 at 9:50 PM, Guillaume Lelarge
>> <guillaume@lelarge.info> wrote:
>>>
>>> See
>>> http://developer.pgadmin.org/~guillaume/pgadmin_docs/_build/html/index.html.
>>>
>>> It took me three hours to manually convert the current documentation.
>>> There is also a possibility to change the theme. I'll try to do it on my
>>> laptop.
>>
>> Wow, that was quick (and unexpected!). There's some weirdness here,
>
> Indeed. Nice job!
>
>
>> but maybe that's just a markup issue:
>>
>> http://developer.pgadmin.org/~guillaume/pgadmin_docs/_build/html/connect.html#connect
>
> I notice some weirdness on
> http://developer.pgadmin.org/~guillaume/pgadmin_docs/_build/html/pgagent-install.html
> as well:
>
> 1) I get scrollbars on all the "highlighted areas", that scrolls
> exactly 1 pixel. Probably a CSS issue?

If you remove the ability to scroll the overflow, text on some pages,
or small screens, will flow outside the container.

> 2) If I do view source to figure out why, I notice they have class
> "highlight-python" - is there something that should be set to make it
> not call it python? (I haven't investigated what it actually means
> yet, no :P)

The highlight-python class has no bearing on style as nothing refers
to that class in any CSS file.  You can safely rename it, but it will
have no visual effect.

But great work Guillaume :)  Very slick.  And I see you've also
updated the screenshots too, so it includes the mystery history box!
:D  (although no textual references to it ATM)

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935

pgadmin-hackers by date:

Previous
From: Thom Brown
Date:
Subject: Re: Documentation
Next
From: Dave Page
Date:
Subject: Re: Documentation