Re: Packages ready to translate

[Shaun McCance <shaunm gnome org>]

On Tue, 2010-07-13 at 21:54 +0200, Mario Blättermann wrote:
> Am Montag, den 12.07.2010, 21:16 +0200 schrieb Andre Klapper:
> Am Montag, den 12.07.2010, 19:56 +0200 schrieb Mario Blättermann:
> > > > We don't have previous experience in translating the documentation and
> > > > how to "compile" it, so information about it would be very very useful
> > > > too.
> > > > 
> > > >
> > > After translating the po file provided by Vertimus, you can use the
> > > command "xml2po" to create the translated *.page files. Have a look at
> > > the xml2po manpage to see more. Well, it is a bit outdated, but you
> > > have to replace the mentioned *.xml filenames with the *.page
> > > filenames, that's all. Note that the -e switch to include the entities
> > > does't work with some versions of the gnome-doc-utils. In this case,
> > > you have to convert your *.page files one-by-one.
> > > 
> > > To view the manual, navigate to the folder where the *.page files
> > > reside, and just type "yelp ./". In some cases, you have to add the
> > > full path instead of "./". Example:
> > > "yelp /home/fran/empathy/help/gl/".
> > 
> > Thanks, that was helpful!
> > 
> > Anybody knows if this documented somewhere in our wiki for the
> > translators under http://live.gnome.org/TranslationProject/* ?
> > 
> > andre
> > 
> 
> No, it isn't documented yet. Mallard is a quite new kind of
>  documentation stuff. But anyone should update the xml2po man
>  page before.
> 
> Well, there's an outdated manual regarding the gnome-doc-utils [1].
>  In the nearest future (I hope so) this stuff will be part of the
>  Mallard documentation [2]. The current version contains such things
>  as the CVS integration, seems to be from the ancients of GNOME... 
> 
> By the way, I could migrate the old gnome-doc-utils manual [1]
>  to Mallard, if needed.

gnome-doc-utils is being replaced by yelp-tools. It's in git
now, but we don't have any packages using it. The build stuff
in yelp-tools only supports the new xdg help system, so any
packages that convert will only work with Yelp 3.

The instructions for gnome-doc-utils or yelp-tools don't
really belong in the Mallard spec. They're specific tools
and implementations. The Mallard spec is about the format
and how to handle it in general. Anybody can build whatever
Mallard tools they want.

I would like to create a website for Yelp and its related
packages (yelp-xsl, yelp-tools, libyelp), probably something
under projects.gnome.org. Maybe these sorts of instructions
should just go on the web. Any web hackers want to help?

--
Shaun