A trivial language converter. More...

Inheritance diagram for TrivialLanguageConverter:

Collaboration diagram for TrivialLanguageConverter:

[legend]

Public Member Functions
	__construct ( $langobj)

	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.

	convertTitle (LinkTarget $linkTarget)

	convertTo ( $text, $variant)
	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 ()
	Get default variant.

	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

Private Member Functions
	reloadTables ()
	Used by test suites which need to reset the converter state.

Private Attributes
TitleFormatter	$titleFormatter

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 36 of file TrivialLanguageConverter.php.

Constructor & Destructor Documentation

◆ __construct()

TrivialLanguageConverter::__construct ( $langobj )

Definition at line 48 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
bool \| string	$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

string	$text	Text to be converted, already html escaped
-taint	$text	exec_html
string	$variant	The target variant code

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

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ autoConvert()

◆ autoConvertToAllVariants()

◆ convert()

◆ convertCategoryKey()

◆ convertHtml()

◆ convertNamespace()

◆ convertTitle()

◆ convertTo()

◆ findVariantLink()

◆ getConvRuleTitle()

◆ getDefaultVariant()

◆ getExtraHashOptions()

◆ getPreferredVariant()

◆ getURLVariant()

◆ getVariantFallbacks()

◆ getVariants()

◆ guessVariant()

◆ hasVariant()

◆ hasVariants()

◆ markNoConversion()

◆ reloadTables()

◆ translate()

◆ updateConversionTable()

◆ validateVariant()

Member Data Documentation

◆ $language

◆ $titleFormatter