MediaWiki master
TrivialLanguageConverter Class Reference

A trivial language converter. More...

Inherits ILanguageConverter.

Collaboration diagram for TrivialLanguageConverter:

Public Member Functions

 __construct ( $langobj, TitleFormatter $titleFormatter=null)
 Creates a converter for languages that don't have variants.
 
 autoConvert ( $text, $variant=false)
 Dictionary-based conversion.
 
 autoConvertToAllVariants ( $text)
 Call translate() to convert text to all valid variants.
 
 convert ( $t)
 Convert text to different variants of a language.
 
 convertCategoryKey ( $key)
 Convert the sorting key for category links.
 
 convertHtml ( $text)
 Perform output conversion on a string, and encode for safe HTML output.
 
 convertNamespace ( $index, $variant=null)
 Get the namespace display name in the preferred variant.
 
 convertSplitTitle ( $title)
 Automatically converts a LinkTarget or PageReference to a readable string in the preferred variant, separating the namespace and the main part of the title.
 
 convertTitle ( $title)
 Automatically convert a LinkTarget or PageReference to a readable string in the preferred variant.
 
 convertTo ( $text, $variant, bool $clearState=true)
 Same as convert() except a extra parameter to custom variant.
 
 findVariantLink (&$l, &$n, $ignoreOtherCond=false)
 If a language supports multiple variants, it is possible that non-existing link in one variant actually exists in another variant.
 
 getConvRuleTitle ()
 Get the title produced by the conversion rule.
 
 getDefaultVariant ()
 This function would not be affected by user's settings.
 
 getExtraHashOptions ()
 Returns language specific hash options.
 
 getPreferredVariant ()
 Get preferred language variant.
 
 getURLVariant ()
 Get the variant specified in the URL.
 
 getVariantFallbacks ( $variant)
 In case some variant is not defined in the markup, we need to have some fallback.
 
 getVariants ()
 Get all valid variants.
 
 guessVariant ( $text, $variant)
 Guess if a text is written in a variant.
 
 hasVariant ( $variant)
 Strict check if the language has the specific variant.
 
 hasVariants ()
 Check if this is a language with variants.
 
 markNoConversion ( $text, $noParse=false)
 Enclose a string with the "no conversion" tag.
 
 translate ( $text, $variant)
 Translate a string to a variant.
 
 updateConversionTable (LinkTarget $linkTarget)
 Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.
 
 validateVariant ( $variant=null)
 Validate the variant and return an appropriate strict internal variant code if one exists.
 

Protected Attributes

Language $language
 

Detailed Description

A trivial language converter.

For Languages which do not implement variant conversion, for example, German, TrivialLanguageConverter is provided rather than a LanguageConverter when asked for their converter. The TrivialLanguageConverter just returns text unchanged, i.e., it doesn't do any conversion.

See https://www.mediawiki.org/wiki/Writing_systems#LanguageConverter.

Since
1.35

Definition at line 38 of file TrivialLanguageConverter.php.

Constructor & Destructor Documentation

◆ __construct()

TrivialLanguageConverter::__construct (   $langobj,
TitleFormatter  $titleFormatter = null 
)

Creates a converter for languages that don't have variants.

This method is internal and should be called for LanguageConverterFactory only

Parameters
Language | StubUserLang$langobj
TitleFormatter | null$titleFormatter
Access: internal

Definition at line 59 of file TrivialLanguageConverter.php.

Member Function Documentation

◆ autoConvert()

TrivialLanguageConverter::autoConvert (   $text,
  $toVariant = false 
)

Dictionary-based conversion.

This function would not parse the conversion rules. If you want to parse rules, try to use convert() or convertTo().

Parameters
string$textThe text to be converted
string | false$toVariantThe target language code
Returns
string The converted text

Implements ILanguageConverter.

Definition at line 67 of file TrivialLanguageConverter.php.

◆ autoConvertToAllVariants()

TrivialLanguageConverter::autoConvertToAllVariants (   $text)

Call translate() to convert text to all valid variants.

Parameters
string$textThe text to be converted
Returns
array Variant => converted text

Implements ILanguageConverter.

Definition at line 71 of file TrivialLanguageConverter.php.

◆ convert()

TrivialLanguageConverter::convert (   $text)

Convert text to different variants of a language.

