Thread: i18n online documentation

i18n online documentation

From
Raphaël Enrici
Date:
Dear friends,

Sorry for the noise, I need a refresh on the project I think:
I can't find hhp files for the fr_FR and other languages, what is
missing in our development process to get these files translated?

Regards,
Raphaël

Re: i18n online documentation

From
Guillaume LELARGE
Date:
Hi Raphaël,

Raphaël Enrici a écrit :
> Sorry for the noise, I need a refresh on the project I think:
> I can't find hhp files for the fr_FR and other languages, what is
> missing in our development process to get these files translated?
>

We built a french hhp file for PostgreSQL manual. I just need some time
to test it at work. And this is only the PostgreSQL manual... I hope I
can work on the pgAdmin manual soon.


Re: i18n online documentation

From
"Dave Page"
Date:

> -----Original Message-----
> From: pgadmin-hackers-owner@postgresql.org
> [mailto:pgadmin-hackers-owner@postgresql.org] On Behalf Of
> Raphaël Enrici
> Sent: 08 May 2006 21:00
> To: PgAdmin Hackers
> Subject: [pgadmin-hackers] i18n online documentation
>
> Dear friends,
>
> Sorry for the noise, I need a refresh on the project I think:
> I can't find hhp files for the fr_FR and other languages,
> what is missing in our development process to get these files
> translated?

There lies a massive problem. The code will automatically use localised docs if it can find them, but that requires
thatthe entire (ie. pgAdmin, Slony and PostgreSQL) docset is translated. That's not the real problem though - the real
issueis when we do a release of pgInstaller, we have perhaps a week to bring everything into sync and get it out of the
door.For the non-windows users, the pgAdmin chm/hhp file *is* the documentation for the Windows version of PostgreSQL. 

I suppose we could only ship the English docs with pgInstaller, but that still leaves a potential problem bringing
everythinginto sync for pgAdmin-only releases. What I think we perhaps need to look at is making the localised docs a
runtime-downloadablecomponent, so that we can release them seperately and make it clear to the user before they
downloadwhat version of each set of docs is available to them in the set. 

Thoughts?

Regards, Dave.

Re: i18n online documentation

From
"Guillaume Lelarge"
Date:
2006/5/9, Dave Page <dpage@vale-housing.co.uk>:
> > Sorry for the noise, I need a refresh on the project I think:
> > I can't find hhp files for the fr_FR and other languages,
> > what is missing in our development process to get these files
> > translated?
>
> There lies a massive problem. The code will automatically use localised docs if it
> can find them, but that requires that the entire (ie. pgAdmin, Slony and
> PostgreSQL) docset is translated. That's not the real problem though - the real
> issue is when we do a release of pgInstaller, we have perhaps a week to bring
> everything into sync and get it out of the door. For the non-windows users, the
> pgAdmin chm/hhp file *is* the documentation for the Windows version of
> PostgreSQL.
>
> I suppose we could only ship the English docs with pgInstaller, but that still
> leaves a potential problem bringing everything into sync for pgAdmin-only
> releases. What I think we perhaps need to look at is making the localised docs a
> runtime-downloadable component, so that we can release them seperately and
> make it clear to the user before they download what version of each set of docs
> is available to them in the set.
>

Perhaps is it possible to ask the user at install time ? I mean, the
user installs pgAdmin software with the installer, the installer asks
him if he wants to get a localized help file. If the user agrees, the
installer shows him all languages available. When the user finally
choose his language, the installer downloads the files and installs
them.


--
Guillaume.

Re: i18n online documentation

From
"Dave Page"
Date:

> -----Original Message-----
> From: Guillaume Lelarge [mailto:guillaume.lelarge@gmail.com]
> Sent: 09 May 2006 21:23
> To: Dave Page
> Cc: Raphaël Enrici; PgAdmin Hackers
> Subject: Re: [pgadmin-hackers] i18n online documentation
>
> Perhaps is it possible to ask the user at install time ? I
> mean, the user installs pgAdmin software with the installer,
> the installer asks him if he wants to get a localized help
> file. If the user agrees, the installer shows him all
> languages available. When the user finally choose his
> language, the installer downloads the files and installs them.

Not really feasible - the Windows installer could potentially do this, but we have a Mac appbundle, Debian APT
distribution,FreeBSD ports distribution, Redhat RPM distributions, Slackware packages, source tarballs and more to deal
with- many of which couldn't do such things. 

Regards, Dave.

Re: i18n online documentation

