A trivial language converter. More...

Collaboration diagram for TrivialLanguageConverter:

[legend]

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)

	convertTitle ( $title)

	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 ()

	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	$text	The text to be converted
string \| false	$toVariant	The target language code

Returns: string The converted text

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

int	$index	Namespace id
string \| null	$variant	Variant code or null for preferred variant

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

string	$text	Text to be converted, already html escaped
-taint	$text	exec_html
string	$variant	The target variant code
bool	$clearState	Whether to clear the converter title before conversion (defaults to true)

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

string	&$link	The name of the link
Title	&$nt	The title object of the link
bool	$ignoreOtherCond	To disable other conditions when we need to transclude a template or update a category's link

string	$text	The text to be checked
string	$variant	Language code of the variant to be checked for

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

string	$text	Text to be tagged for no conversion
bool	$noParse	Unused

string	$text	Text to convert
string	$variant	Variant language code

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ autoConvert()

◆ autoConvertToAllVariants()

◆ convert()

◆ convertCategoryKey()

◆ convertHtml()

◆ convertNamespace()

◆ convertSplitTitle()

◆ convertTitle()

◆ convertTo()

◆ findVariantLink()

◆ getConvRuleTitle()

◆ getDefaultVariant()

◆ getExtraHashOptions()

◆ getPreferredVariant()

◆ getURLVariant()

◆ getVariantFallbacks()

◆ getVariants()

◆ guessVariant()

◆ hasVariant()

◆ hasVariants()

◆ markNoConversion()

◆ translate()

◆ updateConversionTable()

◆ validateVariant()

Member Data Documentation

◆ $language