MediaWiki
master
ILanguageConverter.php
Go to the documentation of this file.
1
<?php
7
namespace
MediaWiki\Language
;
8
9
use
MediaWiki\Linker\LinkTarget
;
10
use
MediaWiki\Page\PageIdentity
;
11
use
MediaWiki\Page\PageReference
;
12
use
MediaWiki\Title\Title
;
13
20
interface
ILanguageConverter
{
21
27
public
function
getVariants
();
28
41
public
function
getVariantFallbacks
( $variant );
42
48
public
function
getConvRuleTitle
();
49
55
public
function
getPreferredVariant
();
56
62
public
function
getDefaultVariant
();
63
73
public
function
validateVariant
( $variant =
null
);
74
80
public
function
getURLVariant
();
81
92
public
function
autoConvert
( $text, $toVariant =
false
);
93
103
public
function
translate
( $text, $variant );
104
111
public
function
autoConvertToAllVariants
( $text );
112
122
public
function
convertSplitTitle
( $title );
123
131
public
function
convertTitle
( $title );
132
140
public
function
convertNamespace
( $index, $variant =
null
);
141
160
public
function
convert
( $text );
161
173
public
function
convertTo
( $text, $variant,
bool
$clearState =
true
);
174
186
public
function
findVariantLink
( &$link, &$nt, $ignoreOtherCond =
false
);
187
193
public
function
getExtraHashOptions
();
194
205
public
function
guessVariant
( $text, $variant );
206
215
public
function
markNoConversion
( $text, $noParse =
false
);
216
225
public
function
convertCategoryKey
( $key );
226
233
public
function
updateConversionTable
(
PageIdentity
$page );
234
242
public
function
hasVariants
();
243
254
public
function
hasVariant
( $variant );
255
264
public
function
convertHtml
( $text );
265
}
266
268
class_alias( ILanguageConverter::class,
'ILanguageConverter'
);
MediaWiki\Title\Title
Represents a title within MediaWiki.
Definition
Title.php:69
MediaWiki\Language\ILanguageConverter
The shared interface for all language converters.
Definition
ILanguageConverter.php:20
MediaWiki\Language\ILanguageConverter\convertHtml
convertHtml( $text)
Perform output conversion on a string, and encode for safe HTML output.
MediaWiki\Language\ILanguageConverter\getExtraHashOptions
getExtraHashOptions()
Returns language specific hash options.
MediaWiki\Language\ILanguageConverter\updateConversionTable
updateConversionTable(PageIdentity $page)
Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.
MediaWiki\Language\ILanguageConverter\hasVariant
hasVariant( $variant)
Strict check if the language has the specific variant.
MediaWiki\Language\ILanguageConverter\getConvRuleTitle
getConvRuleTitle()
Get the title produced by the conversion rule.
MediaWiki\Language\ILanguageConverter\getURLVariant
getURLVariant()
Get the variant specified in the URL.
MediaWiki\Language\ILanguageConverter\convertCategoryKey
convertCategoryKey( $key)
Convert the sorting key for category links.
MediaWiki\Language\ILanguageConverter\hasVariants
hasVariants()
Check if this is a language with variants.
MediaWiki\Language\ILanguageConverter\translate
translate( $text, $variant)
Translate a string to a variant.
MediaWiki\Language\ILanguageConverter\autoConvertToAllVariants
autoConvertToAllVariants( $text)
Call translate() to convert text to all valid variants.
MediaWiki\Language\ILanguageConverter\convert
convert( $text)
Convert text to different variants of a language.
MediaWiki\Language\ILanguageConverter\validateVariant
validateVariant( $variant=null)
Validate the variant and return an appropriate strict internal variant code if one exists.
MediaWiki\Language\ILanguageConverter\convertSplitTitle
convertSplitTitle( $title)
Automatically converts a LinkTarget or PageReference to a readable string in the preferred variant,...
MediaWiki\Language\ILanguageConverter\getPreferredVariant
getPreferredVariant()
Get preferred language variant.
MediaWiki\Language\ILanguageConverter\convertTitle
convertTitle( $title)
Automatically convert a LinkTarget or PageReference to a readable string in the preferred variant.
MediaWiki\Language\ILanguageConverter\autoConvert
autoConvert( $text, $toVariant=false)
Dictionary-based conversion.
MediaWiki\Language\ILanguageConverter\convertTo
convertTo( $text, $variant, bool $clearState=true)
Same as convert() except a extra parameter to custom variant.
MediaWiki\Language\ILanguageConverter\getVariantFallbacks
getVariantFallbacks( $variant)
In case some variant is not defined in the markup, we need to have some fallback.
MediaWiki\Language\ILanguageConverter\guessVariant
guessVariant( $text, $variant)
Guess if a text is written in a variant.
MediaWiki\Language\ILanguageConverter\getDefaultVariant
getDefaultVariant()
This function would not be affected by user's settings.
MediaWiki\Language\ILanguageConverter\getVariants
getVariants()
Get all valid variants.
MediaWiki\Language\ILanguageConverter\findVariantLink
findVariantLink(&$link, &$nt, $ignoreOtherCond=false)
If a language supports multiple variants, it is possible that non-existing link in one variant actual...
MediaWiki\Language\ILanguageConverter\convertNamespace
convertNamespace( $index, $variant=null)
Get the namespace display name in the preferred variant.
MediaWiki\Language\ILanguageConverter\markNoConversion
markNoConversion( $text, $noParse=false)
Enclose a string with the "no conversion" tag.
MediaWiki\Linker\LinkTarget
Represents the target of a wiki link.
Definition
LinkTarget.php:19
MediaWiki\Page\PageIdentity
Interface for objects (potentially) representing an editable wiki page.
Definition
PageIdentity.php:53
MediaWiki\Page\PageReference
Interface for objects (potentially) representing a page that can be viewable and linked to on a wiki.
Definition
PageReference.php:38
MediaWiki\Language
Definition
ConverterRule.php:8
includes
Language
ILanguageConverter.php
Generated on Fri Jan 23 2026 17:26:11 for MediaWiki by
1.10.0