From
"Guillaume Lelarge"
Date:
2006/5/9, Dave Page <dpage@vale-housing.co.uk>:
> > -----Original Message-----
> > From: Guillaume Lelarge [mailto:guillaume.lelarge@gmail.com]
> > Sent: 09 May 2006 21:23
> > To: Dave Page
> > Cc: Raphaël Enrici; PgAdmin Hackers
> > Subject: Re: [pgadmin-hackers] i18n online documentation
> >
> > Perhaps is it possible to ask the user at install time ? I
> > mean, the user installs pgAdmin software with the installer,
> > the installer asks him if he wants to get a localized help
> > file. If the user agrees, the installer shows him all
> > languages available. When the user finally choose his
> > language, the installer downloads the files and installs them.
>
> Not really feasible - the Windows installer could potentially do this, but we have a
> Mac appbundle, Debian APT distribution, FreeBSD ports distribution, Redhat RPM
> distributions, Slackware packages, source tarballs and more to deal with - many
> of which couldn't do such things.
>

Yes, you're right. I was thinking of an old installer I used to
download nigthly builds of mozilla. It was working on windows only.
Sorry about this...


--
Guillaume.

Re: i18n online documentation

From
"Dave Page"
Date:

> -----Original Message-----
> From: Guillaume Lelarge [mailto:guillaume.lelarge@gmail.com]
> Sent: 09 May 2006 22:00
> To: Dave Page
> Cc: Raphaël Enrici; PgAdmin Hackers
> Subject: Re: [pgadmin-hackers] i18n online documentation
>
> Yes, you're right. I was thinking of an old installer I used
> to download nigthly builds of mozilla. It was working on windows only.
> Sorry about this...

Don't apologise - just keep the ideas coming :-)

/D

Re: i18n online documentation

From
blacknoz@club-internet.fr
Date:
----Message d'origine----
>Sujet: Re: [pgadmin-hackers] i18n online documentation
>Date: Tue, 9 May 2006 22:04:43 +0100
>De: "Dave Page" <dpage@vale-housing.co.uk>
>A: "Guillaume Lelarge" <guillaume.lelarge@gmail.com>
>Copie à: Raphaël Enrici <blacknoz@club-internet.fr>,
>
>
>
>> -----Original Message-----
>> From: Guillaume Lelarge [mailto:guillaume.lelarge@gmail.com]
>> Sent: 09 May 2006 22:00
>> To: Dave Page
>> Cc: Raphaël Enrici; PgAdmin Hackers
>> Subject: Re: [pgadmin-hackers] i18n online documentation
>>
>> Yes, you're right. I was thinking of an old installer I used
>> to download nigthly builds of mozilla. It was working on windows only.
>> Sorry about this...
>
>Don't apologise - just keep the ideas coming :-)

Separate downloaders/installers integrated in the app
are not my cup of tea. However, for such case we may
keep the idea of a language pack downloader which could
install the language pack in the ~/.pgadmin3_dir/.
This would not clash with an external packaging if the
app takes care of looking for the language packs in different
locations: from the most general path (system path) to the
most particular one (user path).
I would package pgadmin3-i18n separately or as an addon.

Just my 0,000001 euro cent.

Cheers,
Raph
P.S. Something else Dave, in misc.cpp, pgAdmin is looking for ..hhp and not .hhp, is it normal or is it a typo?

Index: utils/misc.cpp
===================================================================
--- utils/misc.cpp      (revision 5144)
+++ utils/misc.cpp      (working copy)
@@ -352,7 +352,7 @@
         firstCall=false;
         wxString helpdir=docPath + wxT("/") + settings->GetCanonicalLanguage();

-        if (!wxFile::Exists(helpdir + wxT("/pgadmin3..hhp")) &&
+        if (!wxFile::Exists(helpdir + wxT("/pgadmin3.hhp")) &&
 #if defined(__WXMSW__) || wxUSE_LIBMSPACK
             !wxFile::Exists(helpdir + wxT("/pgadmin3.chm")) &&
 #endif



Re: i18n online documentation

From
"Dave Page"
Date:

> -----Original Message-----
> From: blacknoz@club-internet.fr [mailto:blacknoz@club-internet.fr]
> Sent: 11 May 2006 08:24
> To: Dave Page; guillaume.lelarge@gmail.com
> Cc: pgadmin-hackers@postgresql.org
> Subject: Re: Re: [pgadmin-hackers] i18n online documentation
>
> Separate downloaders/installers integrated in the app are not
> my cup of tea. However, for such case we may keep the idea of
> a language pack downloader which could install the language
> pack in the ~/.pgadmin3_dir/.

Yeah, Andreas and I discussed doing something like that a while back.

> This would not clash with an external packaging if the app
> takes care of looking for the language packs in different
> locations: from the most general path (system path) to the
> most particular one (user path).
> I would package pgadmin3-i18n separately or as an addon.
>
> Just my 0,000001 euro cent.
>
> Cheers,
> Raph
> P.S. Something else Dave, in misc.cpp, pgAdmin is looking for
> ..hhp and not .hhp, is it normal or is it a typo?

I can't imagine any reason for it - fixed, thanks.

Regards, Dave.