X-Git-Url: https://git.cyclocoop.org/?a=blobdiff_plain;f=languages%2FLanguageConverter.php;h=18d1dbc0be66ef18a5cf875a49f26abd39f19250;hb=ef9534313eeaf096c647fb5bebfaf7248d44cd73;hp=8807f44934c9b64d7e7ae248e53219bae3e276db;hpb=0327a95ea12532ef1537316163ad2f50027cdc44;p=lhc%2Fweb%2Fwiklou.git diff --git a/languages/LanguageConverter.php b/languages/LanguageConverter.php index 8807f44934..18d1dbc0be 100644 --- a/languages/LanguageConverter.php +++ b/languages/LanguageConverter.php @@ -72,7 +72,7 @@ class LanguageConverter { $this->mMainLanguageCode = $maincode; $this->mVariants = array_diff( $variants, $wgDisabledVariants ); $this->mVariantFallbacks = $variantfallbacks; - $this->mVariantNames = Language::getLanguageNames(); + $this->mVariantNames = Language::fetchLanguageNames(); $this->mCacheKey = wfMemcKey( 'conversiontables', $maincode ); $defaultflags = array( // 'S' show converted text @@ -117,7 +117,7 @@ class LanguageConverter { * in this case. Right now this is only used by zh. * * @param $variant String: the language code of the variant - * @return String: The code of the fallback language or the + * @return String|array: The code of the fallback language or the * main code if there is no fallback */ public function getVariantFallbacks( $variant ) { @@ -158,7 +158,7 @@ class LanguageConverter { // not memoized (i.e. there return value is not cached) since // new information might appear during processing after this // is first called. - if ( $req ) { + if ( $this->validateVariant( $req ) ) { return $req; } return $this->mMainLanguageCode; @@ -189,7 +189,7 @@ class LanguageConverter { * @param $variant String: the variant to validate * @return Mixed: returns the variant if it is valid, null otherwise */ - protected function validateVariant( $variant = null ) { + public function validateVariant( $variant = null ) { if ( $variant !== null && in_array( $variant, $this->mVariants ) ) { return $variant; } @@ -305,9 +305,9 @@ class LanguageConverter { * If you want to parse rules, try to use convert() or * convertTo(). * - * @param $text String: the text to be converted - * @param $toVariant String: the target language code - * @return String: the converted text + * @param $text String the text to be converted + * @param $toVariant bool|string the target language code + * @return String the converted text */ public function autoConvert( $text, $toVariant = false ) { wfProfileIn( __METHOD__ ); @@ -323,6 +323,7 @@ class LanguageConverter { } if( $this->guessVariant( $text, $toVariant ) ) { + wfProfileOut( __METHOD__ ); return $text; } @@ -372,11 +373,11 @@ class LanguageConverter { $sourceBlob .= substr( $text, $startPos, $elementPos - $startPos ) . "\000"; // Advance to the next position - $startPos = $elementPos + strlen( $element ); + $startPos = $elementPos + strlen( $element ); // Translate any alt or title attributes inside the matched element - if ( $element !== '' && preg_match( '/^(<[^>\s]*)\s([^>]*)(.*)$/', $element, - $elementMatches ) ) + if ( $element !== '' && preg_match( '/^(<[^>\s]*)\s([^>]*)(.*)$/', $element, + $elementMatches ) ) { $attrs = Sanitizer::decodeTagAttributes( $elementMatches[2] ); $changed = false; @@ -389,7 +390,7 @@ class LanguageConverter { if ( !strpos( $attr, '://' ) ) { $attr = $this->translate( $attr, $toVariant ); } - + // Remove HTML tags to avoid disrupting the layout $attr = preg_replace( '/<[^>]+>/', '', $attr ); if ( $attr !== $attrs[$attrName] ) { @@ -398,7 +399,7 @@ class LanguageConverter { } } if ( $changed ) { - $element = $elementMatches[1] . Html::expandAttributes( $attrs ) . + $element = $elementMatches[1] . Html::expandAttributes( $attrs ) . $elementMatches[3]; } } @@ -472,7 +473,7 @@ class LanguageConverter { * * @param $text String: the text to be converted * @return Array: variant => converted text - * @deprecated Use autoConvertToAllVariants() instead + * @deprecated since 1.17 Use autoConvertToAllVariants() instead */ public function convertLinkToAllVariants( $text ) { return $this->autoConvertToAllVariants( $text ); @@ -481,7 +482,7 @@ class LanguageConverter { /** * Apply manual conversion rules. * - * @param $convRule Object: Object of ConverterRule + * @param $convRule ConverterRule Object of ConverterRule */ protected function applyManualConv( $convRule ) { // Use syntax -{T|zh-cn:TitleCN; zh-tw:TitleTw}- to custom @@ -521,7 +522,7 @@ class LanguageConverter { * Auto convert a Title object to a readable string in the * preferred variant. * - * @param $title Object: a object of Title + * @param $title Title a object of Title * @return String: converted title text */ public function convertTitle( $title ) { @@ -531,9 +532,9 @@ class LanguageConverter { $text = ''; } else { // first let's check if a message has given us a converted name - $nsConvKey = 'conversion-ns' . $index; - if ( !wfEmptyMsg( $nsConvKey ) ) { - $text = wfMsgForContentNoTrans( $nsConvKey ); + $nsConvMsg = wfMessage( 'conversion-ns' . $index )->inContentLanguage(); + if ( $nsConvMsg->exists() ) { + $text = $nsConvMsg->plain(); } else { // the message does not exist, try retrieve it from the current // variant's namespace names. @@ -575,7 +576,7 @@ class LanguageConverter { */ public function convertTo( $text, $variant ) { global $wgDisableLangConversion; - if ( $wgDisableLangConversion || $this->guessVariant( $text, $variant ) ) { + if ( $wgDisableLangConversion ) { return $text; } return $this->recursiveConvertTopLevel( $text, $variant ); @@ -594,18 +595,22 @@ class LanguageConverter { $startPos = 0; $out = ''; $length = strlen( $text ); + $shouldConvert = !$this->guessVariant( $text, $variant ); + while ( $startPos < $length ) { $pos = strpos( $text, '-{', $startPos ); if ( $pos === false ) { // No more markup, append final segment - $out .= $this->autoConvert( substr( $text, $startPos ), $variant ); + $fragment = substr( $text, $startPos ); + $out .= $shouldConvert? $this->autoConvert( $fragment, $variant ): $fragment; return $out; } // Markup found // Append initial segment - $out .= $this->autoConvert( substr( $text, $startPos, $pos - $startPos ), $variant ); + $fragment = substr( $text, $startPos, $pos - $startPos ); + $out .= $shouldConvert? $this->autoConvert( $fragment, $variant ): $fragment; // Advance position $startPos = $pos; @@ -622,7 +627,10 @@ class LanguageConverter { * * @param $text String: text to be converted * @param $variant String: the target variant code + * @param $startPos int * @param $depth Integer: depth of recursion + * + * @throws MWException * @return String: converted text */ protected function recursiveConvertRule( $text, $variant, &$startPos, $depth = 0 ) { @@ -766,6 +774,8 @@ class LanguageConverter { /** * Returns language specific hash options. + * + * @return string */ public function getExtraHashOptions() { $variant = $this->getPreferredVariant(); @@ -780,7 +790,7 @@ class LanguageConverter { * @return bool true if $text appears to be written in $variant, false if not * * @author Nikola Smolenski - * @since 1.18 + * @since 1.19 */ public function guessVariant($text, $variant) { return false; @@ -791,10 +801,11 @@ class LanguageConverter { * This method must be implemented in derived class. * * @private + * @throws MWException */ function loadDefaultTables() { $name = get_class( $this ); - wfDie( "Must implement loadDefaultTables() method in class $name" ); + throw new MWException( "Must implement loadDefaultTables() method in class $name" ); } /** @@ -803,16 +814,18 @@ class LanguageConverter { * @param $fromCache Boolean: load from memcached? Defaults to true. */ function loadTables( $fromCache = true ) { + global $wgLangConvMemc; + if ( $this->mTablesLoaded ) { return; } - global $wgMemc; + wfProfileIn( __METHOD__ ); $this->mTablesLoaded = true; $this->mTables = false; if ( $fromCache ) { wfProfileIn( __METHOD__ . '-cache' ); - $this->mTables = $wgMemc->get( $this->mCacheKey ); + $this->mTables = $wgLangConvMemc->get( $this->mCacheKey ); wfProfileOut( __METHOD__ . '-cache' ); } if ( !$this->mTables @@ -830,7 +843,7 @@ class LanguageConverter { $this->postLoadTables(); $this->mTables[self::CACHE_VERSION_KEY] = true; - $wgMemc->set( $this->mCacheKey, $this->mTables, 43200 ); + $wgLangConvMemc->set( $this->mCacheKey, $this->mTables, 43200 ); wfProfileOut( __METHOD__ . '-recache' ); } wfProfileOut( __METHOD__ ); @@ -870,6 +883,8 @@ class LanguageConverter { * @param $code String: language code * @param $subpage String: subpage name * @param $recursive Boolean: parse subpages recursively? Defaults to true. + * + * @return array */ function parseCachedTable( $code, $subpage = '', $recursive = true ) { static $parsed = array(); @@ -882,26 +897,26 @@ class LanguageConverter { return array(); } - if ( strpos( $code, '/' ) === false ) { - $txt = MessageCache::singleton()->get( 'Conversiontable', true, $code ); - if ( $txt === false ) { - # FIXME: this method doesn't seem to be expecting - # this possible outcome... - $txt = '<Conversiontable>'; - } + $parsed[$key] = true; + + if ( $subpage === '' ) { + $txt = MessageCache::singleton()->get( 'conversiontable', true, $code ); } else { - $title = Title::makeTitleSafe( - NS_MEDIAWIKI, - "Conversiontable/$code" - ); + $txt = false; + $title = Title::makeTitleSafe( NS_MEDIAWIKI, $key ); if ( $title && $title->exists() ) { - $article = new Article( $title ); - $txt = $article->getContents(); - } else { - $txt = ''; + $revision = Revision::newFromTitle( $title ); + if ( $revision ) { + $txt = $revision->getRawText(); + } } } + # Nothing to parse if there's no text + if ( $txt === false || $txt === null || $txt === '' ) { + return array(); + } + // get all subpage links of the form // [[MediaWiki:Conversiontable/zh-xx/...|...]] $linkhead = $this->mLangObj->getNsText( NS_MEDIAWIKI ) . @@ -950,7 +965,6 @@ class LanguageConverter { $ret[trim( $m[0] )] = trim( $tt[0] ); } } - $parsed[$key] = true; // recursively parse the subpages if ( $recursive ) { @@ -989,6 +1003,10 @@ class LanguageConverter { /** * Convert the sorting key for category links. This should make different * keys that are variants of each other map to the same key. + * + * @param $key string + * + * @return string */ function convertCategoryKey( $key ) { return $key; @@ -999,14 +1017,14 @@ class LanguageConverter { * MediaWiki:Conversiontable* is updated. * @private * - * @param $article Object: Article object + * @param $article Article object * @param $user Object: User object for the current user * @param $text String: article text (?) * @param $summary String: edit summary of the edit * @param $isMinor Boolean: was the edit marked as minor? * @param $isWatch Boolean: did the user watch this page or not? - * @param $section Unused - * @param $flags Bitfield + * @param $section + * @param $flags int Bitfield * @param $revision Object: new Revision object or null * @return Boolean: true */ @@ -1233,6 +1251,8 @@ class ConverterRule { /** * @private + * + * @return string */ function getRulesDesc() { $codesep = $this->mConverter->mDescCodeSep; @@ -1253,6 +1273,10 @@ class ConverterRule { /** * Parse rules conversion. * @private + * + * @param $variant + * + * @return string */ function getRuleConvertedStr( $variant ) { $bidtable = $this->mBidtable; @@ -1366,19 +1390,21 @@ class ConverterRule { if ( isset( $this->mVariantFlags[$variant] ) ) { // then convert to current language $this->mRules = $this->mConverter->autoConvert( $this->mRules, - $variant ); + $variant ); } else { // if current variant no in flags, // then we check its fallback variants. $variantFallbacks = $this->mConverter->getVariantFallbacks( $variant ); - foreach ( $variantFallbacks as $variantFallback ) { - // if current variant's fallback exist in flags - if ( isset( $this->mVariantFlags[$variantFallback] ) ) { - // then convert to fallback language - $this->mRules = - $this->mConverter->autoConvert( $this->mRules, - $variantFallback ); - break; + if( is_array( $variantFallbacks ) ) { + foreach ( $variantFallbacks as $variantFallback ) { + // if current variant's fallback exist in flags + if ( isset( $this->mVariantFlags[$variantFallback] ) ) { + // then convert to fallback language + $this->mRules = + $this->mConverter->autoConvert( $this->mRules, + $variantFallback ); + break; + } } } } @@ -1462,6 +1488,7 @@ class ConverterRule { /** * Get display text on markup -{...}- + * @return string */ public function getDisplay() { return $this->mRuleDisplay; @@ -1469,6 +1496,7 @@ class ConverterRule { /** * Get converted title. + * @return string */ public function getTitle() { return $this->mRuleTitle; @@ -1476,6 +1504,7 @@ class ConverterRule { /** * Return how deal with conversion rules. + * @return string */ public function getRulesAction() { return $this->mRulesAction; @@ -1484,6 +1513,7 @@ class ConverterRule { /** * Get conversion table. (bidirectional and unidirectional * conversion table) + * @return array */ public function getConvTable() { return $this->mConvTable; @@ -1491,6 +1521,7 @@ class ConverterRule { /** * Get conversion rules string. + * @return string */ public function getRules() { return $this->mRules; @@ -1498,6 +1529,7 @@ class ConverterRule { /** * Get conversion flags. + * @return array */ public function getFlags() { return $this->mFlags;