48 private $titleFormatter;
63 $this->language = $langobj;
64 $this->titleFormatter = $titleFormatter ?? MediaWikiServices::getInstance()->getTitleFormatter();
72 return [ $this->language->getCode() => $text ];
79 public function convertTo( $text, $variant,
bool $clearState =
true ) {
84 $mainText = $this->titleFormatter->getText( $title );
86 $index = $title->getNamespace();
88 $nsWithUnderscores = $this->titleFormatter->getNamespaceName( $index, $mainText );
89 }
catch ( InvalidArgumentException $e ) {
91 $nsWithUnderscores = $this->language->getNsText(
NS_SPECIAL );
92 $mainText =
"Badtitle/NS$index:$mainText";
94 $nsText = str_replace(
'_',
' ', $nsWithUnderscores );
96 return [ $nsText,
':', $mainText ];
100 return $this->titleFormatter->getPrefixedText( $title );
104 return $this->language->getFormattedNsText( $index );
108 return [ $this->language->getCode() ];
112 return $this->language->getCode();
116 return $this->language->getCode();
120 return $this->language->getCode();
151 if ( $variant ===
null ) {
154 $variant = strtolower( $variant );
155 return $variant === $this->language->getCode() ? $variant :
null;
170 private function reloadTables() {
178 return $variant && ( $variant === $this->
validateVariant( $variant ) );
182 return htmlspecialchars( $this->
convert( $text ) );
Base class for language-specific code.
A trivial language converter.
convertHtml( $text)
Perform output conversion on a string, and encode for safe HTML output.
translate( $text, $variant)
Translate a string to a variant.
hasVariants()
Check if this is a language with variants.
convert( $t)
Convert text to different variants of a language.
getURLVariant()
Get the variant specified in the URL.
__construct( $langobj, TitleFormatter $titleFormatter=null)
Creates a converter for languages that don't have variants.
getPreferredVariant()
Get preferred language variant.
markNoConversion( $text, $noParse=false)
Enclose a string with the "no conversion" tag.
autoConvertToAllVariants( $text)
Call translate() to convert text to all valid variants.
getConvRuleTitle()
Get the title produced by the conversion rule.
convertSplitTitle( $title)
Automatically converts a LinkTarget or PageReference to a readable string in the preferred variant,...
getDefaultVariant()
This function would not be affected by user's settings.
findVariantLink(&$l, &$n, $ignoreOtherCond=false)
If a language supports multiple variants, it is possible that non-existing link in one variant actual...
autoConvert( $text, $variant=false)
Dictionary-based conversion.
getExtraHashOptions()
Returns language specific hash options.
guessVariant( $text, $variant)
Guess if a text is written in a variant.
updateConversionTable(LinkTarget $linkTarget)
Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.
convertTo( $text, $variant, bool $clearState=true)
Same as convert() except a extra parameter to custom variant.
validateVariant( $variant=null)
Validate the variant and return an appropriate strict internal variant code if one exists.
convertTitle( $title)
Automatically convert a LinkTarget or PageReference to a readable string in the preferred variant.
convertCategoryKey( $key)
Convert the sorting key for category links.
getVariants()
Get all valid variants.
convertNamespace( $index, $variant=null)
Get the namespace display name in the preferred variant.
hasVariant( $variant)
Strict check if the language has the specific variant.
getVariantFallbacks( $variant)
In case some variant is not defined in the markup, we need to have some fallback.
The shared interface for all language converters.