Skip site navigation (1) Skip section navigation (2)

Re: Documentation

From: Guillaume Lelarge <guillaume(at)lelarge(dot)info>
To: Thom Brown <thom(at)linux(dot)com>
Cc: Magnus Hagander <magnus(at)hagander(dot)net>, Dave Page <dpage(at)pgadmin(dot)org>, pgadmin-hackers <pgadmin-hackers(at)postgresql(dot)org>
Subject: Re: Documentation
Date: 2010-09-27 16:28:35
Message-ID: 4CA0C633.2020000@lelarge.info (view raw or flat)
Thread:
Lists: pgadmin-hackers
Le 27/09/2010 10:17, Thom Brown a écrit :
> On 27 September 2010 09:06, Magnus Hagander <magnus(at)hagander(dot)net> wrote:
>> On Mon, Sep 27, 2010 at 10:00, Dave Page <dpage(at)pgadmin(dot)org> wrote:
>>> On Sun, Sep 26, 2010 at 9:50 PM, Guillaume Lelarge
>>> <guillaume(at)lelarge(dot)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.
> 

It could have an effect with other tags. I didn't use every tag that
sphinx allows.

> But great work Guillaume :)  Very slick.

Thanks :)

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

The screenshots should be updated on the current website too.


-- 
Guillaume
 http://www.postgresql.fr
 http://dalibo.com

In response to

pgadmin-hackers by date

Next:From: Guillaume LelargeDate: 2010-09-27 16:29:16
Subject: Re: Documentation
Previous:From: Guillaume LelargeDate: 2010-09-27 16:26:52
Subject: Re: Documentation

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group