Re: Documentation

Le 27/09/2010 10:17, Thom Brown a écrit :
> 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.
>

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