Tool to help translators

From: Date: Tue, 16 Sep 2003 22:19:12 +0000
Subject: Tool to help translators
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-1524@lists.php.net to get a copy of this message
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 (#1524) next »