Re: Tool to help translators

From: Date: Tue, 16 Sep 2003 23:00:41 +0000
Subject: Re: Tool to help translators
References: 1  Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-1525@lists.php.net to get a copy of this message
Hi Thierry, Nice work! Perhaps this could be added to the FAQ (I'm sure no one would complain if you just popped it in the English FAQ yourself, unless you don't have time). Regards, Greg Thierry Bothorel wrote:
Hi, personaly, I find that is is a pain "maintaining" translated files up to date and for new translators to see what is to be done. I began using filters in my mail client to detect only files already translated that were comitted again. I gave up quickly. After some searches, I found the "PHP Documentation HOWTO" link that is a litle bit hidden on php.net. Then I really found a gem (to my point of view) on this page : http://www.php.net/manual/howto/translation-revtrack.html This is a simple php script (revcheck.php) that output a nice html page will all translated/unstranslated files, and especially what I look for, a list of not up to date translated file with a direct link to viewcvs to see exactly what is changed. There is one requirement : the english files must have the $Revision$ keyword at the top of the page, and the translated file must have : <!-- EN-Revision: 1.16 Maintainer: jane Status: ready -->at the top of the page (in fact the script look for the first 500 characters).I added this line to all the french files and put a demo here as well as a link to download revcheck.php:http://perso.wanadoo.fr/t.b/Temp/demo_revcheck.htmlUse of translation.xml file is optional but add some useful information to the output. As youcan see links to diff when the english file does not have the $Revision$ keyword are broken.Usage :- put revcheck.php in /peardoc/ directory- put trnaslation.xml in /peardoc/lang/ directory (optional)- run '$ php revcheck.php xx >revcheck.html' where xx is the lang directory- open revcheck.html if /peardoc/ directory to see the output.Revcheck is designed to run from a shell only.It would be VERY nice (:-) if this revcheck.html could be built for each language with the whole peardoc manual and opened with 'http://www.pear.php.net/manual/lang/revcheck.html'Thierry Bothorel


« previous php.pear.doc (#1525) next »