wiki.techinc.nl/maintenance/diffLanguage.php
Brion Vibber 266d41f165 * Added wfDie() wrapper, and some manual die(-1), to force the return code
to the shell to return nonzero when we crap out with an error.
2006-01-14 02:49:43 +00:00

159 lines
5.2 KiB
PHP

<?php
# MediaWiki web-based config/installation
# Copyright (C) 2004 Ashar Voultoiz <thoane@altern.org> and others
# http://www.mediawiki.org/
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program; if not, write to the Free Software Foundation, Inc.,
# 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
# http://www.gnu.org/copyleft/gpl.html
/**
* Usage: php DiffLanguage.php [lang [file]]
*
* lang: Enter the language code following "Language" of the LanguageXX.php you
* want to check. If using linux you might need to follow case aka Zh and not
* zh.
*
* file: A php language file you want to include to compare mediawiki
* Language{Lang}.php against (for example Special:Allmessages PHP output).
*
* The goal is to get a list of messages not yet localised in a languageXX.php
* file using the language.php file as reference.
*
* The script then print a list of wgAllMessagesXX keys that aren't localised, a
* percentage of messages correctly localised and the number of messages to be
* translated.
*
* @package MediaWiki
* @subpackage Maintenance
*/
/** This script run from the commandline */
require_once( 'parserTests.inc' );
require_once( 'commandLine.inc' );
if( isset($options['help']) ) { usage(); wfDie(); }
$wgLanguageCode = ucfirstlcrest($wgLanguageCode);
/** Language messages we will use as reference. By default 'en' */
$referenceMessages = $wgAllMessagesEn;
$referenceLanguage = 'En';
$referenceFilename = 'Language'.$referenceLanguage.'.php';
/** Language messages we will test. */
$testMessages = array();
$testLanguage = '';
/** whereas we use an external language file */
$externalRef = false;
# FUNCTIONS
/** @todo more informations !! */
function usage() {
echo 'php DiffLanguage.php [lang [file]] [--color=(yes|no|light)]'."\n";
}
/** Return a given string with first letter upper case, the rest lowercase */
function ucfirstlcrest($string) {
return strtoupper(substr($string,0,1)).strtolower(substr($string,1));
}
/**
* Return a $wgAllmessages array shipped in MediaWiki
* @param string $languageCode Formated language code
* @return array The MediaWiki default $wgAllMessages array requested
*/
function getMediawikiMessages($languageCode = 'En') {
$foo = "wgAllMessages$languageCode";
global $$foo, $wgSkinNamesEn;
// it might already be loaded in LocalSettings.php
if(!isset($$foo)) {
global $IP;
$langFile = $IP.'/languages/Language'.$languageCode.'.php';
if (file_exists( $langFile ) ) {
print "Including $langFile\n";
global $wgNamespaceNamesEn;
include($langFile);
} else wfDie("ERROR: The file $langFile does not exist !\n");
}
return $$foo;
}
/**
* Return a $wgAllmessages array in a given file. Language of the array
* need to be given cause we can not detect which language it provides
* @param string $filename Filename of the file containing a message array
* @param string $languageCode Language of the external array
* @return array A $wgAllMessages array from an external file.
*/
function getExternalMessages($filename, $languageCode) {
print "Including external file $filename.\n";
include($filename);
$foo = "wgAllMessages$languageCode";
return $$foo;
}
# MAIN ENTRY
if ( isset($args[0]) ) {
$lang = ucfirstlcrest($args[0],1);
// eventually against another language file we will use as reference instead
// of the default english language.
if( isset($args[1])) {
// we assume the external file contain an array of messages for the
// lang we are testing
$referenceMessages = getExternalMessages( $args[1], $lang );
$referenceLanguage = $lang;
$referenceFilename = $args[1];
$externalRef = true;
}
// Load datas from MediaWiki
$testMessages = getMediawikiMessages($lang);
$testLanguage = $lang;
} else {
usage();
wfDie();
}
/** parsertest is used to do differences */
$myParserTest =& new ParserTest();
# Get all references messages and check if they exist in the tested language
$i = 0;
$msg = "MW Language{$testLanguage}.php against ";
if($externalRef) { $msg .= 'external file '; }
else { $msg .= 'internal file '; }
$msg .= $referenceFilename.' ('.$referenceLanguage."):\n----\n";
echo $msg;
// process messages
foreach($referenceMessages as $index => $ref)
{
// message is not localized
if(!(isset($testMessages[$index]))) {
$i++;
print "'$index' => \"$ref\",\n";
// Messages in the same language differs
} elseif( ($lang == $referenceLanguage) AND ($testMessages[$index] != $ref)) {
print "\n$index differs:\n";
print $myParserTest->quickDiff($testMessages[$index],$ref,'tested','reference');
}
}
echo "\n----\n".$msg;
echo "$referenceLanguage language is complete at ".number_format((100 - $i/count($wgAllMessagesEn) * 100),2)."%\n";
echo "$i unlocalised messages of the ".count($wgAllMessagesEn)." messages available.\n";
?>