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 _______________________________________________ gnome-doc-list mailing list [email protected] http://mail.gnome.org/mailman/listinfo/gnome-doc-list
