Thread: Re: pgAdmin3 doc location
Dave Page wrote: >Dunno, you wanted the web support for the help! If you want to remove >it, go ahead. > I invented the web help for *pgsql* help, which depends on the system in use, and may change while pgAdmin is still used (I'm using the 7.4 doc, and will always use the newest). BTW, we should drop a note in the doc that some pgAdmin3 options depend on the backend, and may not be available for older versions. I'll recode pgAdmin help calling as soon as we have agreed where files should go for release installs. I'd vote to put them under the existing ui/lang_Country directories, parallel to *.mo, but I feel you wouldn't like that... Just give me your vote for a better place. I haven't worked with HTMLWorkshop before, it's hopefully easy to import html files into a htmlws project at a later time. Can you do that? I just tried the pgadmin2 help directory under win32 and gtk2 (wxHtmlHelpController) and it displayed nicely. >>Insert of empty cols don't insert NULL any more, thus serial as any >>other column with a default value are handled now corretly. >> >> >Cool, thanks. > I tend to fix things so fast, that I forget they ever existed :-) Therefore, I didn't mention it. Regards, Andreas
On Monday 23 June 2003 18:26, Andreas Pflug wrote: > I'd vote to put them under the existing > ui/lang_Country directories, parallel to *.mo, but I feel you wouldn't > like that... Just give me your vote for a better place. Maybe docs/lang_Country is easier to maintain because you will be able to "ls -l docs" and see how many docs are translated... We will deliver .mo files and documentation in the same packages, like : - http://www.pgadmin.org/snapshots/linux/redhat9/RPMS - http://www.pgadmin.org/snapshots/linux/mandrake91/RPMS Are you able to switch back to English when a French page does not exist? Cheers, Jean-Michel
Jean-Michel POURE wrote: >Maybe docs/lang_Country is easier to maintain because you will be able to "ls >-l docs" and see how many docs are translated... > Dave? > >We will deliver .mo files and documentation in the same packages, like : >- http://www.pgadmin.org/snapshots/linux/redhat9/RPMS >- http://www.pgadmin.org/snapshots/linux/mandrake91/RPMS > >Are you able to switch back to English when a French page does not exist? > No, because after the root file for help is located, the help controller will handle all stuff itself, it's merely a big structured single document. There are no side entries. Partial translation won't work, all or nothing. It's only the application help ("contents") that will be translatable, the pgsql doc is external. Of course, the user might point to an external site that's providing translated pgsql doc, hopefully all page names are identical.... Regards, Andreas
It's rumoured that Andreas Pflug once said: > Dave Page wrote: > >>Dunno, you wanted the web support for the help! If you want to remove >>it, go ahead. >> > I invented the web help for *pgsql* help, which depends on the system > in use, and may change while pgAdmin is still used (I'm using the 7.4 > doc, and will always use the newest). BTW, we should drop a note in > the doc that some pgAdmin3 options depend on the backend, and may not > be > available for older versions. Yeah, I know - I'm just messin with ya! Seriously though, we need to be careful about what docs *we* use, and what we say other people should use. We will never release pgAdmin for an unreleased version of PostgreSQL (even if it's in feature freeze) - catalogues etc. can change even at the last minute. We should be sure we absolutely know what versions we are coding for and make pgAdmin behave appropriately (not that we haven't been afaik). > I'll recode pgAdmin help calling as soon as we have agreed where files > should go for release installs. I'd vote to put them under the existing > ui/lang_Country directories, parallel to *.mo, but I feel you wouldn't > like that... Just give me your vote for a better place. I think share/doc/lang_country in parallel with share/ui/lang_country. That's where I put them now iirc. > I haven't worked with HTMLWorkshop before, it's hopefully easy to > import html files into a htmlws project at a later time. Can you do > that? I just tried the pgadmin2 help directory under win32 and gtk2 > (wxHtmlHelpController) and it displayed nicely. Oh right, OK. In that case I'll take a look. Building a chm from htmls is no problem. Dunno how you reference individual pages though... > I tend to fix things so fast, that I forget they ever existed :-) > Therefore, I didn't mention it. :-) Regards, Dave
Dave Page wrote: >Oh right, OK. In that case I'll take a look. Building a chm from htmls is >no problem. Dunno how you reference individual pages though... > Not chm, just the hhp, hhc and hhk file and their subfolders. I haven't been deeper into this, but we seem to need this source level (alternatively, this can be put into a zip file). Regards, Andreas
Dave Page wrote: >I think share/doc/lang_country in parallel with share/ui/lang_country. > pgAdmin will now try to locate a doc version that fits the language settings, and will fall back to en_US. The options setting is removed. Regards, Andreas