The automatic conversion is done in autoConvert(). Here we parse the text marked with -{}-, which specifies special conversions of the text that cannot be accomplished in autoConvert().

Syntax of the markup: -{code1:text1;code2:text2;...}- or -{flags|code1:text1;code2:text2;...}- or -{text}- in which case no conversion should take place for text

Warning
Glossary state is maintained between calls. Never feed this method input that hasn't properly been escaped as it may result in an XSS in subsequent calls, even if those subsequent calls properly escape things.
Parameters
string$textText to be converted; already html escaped.
Returns
string Converted text (html)

Implements ILanguageConverter.

Definition at line 75 of file TrivialLanguageConverter.php.

Referenced by convertHtml().

◆ convertCategoryKey()

TrivialLanguageConverter::convertCategoryKey (   $key)

Convert the sorting key for category links.

This should make different keys that are variants of each other map to the same key.

Parameters
string$key
Returns
string

Implements ILanguageConverter.

Definition at line 146 of file TrivialLanguageConverter.php.

◆ convertHtml()

TrivialLanguageConverter::convertHtml (   $text)

Perform output conversion on a string, and encode for safe HTML output.

Since
1.35
Parameters
string$textText to be converted
Returns
string string converted to be safely used in HTML

Implements ILanguageConverter.

Definition at line 181 of file TrivialLanguageConverter.php.

References convert().

◆ convertNamespace()

TrivialLanguageConverter::convertNamespace (   $index,
  $variant = null 
)

Get the namespace display name in the preferred variant.

Parameters
int$indexNamespace id
string | null$variantVariant code or null for preferred variant
Returns
string Namespace name for display

Implements ILanguageConverter.

Definition at line 103 of file TrivialLanguageConverter.php.

◆ convertSplitTitle()

TrivialLanguageConverter::convertSplitTitle (   $title)

Automatically converts a LinkTarget or PageReference to a readable string in the preferred variant, separating the namespace and the main part of the title.

Since
1.39
Parameters
LinkTarget | PageReference$title
Returns
string[] Three elements: converted namespace text, converted namespace separator, and the converted main part of the title

Implements ILanguageConverter.

Definition at line 83 of file TrivialLanguageConverter.php.

References NS_SPECIAL.

◆ convertTitle()

TrivialLanguageConverter::convertTitle (   $title)

Automatically convert a LinkTarget or PageReference to a readable string in the preferred variant.

Parameters
LinkTarget | PageReference$title
Returns
string Converted title text

Implements ILanguageConverter.

Definition at line 99 of file TrivialLanguageConverter.php.

◆ convertTo()

TrivialLanguageConverter::convertTo (   $text,
  $variant,
bool  $clearState = true 
)

Same as convert() except a extra parameter to custom variant.

Parameters
string$textText to be converted; already html escaped
string$variantThe target variant code
bool$clearStateWhether to clear the converter title before conversion (defaults to true)
Returns
string Converted text

Implements ILanguageConverter.

Definition at line 79 of file TrivialLanguageConverter.php.

◆ findVariantLink()

TrivialLanguageConverter::findVariantLink ( $link,
$nt,
  $ignoreOtherCond = false 
)

If a language supports multiple variants, it is possible that non-existing link in one variant actually exists in another variant.

This function tries to find it. See e.g., LanguageZh.php The input parameters may be modified upon return

Parameters
string&$linkThe name of the link
Title&$ntThe title object of the link
bool$ignoreOtherCondTo disable other conditions when we need to transclude a template or update a category's link

Implements ILanguageConverter.

Definition at line 131 of file TrivialLanguageConverter.php.

◆ getConvRuleTitle()

TrivialLanguageConverter::getConvRuleTitle ( )

Get the title produced by the conversion rule.

Returns
string|false The converted title text

Implements ILanguageConverter.

Definition at line 127 of file TrivialLanguageConverter.php.

◆ getDefaultVariant()

TrivialLanguageConverter::getDefaultVariant ( )

This function would not be affected by user's settings.

Returns
string The default variant code

Implements ILanguageConverter.

Definition at line 119 of file TrivialLanguageConverter.php.

◆ getExtraHashOptions()

TrivialLanguageConverter::getExtraHashOptions ( )

Returns language specific hash options.

Returns
string

Implements ILanguageConverter.

Definition at line 134 of file TrivialLanguageConverter.php.

