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

Re: Documentation

From: Guillaume Lelarge <guillaume(at)lelarge(dot)info>
To: Magnus Hagander <magnus(at)hagander(dot)net>
Cc: Dave Page <dpage(at)pgadmin(dot)org>, pgadmin-hackers <pgadmin-hackers(at)postgresql(dot)org>
Subject: Re: Documentation
Date: 2010-09-27 16:26:52
Message-ID: 4CA0C5CC.9050608@lelarge.info (view raw or flat)
Thread:
Lists: pgadmin-hackers
Le 27/09/2010 10:06, Magnus Hagander a écrit :
> 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!
> 

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.

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


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

In response to

Responses

pgadmin-hackers by date

Next:From: Guillaume LelargeDate: 2010-09-27 16:28:35
Subject: Re: Documentation
Previous:From: Guillaume LelargeDate: 2010-09-27 16:24:07
Subject: Re: Documentation

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