Обсуждение: Building the French docs

Поиск
Список
Период
Сортировка

Building the French docs

От
Dave Page
Дата:
Hi Guillaume,

I'm not sure if this is still WIP, but I was looking at the French
docs today and realised they're not quite complete yet:

- We need a set of HTML Help project files

- docs/builddocs.bat needs to be updated to build fr_FR/pgadmin3.hhp

- docs/Docs.vcproj needs to be updated to include the fr_FR output
files as Outputs of the build step.

- The documentation helpfile and shortcut need to be added to
pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
present that - should we have shortcuts like "pgAdmin Documentation
(English)", "pgAdmin Documentation (French)" and so on?

If you're still working on this, please ignore me :-)

--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le mardi 31 mars 2009 à 18:13:42, Dave Page a écrit :
> [... lots of stuff I need to work on ...]
> If you're still working on this, please ignore me :-)

No, I wasn't working on it. I didn't even imagine I would have to. I'll try to
do that next saturday.


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le mardi 31 mars 2009 à 18:13:42, Dave Page a écrit :
> [...]
> I'm not sure if this is still WIP, but I was looking at the French
> docs today and realised they're not quite complete yet:
>
> - We need a set of HTML Help project files
>

Added.

> - docs/builddocs.bat needs to be updated to build fr_FR/pgadmin3.hhp
>

Done.

> - docs/Docs.vcproj needs to be updated to include the fr_FR output
> files as Outputs of the build step.
>

Done.

> - The documentation helpfile and shortcut need to be added to
> pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
> present that - should we have shortcuts like "pgAdmin Documentation
> (English)", "pgAdmin Documentation (French)" and so on?
>

Isn't the wxs file the one to do the installer? I thought we didn't want to
add manual's translation in the installer because the file will grow too much.
Am I wrong?


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Re: Building the French docs

От
Dave Page
Дата:
On Sat, Apr 4, 2009 at 6:50 PM, Guillaume Lelarge
<guillaume@lelarge.info> wrote:
>
> Isn't the wxs file the one to do the installer? I thought we didn't want to
> add manual's translation in the installer because the file will grow too much.
> Am I wrong?

iirc, we originally said that when the docs included the PostgreSQL
and Slony docs too. How big are the docs now? I suspect the difference
is not worth worrying about.



--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le dimanche 05 avril 2009 à 20:34:11, Dave Page a écrit :
> On Sat, Apr 4, 2009 at 6:50 PM, Guillaume Lelarge
>
> <guillaume@lelarge.info> wrote:
> > Isn't the wxs file the one to do the installer? I thought we didn't want
> > to add manual's translation in the installer because the file will grow
> > too much. Am I wrong?
>
> iirc, we originally said that when the docs included the PostgreSQL
> and Slony docs too. How big are the docs now? I suspect the difference
> is not worth worrying about.

4.1MB with the images, 800KB without.


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Re: Building the French docs

От
Dave Page
Дата:
On Sun, Apr 5, 2009 at 8:34 PM, Guillaume Lelarge
<guillaume@lelarge.info> wrote:
> Le dimanche 05 avril 2009 à 20:34:11, Dave Page a écrit :
>> On Sat, Apr 4, 2009 at 6:50 PM, Guillaume Lelarge
>>
>> <guillaume@lelarge.info> wrote:
>> > Isn't the wxs file the one to do the installer? I thought we didn't want
>> > to add manual's translation in the installer because the file will grow
>> > too much. Am I wrong?
>>
>> iirc, we originally said that when the docs included the PostgreSQL
>> and Slony docs too. How big are the docs now? I suspect the difference
>> is not worth worrying about.
>
> 4.1MB with the images, 800KB without.

Hmm, I wonder if it's worth compressing the images a little more aggressively...

--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

Re: Building the French docs

От
Dave Page
Дата:
On Tue, Mar 31, 2009 at 5:13 PM, Dave Page <dpage@pgadmin.org> wrote:

> - The documentation helpfile and shortcut need to be added to
> pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
> present that - should we have shortcuts like "pgAdmin Documentation
> (English)", "pgAdmin Documentation (French)" and so on?

Did you make a decision on this?

--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le mardi 5 mai 2009 à 15:10:44, Dave Page a écrit :
> On Tue, Mar 31, 2009 at 5:13 PM, Dave Page <dpage@pgadmin.org> wrote:
> > - The documentation helpfile and shortcut need to be added to
> > pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
> > present that - should we have shortcuts like "pgAdmin Documentation
> > (English)", "pgAdmin Documentation (French)" and so on?
>
> Did you make a decision on this?