◆ getPreferredVariant()

TrivialLanguageConverter::getPreferredVariant ( )

Get preferred language variant.

Returns
string The preferred language code

Implements ILanguageConverter.

Definition at line 115 of file TrivialLanguageConverter.php.

◆ getURLVariant()

TrivialLanguageConverter::getURLVariant ( )

Get the variant specified in the URL.

Returns
string|null Variant if one found, null otherwise

Implements ILanguageConverter.

Definition at line 123 of file TrivialLanguageConverter.php.

◆ getVariantFallbacks()

TrivialLanguageConverter::getVariantFallbacks (   $variant)

In case some variant is not defined in the markup, we need to have some fallback.

For example, in zh, normally people will define zh-hans and zh-hant, but less so for zh-sg or zh-hk.

When zh-sg is preferred but not defined, we will pick zh-hans in this case. Right now this is only used by zh.

Parameters
string$variantThe language code of the variant
Returns
string|array The code of the fallback language or the main code if there is no fallback

Implements ILanguageConverter.

Definition at line 111 of file TrivialLanguageConverter.php.

◆ getVariants()

TrivialLanguageConverter::getVariants ( )

Get all valid variants.

Returns
string[] Contains all valid variants

Implements ILanguageConverter.

Definition at line 107 of file TrivialLanguageConverter.php.

Referenced by hasVariants().

◆ guessVariant()

TrivialLanguageConverter::guessVariant (   $text,
  $variant 
)

Guess if a text is written in a variant.

This should be implemented in subclasses.

Parameters
string$textThe text to be checked
string$variantLanguage code of the variant to be checked for
Returns
bool True if $text appears to be written in $variant, false if not
Author
Nikola Smolenski smole.nosp@m.nsk@.nosp@m.eunet.nosp@m..rs
Since
1.19

Implements ILanguageConverter.

Definition at line 138 of file TrivialLanguageConverter.php.

◆ hasVariant()

TrivialLanguageConverter::hasVariant (   $variant)

Strict check if the language has the specific variant.

Compare to LanguageConverter::validateVariant() which does a more lenient check and attempts to coerce the given code to a valid one.

Since
1.35
Parameters
string$variant
Returns
bool

Implements ILanguageConverter.

Definition at line 177 of file TrivialLanguageConverter.php.

References validateVariant().

◆ hasVariants()

TrivialLanguageConverter::hasVariants ( )

Check if this is a language with variants.

Since
1.35
Returns
bool

Implements ILanguageConverter.

Definition at line 173 of file TrivialLanguageConverter.php.

References getVariants().

◆ markNoConversion()

TrivialLanguageConverter::markNoConversion (   $text,
  $noParse = false 
)

Enclose a string with the "no conversion" tag.

This is used by various functions in the Parser.

Parameters
string$textText to be tagged for no conversion
bool$noParseUnused
Returns
string The tagged text

Implements ILanguageConverter.

Definition at line 142 of file TrivialLanguageConverter.php.

◆ translate()

TrivialLanguageConverter::translate (   $text,
  $variant 
)

Translate a string to a variant.

Doesn't parse rules or do any of that other stuff, for that use convert() or convertTo().

Parameters
string$textText to convert
string$variantVariant language code
Returns
string Translated text

Implements ILanguageConverter.

Definition at line 158 of file TrivialLanguageConverter.php.

◆ updateConversionTable()

TrivialLanguageConverter::updateConversionTable ( LinkTarget  $linkTarget)

Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.

Parameters
LinkTarget$linkTargetThe LinkTarget of the page being updated

Implements ILanguageConverter.

Definition at line 162 of file TrivialLanguageConverter.php.

◆ validateVariant()

TrivialLanguageConverter::validateVariant (   $variant = null)

Validate the variant and return an appropriate strict internal variant code if one exists.

Compare to Language::hasVariant() which does a strict test.

Parameters
string | null$variantThe variant to validate
Returns
string|null Returns an equivalent valid variant code if possible, null otherwise

Implements ILanguageConverter.

Definition at line 150 of file TrivialLanguageConverter.php.

Referenced by hasVariant().

Member Data Documentation

◆ $language

Language TrivialLanguageConverter::$language
protected

Definition at line 43 of file TrivialLanguageConverter.php.


The documentation for this class was generated from the following file: