Re: Documentation

On Mon, Sep 27, 2010 at 18:26, Guillaume Lelarge <guillaume@lelarge.info> wrote:
> Le 27/09/2010 10:06, Magnus Hagander a écrit :
>> 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!
>>
>
> Thanks.
>
>>> 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?
>> 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)
>>
>
> Well, actually, I think we should have a customized theme, so that the
> docs look like our website.

+1.


>>> Otherwise it looks great. Couple of questions:
>>>
>>> - Have you thought about how we might shoe-horn this into the build process?
>>
>> One direct question here - is it going to be a PITA on Windows? I've
>> never tried it there, it might be?
>>
>
> Shouldn't be. I didn't ask for it, but you can have a .bat file to build
> the documentation. Of course, next question is: "is it going to be a
> PITA to install python and its plugins on Windows?" I don't have an
> answer on this one.

Well, that's really what was my question :-)

--
 Magnus Hagander
 Me: http://www.hagander.net/
 Work: http://www.redpill-linpro.com/