It's probably better that way (shortcut for each translation). I don't think
we'll have a huge number of translated documentation, and it's always better
to be able to grab the english one.


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Re: Building the French docs

От
Dave Page
Дата:
On Tue, May 5, 2009 at 2:21 PM, Guillaume Lelarge
<guillaume@lelarge.info> wrote:
> Le mardi 5 mai 2009 à 15:10:44, Dave Page a écrit :
>> On Tue, Mar 31, 2009 at 5:13 PM, Dave Page <dpage@pgadmin.org> wrote:
>> > - The documentation helpfile and shortcut need to be added to
>> > pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
>> > present that - should we have shortcuts like "pgAdmin Documentation
>> > (English)", "pgAdmin Documentation (French)" and so on?
>>
>> Did you make a decision on this?
>
> It's probably better that way (shortcut for each translation). I don't think
> we'll have a huge number of translated documentation, and it's always better
> to be able to grab the english one.

OK - you want to fixup the installer?


--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le mardi 5 mai 2009 à 15:27:13, Dave Page a écrit :
> On Tue, May 5, 2009 at 2:21 PM, Guillaume Lelarge
>
> <guillaume@lelarge.info> wrote:
> > Le mardi 5 mai 2009 à 15:10:44, Dave Page a écrit :
> >> On Tue, Mar 31, 2009 at 5:13 PM, Dave Page <dpage@pgadmin.org> wrote:
> >> > - The documentation helpfile and shortcut need to be added to
> >> > pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
> >> > present that - should we have shortcuts like "pgAdmin Documentation
> >> > (English)", "pgAdmin Documentation (French)" and so on?
> >>
> >> Did you make a decision on this?
> >
> > It's probably better that way (shortcut for each translation). I don't
> > think we'll have a huge number of translated documentation, and it's
> > always better to be able to grab the english one.
>
> OK - you want to fixup the installer?

I won't have the time to do it till tonight. If you can wait, I can work on
this tonight. But I suppose you're asking for beta 3?


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Re: Building the French docs

От
Dave Page
Дата:
On Tue, May 5, 2009 at 2:33 PM, Guillaume Lelarge
<guillaume@lelarge.info> wrote:
> Le mardi 5 mai 2009 à 15:27:13, Dave Page a écrit :
>> On Tue, May 5, 2009 at 2:21 PM, Guillaume Lelarge
>>
>> <guillaume@lelarge.info> wrote:
>> > Le mardi 5 mai 2009 à 15:10:44, Dave Page a écrit :
>> >> On Tue, Mar 31, 2009 at 5:13 PM, Dave Page <dpage@pgadmin.org> wrote:
>> >> > - The documentation helpfile and shortcut need to be added to
>> >> > pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
>> >> > present that - should we have shortcuts like "pgAdmin Documentation
>> >> > (English)", "pgAdmin Documentation (French)" and so on?
>> >>
>> >> Did you make a decision on this?
>> >
>> > It's probably better that way (shortcut for each translation). I don't
>> > think we'll have a huge number of translated documentation, and it's
>> > always better to be able to grab the english one.
>>
>> OK - you want to fixup the installer?
>
> I won't have the time to do it till tonight. If you can wait, I can work on
> this tonight. But I suppose you're asking for beta 3?

No, I'm already building that. This will be for b4/rc1.


--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le mardi 5 mai 2009 à 15:35:53, Dave Page a écrit :
> On Tue, May 5, 2009 at 2:33 PM, Guillaume Lelarge
>
> <guillaume@lelarge.info> wrote:
> > Le mardi 5 mai 2009 à 15:27:13, Dave Page a écrit :
> >> On Tue, May 5, 2009 at 2:21 PM, Guillaume Lelarge
> >>
> >> <guillaume@lelarge.info> wrote:
> >> > Le mardi 5 mai 2009 à 15:10:44, Dave Page a écrit :
> >> >> On Tue, Mar 31, 2009 at 5:13 PM, Dave Page <dpage@pgadmin.org> wrote:
> >> >> > - The documentation helpfile and shortcut need to be added to
> >> >> > pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
> >> >> > present that - should we have shortcuts like "pgAdmin Documentation
> >> >> > (English)", "pgAdmin Documentation (French)" and so on?
> >> >>
> >> >> Did you make a decision on this?
> >> >
> >> > It's probably better that way (shortcut for each translation). I don't
> >> > think we'll have a huge number of translated documentation, and it's
> >> > always better to be able to grab the english one.
> >>
> >> OK - you want to fixup the installer?
> >
> > I won't have the time to do it till tonight. If you can wait, I can work
> > on this tonight. But I suppose you're asking for beta 3?
>
> No, I'm already building that. This will be for b4/rc1.
>

