Localisation updates for core and extension messages from translatewiki.net (2011...
[lhc/web/wiklou.git] / languages / Language.php
index e1f6b00..62a2b11 100644 (file)
@@ -44,13 +44,15 @@ class FakeConverter {
        function convertTitle( $t ) { return $t->getPrefixedText(); }
        function getVariants() { return array( $this->mLang->getCode() ); }
        function getPreferredVariant() { return $this->mLang->getCode(); }
+       function getDefaultVariant() { return $this->mLang->getCode(); }
+       function getURLVariant() { return ''; }
        function getConvRuleTitle() { return false; }
        function findVariantLink( &$l, &$n, $ignoreOtherCond = false ) { }
        function getExtraHashOptions() { return ''; }
        function getParsedTitle() { return ''; }
        function markNoConversion( $text, $noParse = false ) { return $text; }
        function convertCategoryKey( $key ) { return $key; }
-       function convertLinkToAllVariants( $text ) { return autoConvertToAllVariants( $text ); }
+       function convertLinkToAllVariants( $text ) { return $this->autoConvertToAllVariants( $text ); }
        function armourMath( $text ) { return $text; }
 }
 
@@ -130,6 +132,8 @@ class Language {
 
        /**
         * Get a cached language object for a given language code
+        * @param $code String
+        * @return Language
         */
        static function factory( $code ) {
                if ( !isset( self::$mLangObjCache[$code] ) ) {
@@ -144,6 +148,8 @@ class Language {
 
        /**
         * Create a language object for a given language code
+        * @param $code String
+        * @return Language
         */
        protected static function newFromCode( $code ) {
                global $IP;
@@ -260,7 +266,7 @@ class Language {
                                $this->namespaceNames[NS_PROJECT_TALK] =
                                        $this->fixVariableInNamespace( $talk );
                        }
-                       
+
                        # Sometimes a language will be localised but not actually exist on this wiki.
                        foreach( $this->namespaceNames as $key => $text ) {
                                if ( !isset( $validNamespaces[$key] ) ) {
@@ -485,6 +491,25 @@ class Language {
                return $names;
        }
 
+       /**
+        * Get translated language names. This is done on best effort and
+        * by default this is exactly the same as Language::getLanguageNames.
+        * The CLDR extension provides translated names.
+        * @param $code String Language code.
+        * @return Array language code => language name
+        * @since 1.18.0
+        */
+       public static function getTranslatedLanguageNames( $code ) {
+               $names = array();
+               wfRunHooks( 'LanguageGetTranslatedLanguageNames', array( &$names, $code ) );
+
+               foreach ( self::getLanguageNames() as $code => $name ) {
+                       if ( !isset( $names[$code] ) ) $names[$code] = $name;
+               }
+
+               return $names;
+       }
+
        /**
         * Get a message from the MediaWiki namespace.
         *
@@ -618,9 +643,8 @@ class Language {
         * escaping format.
         *
         * Supported format characters are dDjlNwzWFmMntLoYyaAgGhHiscrU. See the
-        * PHP manual for definitions. "o" format character is supported since
-        * PHP 5.1.0, previous versions return literal o.
-        * There are a number of extensions, which start with "x":
+        * PHP manual for definitions. There are a number of extensions, which
+        * start with "x":
         *
         *    xn   Do not translate digits of the next numeric format character
         *    xN   Toggle raw digit (xn) flag, stays set until explicitly unset
@@ -670,7 +694,6 @@ class Language {
         * @param $ts String: 14-character timestamp
         *      YYYYMMDDHHMMSS
         *      01234567890123
-        * @todo emulation of "o" format character for PHP pre 5.1.0
         * @todo handling of "o" format character for Iranian, Hebrew, Hijri & Thai?
         */
        function sprintfDate( $format, $ts ) {
@@ -845,18 +868,11 @@ class Language {
                                        }
                                        $num = gmdate( 'L', $unix );
                                        break;
-                               # 'o' is supported since PHP 5.1.0
-                               # return literal if not supported
-                               # TODO: emulation for pre 5.1.0 versions
                                case 'o':
                                        if ( !$unix ) {
                                                $unix = wfTimestamp( TS_UNIX, $ts );
                                        }
-                                       if ( version_compare( PHP_VERSION, '5.1.0' ) === 1 ) {
-                                               $num = date( 'o', $unix );
-                                       } else {
-                                               $s .= 'o';
-                                       }
+                                       $num = date( 'o', $unix );
                                        break;
                                case 'Y':
                                        $num = substr( $ts, 0, 4 );
@@ -984,7 +1000,6 @@ class Language {
                                } else {
                                        $s .= $this->formatNum( $num, true );
                                }
-                               $num = false;
                        }
                }
                return $s;
@@ -1375,7 +1390,7 @@ class Language {
                return $s;
        }
 
-       /**
+       /**
         * Hebrew Gematria number formatting up to 9999
         */
        static function hebrewNumeral( $num ) {
@@ -1505,6 +1520,7 @@ class Language {
         * @return string
         */
        function date( $ts, $adj = false, $format = true, $timecorrection = false ) {
+               $ts = wfTimestamp( TS_MW, $ts );
                if ( $adj ) {
                        $ts = $this->userAdjust( $ts, $timecorrection );
                }
@@ -1523,6 +1539,7 @@ class Language {
         * @return string
         */
        function time( $ts, $adj = false, $format = true, $timecorrection = false ) {
+               $ts = wfTimestamp( TS_MW, $ts );
                if ( $adj ) {
                        $ts = $this->userAdjust( $ts, $timecorrection );
                }
@@ -1551,11 +1568,11 @@ class Language {
        }
 
        function getMessage( $key ) {
-               return self::$dataCache->getSubitem( $this->mCode, 'messages', $key );
+               return self::$dataCache->getSubitem( $this->getCodeForMessage(), 'messages', $key );
        }
 
        function getAllMessages() {
-               return self::$dataCache->getItem( $this->mCode, 'messages' );
+               return self::$dataCache->getItem( $this->getCodeForMessage(), 'messages' );
        }
 
        function iconv( $in, $out, $string ) {
@@ -1611,7 +1628,7 @@ class Language {
                        return ucfirst( $str ); // use PHP's ucfirst()
                } else {
                        // fall back to more complex logic in case of multibyte strings
-                       return self::uc( $str, true );
+                       return $this->uc( $str, true );
                }
        }
 
@@ -1771,7 +1788,7 @@ class Language {
                }
 
                $isutf8 = preg_match( '/^([\x00-\x7f]|[\xc0-\xdf][\x80-\xbf]|' .
-                '[\xe0-\xef][\x80-\xbf]{2}|[\xf0-\xf7][\x80-\xbf]{3})+$/', $s );
+                               '[\xe0-\xef][\x80-\xbf]{2}|[\xf0-\xf7][\x80-\xbf]{3})+$/', $s );
                if ( $isutf8 ) {
                        return $s;
                }
@@ -2338,8 +2355,8 @@ class Language {
                        # We got the first byte only of a multibyte char; remove it.
                        $string = substr( $string, 0, -1 );
                } elseif ( $char >= 0x80 &&
-                     preg_match( '/^(.*)(?:[\xe0-\xef][\x80-\xbf]|' .
-                                 '[\xf0-\xf7][\x80-\xbf]{1,2})$/', $string, $m ) )
+                         preg_match( '/^(.*)(?:[\xe0-\xef][\x80-\xbf]|' .
+                                                 '[\xf0-\xf7][\x80-\xbf]{1,2})$/', $string, $m ) )
                {
                        # We chopped in the middle of a character; remove it
                        $string = $m[1];
@@ -2372,7 +2389,7 @@ class Language {
         *
         * Note: tries to fix broken HTML with MWTidy
         *
-        * @param string $text String to truncate
+        * @param string $text HTML string to truncate
         * @param int $length (zero/positive) Maximum length (excluding ellipses)
         * @param string $ellipsis String to append to the truncated text
         * @returns string
@@ -2394,8 +2411,8 @@ class Language {
                $tagType = 0; // 0-open, 1-close
                $bracketState = 0; // 1-tag start, 2-tag name, 0-neither
                $entityState = 0; // 0-not entity, 1-entity
-               $tag = $ret = $ch = '';
-               $openTags = array();
+               $tag = $ret = '';
+               $openTags = array(); // open tag stack
                $textLen = strlen( $text );
                for ( $pos = 0; $pos < $textLen; ++$pos ) {
                        $ch = $text[$pos];
@@ -2464,7 +2481,8 @@ class Language {
                if ( $displayLen == 0 ) {
                        return ''; // no text shown, nothing to format
                }
-               $this->truncate_endBracket( $tag, $text[$textLen - 1], $tagType, $openTags ); // for bad HTML
+               // Close the last tag if left unclosed by bad HTML
+               $this->truncate_endBracket( $tag, $text[$textLen - 1], $tagType, $openTags );
                while ( count( $openTags ) > 0 ) {
                        $ret .= '</' . array_pop( $openTags ) . '>'; // close open tags
                }
@@ -2482,9 +2500,15 @@ class Language {
                return $skipCount;
        }
 
-       // truncateHtml() helper function
-       // (a) push or pop $tag from $openTags as needed
-       // (b) clear $tag value
+       /*
+        * truncateHtml() helper function
+        * (a) push or pop $tag from $openTags as needed
+        * (b) clear $tag value
+        * @param String &$tag Current HTML tag name we are looking at
+        * @param int $tagType (0-open tag, 1-close tag)
+        * @param char $lastCh Character before the '>' that ended this tag
+        * @param array &$openTags Open tag stack (not accounting for $tag)
+        */
        private function truncate_endBracket( &$tag, $tagType, $lastCh, &$openTags ) {
                $tag = ltrim( $tag );
                if ( $tag != '' ) {
@@ -2664,7 +2688,7 @@ class Language {
        }
 
        /**
-        * Get the list of variants supported by this langauge
+        * Get the list of variants supported by this language
         * see sample implementation in LanguageZh.php
         *
         * @return array an array of language codes
@@ -2673,8 +2697,16 @@ class Language {
                return $this->mConverter->getVariants();
        }
 
-       function getPreferredVariant( $fromUser = true, $fromHeader = false ) {
-               return $this->mConverter->getPreferredVariant( $fromUser, $fromHeader );
+       function getPreferredVariant() {
+               return $this->mConverter->getPreferredVariant();
+       }
+       
+       function getDefaultVariant() {
+               return $this->mConverter->getDefaultVariant();
+       }
+       
+       function getURLVariant() {
+               return $this->mConverter->getURLVariant();
        }
 
        /**
@@ -2697,6 +2729,8 @@ class Language {
         * If a language supports multiple variants, converts text
         * into an array of all possible variants of the text:
         *  'variant' => text in that variant
+        *
+        * @deprecated Use autoConvertToAllVariants()
         */
        function convertLinkToAllVariants( $text ) {
                return $this->mConverter->convertLinkToAllVariants( $text );
@@ -2755,6 +2789,18 @@ class Language {
        function getCode() {
                return $this->mCode;
        }
+       
+       /**
+        * Get langcode for message
+        * Some language, like Chinese (zh, without any suffix), has multiple
+        * interface languages, we could choose a better one for user.
+        * Inherit class can override this function if necessary.
+        *
+        * @return string
+        */
+       function getCodeForMessage() {
+               return $this->getPreferredVariant();
+       }
 
        function setCode( $code ) {
                $this->mCode = $code;
@@ -2858,17 +2904,18 @@ class Language {
                        throw new MWException(
                                "Utf8Case.ser is missing, please run \"make\" in the serialized directory\n" );
                }
-               extract( $arr );
+               $wikiUpperChars = $arr['wikiUpperChars'];
+               $wikiLowerChars = $arr['wikiLowerChars'];
                wfProfileOut( __METHOD__ );
                return array( $wikiUpperChars, $wikiLowerChars );
        }
 
        function formatTimePeriod( $seconds ) {
-               if ( $seconds < 10 ) {
-                       return $this->formatNum( sprintf( "%.1f", $seconds ) ) . $this->getMessageFromDB( 'seconds-abbrev' );
-               } elseif ( $seconds < 60 ) {
+               if ( round( $seconds * 10 ) < 100 ) {
+                       return $this->formatNum( sprintf( "%.1f", round( $seconds * 10 ) / 10 ) ) . $this->getMessageFromDB( 'seconds-abbrev' );
+               } elseif ( round( $seconds ) < 60 ) {
                        return $this->formatNum( round( $seconds ) ) . $this->getMessageFromDB( 'seconds-abbrev' );
-               } elseif ( $seconds < 3600 ) {
+               } elseif ( round( $seconds ) < 3600 ) {
                        $minutes = floor( $seconds / 60 );
                        $secondsPart = round( fmod( $seconds, 60 ) );
                        if ( $secondsPart == 60 ) {
@@ -2966,18 +3013,6 @@ class Language {
                return strtoupper( $string );
        }
 
-       /**
-        * Does it make sense for lists to be split up into sections based on their
-        * first letter?  Logogram-based scripts probably want to return false.
-        *
-        * TODO: Use this in CategoryPage.php.
-        *
-        * @return boolean
-        */
-       public function usesFirstLettersInLists() {
-               return true;
-       }
-
        /**
         * Given a string, return the logical "first letter" to be used for
         * grouping on category pages and so on.  This has to be coordinated
@@ -2997,7 +3032,6 @@ class Language {
         * * [[Ape]]
         *
         * etc., assuming for the sake of argument that $wgCapitalLinks is false.
-        * Obviously, this is ignored if usesFirstLettersInLists() is false.
         *
         * @param string $string UTF-8 string
         * @return string UTF-8 string corresponding to the first letter of input