Re: [GRASS-user] HTML manuals languages
Markus Neteler wrote: > > As I said last time, first we need to determine whether: > > > > 1. A single set of manual pages are installed, for a single language, > > or: > > 2. Multiple languages are installed, in which case how are the files > > named and in which directories are they stored? > > My suggestion some years ago was: > - naming scheme: description|module_ISO.html > - put files alongside the description|module.html files > - prefer existing description|module_ISO.html files in the installed > docs/html/ > directory over the english one while having in the header or footer the > link to the english page > > > Also, if a translated manual page doesn't exist, the English version > > would presumably be used, but should the --html-description header be > > generated in English or in the selected language? > > IMHO in the selected language to have as much as possible available in > that language (btw, the Japanese team translated almost all .po files in one > month!). So you want something like: for each module: generate non-localised --interface-description header (with LC_ALL=C) generate $GISBASE/docs/html/.html from .html and the non-localised header for each language in : generate --interface-description header for that language if _.html exists: generate $GISBASE/docs/html/_.html from _.html and the localised header else: generate $GISBASE/docs/html/_.html from .html and the localised header ? What about the (nroff) manual pages? As for links between manual pages: The generated headers don't contain any links. The only links are those put there by the author of the .html file. Authors of localised .html files can put links to the localised versions of other files if they exist. However: if a semi-localised HTML file is generated by combining the localised header with the English .html, any links will refer to the English version even if a localised or semi-localised version exists. An alternative approach would be to put localised and semi-localised versions of HTML files in a separate directory, i.e. $GISBASE/docs/html//.html. As the "See Also" links are relative, they will always refer to the (semi-) localised version in the same directory. The alternative would be to process the HTML files to re-write any links to point to the localised version, which means writing the code to do it (as well as recognising any links which shouldn't be re-written). -- Glynn Clements ___ grass-user mailing list grass-user@lists.osgeo.org http://lists.osgeo.org/mailman/listinfo/grass-user
Re: [GRASS-user] HTML manuals languages
On Thu, Feb 25, 2010 at 10:05 PM, Glynn Clements wrote: > > Markus Neteler wrote: > >> >> I would like to know if it's possible to >> >> have html manual pages in different languages besides >> >> English. I mean, the LC_Languages, in locale, can also be >> >> applied to the English html manual pages? >> > >> > no/yes >> > >> > see http://grass.osgeo.org/wiki/Updating_GRASS_Documentation#Translations >> >> see also >> http://trac.osgeo.org/grass/ticket/846 >> >> It would be great to make this (small?) modification to the Makefile >> system - I just don't know how. > > As I said last time, first we need to determine whether: > > 1. A single set of manual pages are installed, for a single language, > or: > 2. Multiple languages are installed, in which case how are the files > named and in which directories are they stored? My suggestion some years ago was: - naming scheme: description|module_ISO.html - put files alongside the description|module.html files - prefer existing description|module_ISO.html files in the installed docs/html/ directory over the english one while having in the header or footer the link to the english page > Also, if a translated manual page doesn't exist, the English version > would presumably be used, but should the --html-description header be > generated in English or in the selected language? IMHO in the selected language to have as much as possible available in that language (btw, the Japanese team translated almost all .po files in one month!). Markus ___ grass-user mailing list grass-user@lists.osgeo.org http://lists.osgeo.org/mailman/listinfo/grass-user
Re: [GRASS-user] HTML manuals languages
Markus Neteler wrote: > >> I would like to know if it's possible to > >> have html manual pages in different languages besides > >> English. I mean, the LC_Languages, in locale, can also be > >> applied to the English html manual pages? > > > > no/yes > > > > see http://grass.osgeo.org/wiki/Updating_GRASS_Documentation#Translations > > see also > http://trac.osgeo.org/grass/ticket/846 > > It would be great to make this (small?) modification to the Makefile > system - I just don't know how. As I said last time, first we need to determine whether: 1. A single set of manual pages are installed, for a single language, or: 2. Multiple languages are installed, in which case how are the files named and in which directories are they stored? Also, if a translated manual page doesn't exist, the English version would presumably be used, but should the --html-description header be generated in English or in the selected language? -- Glynn Clements ___ grass-user mailing list grass-user@lists.osgeo.org http://lists.osgeo.org/mailman/listinfo/grass-user
Re: [GRASS-user] HTML manuals languages
On Thu, Feb 25, 2010 at 10:55 AM, Hamish wrote: > Luis wrote: >> I would like to know if it's possible to >> have html manual pages in different languages besides >> English. I mean, the LC_Languages, in locale, can also be >> applied to the English html manual pages? > > no/yes > > see http://grass.osgeo.org/wiki/Updating_GRASS_Documentation#Translations see also http://trac.osgeo.org/grass/ticket/846 It would be great to make this (small?) modification to the Makefile system - I just don't know how. Markus ___ grass-user mailing list grass-user@lists.osgeo.org http://lists.osgeo.org/mailman/listinfo/grass-user
Re: [GRASS-user] HTML manuals languages
Luis wrote: > I would like to know if it's possible to > have html manual pages in different languages besides > English. I mean, the LC_Languages, in locale, can also be > applied to the English html manual pages? no/yes see http://grass.osgeo.org/wiki/Updating_GRASS_Documentation#Translations Hamish ___ grass-user mailing list grass-user@lists.osgeo.org http://lists.osgeo.org/mailman/listinfo/grass-user
[GRASS-user] HTML manuals languages
Greetings I would like to know if it's possible to have html manual pages in different languages besides English. I mean, the LC_Languages, in locale, can also be applied to the English html manual pages? Thanks Luis ___ grass-user mailing list grass-user@lists.osgeo.org http://lists.osgeo.org/mailman/listinfo/grass-user