Here is the patch. Can you check it? it's the first time I do it, and I'm not
sure I don't forget something.


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le mardi 5 mai 2009 à 19:49:03, Ashesh Vashi a écrit :
> Hi Guillaume,
>
> I think - you forget the attachment. :p
>

Thanks Ashesh, I indeed forgot it. Here it is.


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Вложения

Re: Building the French docs

От
Ashesh Vashi
Дата:
Hi Guillaume,

I think - you forget the attachment. :p

Guillaume Lelarge wrote:
Le mardi 5 mai 2009 à 15:35:53, Dave Page a écrit : 
On Tue, May 5, 2009 at 2:33 PM, Guillaume Lelarge

<guillaume@lelarge.info> wrote:   
Le mardi 5 mai 2009 à 15:27:13, Dave Page a écrit :     
On Tue, May 5, 2009 at 2:21 PM, Guillaume Lelarge

<guillaume@lelarge.info> wrote:       
Le mardi 5 mai 2009 à 15:10:44, Dave Page a écrit :         
On Tue, Mar 31, 2009 at 5:13 PM, Dave Page <dpage@pgadmin.org> wrote:           
- The documentation helpfile and shortcut need to be added to
pkg/win32/src/pgadmin3.wxs. Not entirely sure on the best way to
present that - should we have shortcuts like "pgAdmin Documentation
(English)", "pgAdmin Documentation (French)" and so on?             
Did you make a decision on this?           
It's probably better that way (shortcut for each translation). I don't
think we'll have a huge number of translated documentation, and it's
always better to be able to grab the english one.         
OK - you want to fixup the installer?       
I won't have the time to do it till tonight. If you can wait, I can work
on this tonight. But I suppose you're asking for beta 3?     
No, I'm already building that. This will be for b4/rc1.   
Here is the patch. Can you check it? it's the first time I do it, and I'm not 
sure I don't forget something. 
--
Thanks & Regards,
Ashesh Vashi

EnterpriseDB INDIA: http://www.enterprisedb.com

Re: Building the French docs

От
Dave Page
Дата:
On Tue, May 5, 2009 at 6:54 PM, Guillaume Lelarge
<guillaume@lelarge.info> wrote:
> Le mardi 5 mai 2009 à 19:49:03, Ashesh Vashi a écrit :
>> Hi Guillaume,
>>
>> I think - you forget the attachment. :p
>>
>
> Thanks Ashesh, I indeed forgot it. Here it is.

I see a couple of easily-fixed issues:

- Both shortcuts have the same name (Name="$(var.APPNAME) Help")
- You're missing a ComponentRef node

<laugh type="manic">I will get you fluent with Wix - and you'll never
escape it's clutches!!</laugh>

--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com

Re: Building the French docs

От
Guillaume Lelarge
Дата:
Le mercredi 6 mai 2009 à 10:01:06, Dave Page a écrit :
> On Tue, May 5, 2009 at 6:54 PM, Guillaume Lelarge
>
> <guillaume@lelarge.info> wrote:
> > Le mardi 5 mai 2009 à 19:49:03, Ashesh Vashi a écrit :
> >> Hi Guillaume,
> >>
> >> I think - you forget the attachment. :p
> >
> > Thanks Ashesh, I indeed forgot it. Here it is.
>
> I see a couple of easily-fixed issues:
>
> - Both shortcuts have the same name (Name="$(var.APPNAME) Help")
> - You're missing a ComponentRef node
>

Done. New patch attached.

> <laugh type="manic">I will get you fluent with Wix - and you'll never
> escape it's clutches!!</laugh>

héhé... getting me fluent with Wix will be a really hard work. I wish you good
luck with that :)


--
Guillaume.
 http://www.postgresqlfr.org
 http://dalibo.com

Вложения

Re: Building the French docs

От
Dave Page
Дата:
On Wed, May 6, 2009 at 1:00 PM, Guillaume Lelarge
<guillaume@lelarge.info> wrote:

> Done. New patch attached.

Thanks - applied.


--
Dave Page
EnterpriseDB UK:   http://www.enterprisedb.com