MediaWiki
REL1_19
|
Internationalisation code. More...
Inherited by LanguageAm, LanguageAr, LanguageAz, LanguageBe, LanguageBe_tarask, LanguageBg, LanguageBh, LanguageBs, LanguageCs, LanguageCu, LanguageCy, LanguageDsb, LanguageEo, LanguageEt, LanguageFi, LanguageFr, LanguageGa, LanguageGd, LanguageGv, LanguageHe, LanguageHi, LanguageHr, LanguageHsb, LanguageHu, LanguageHy, LanguageIu, LanguageJa, LanguageKaa, LanguageKk_cyrl, LanguageKm, LanguageKsh, LanguageKu_ku, LanguageLa, LanguageLn, LanguageLt, LanguageLv, LanguageMg, LanguageMk, LanguageMl, LanguageMo, LanguageMt, LanguageMy, LanguageNso, LanguageOs, LanguagePl, LanguageQqx, LanguageRo, LanguageRu, LanguageSe, LanguageSgs, LanguageSh, LanguageShi, LanguageSk, LanguageSl, LanguageSma, LanguageSr_ec, LanguageSr_el, LanguageTg, LanguageTi, LanguageTl, LanguageToTest, LanguageTr, LanguageTyv, LanguageUk, LanguageWa, LanguageYue, and LanguageZh_hans.
Public Member Functions | |
__construct () | |
__destruct () | |
Reduce memory usage. | |
addMagicWordsByLang ($newWords) | |
Add magic words to the extension array. | |
alignEnd () | |
Return 'right' or 'left' as appropriate alignment for line-end for this language's text direction. | |
alignStart () | |
Return 'left' or 'right' as appropriate alignment for line-start for this language's text direction. | |
armourMath ($text) | |
Put custom tags (e.g. | |
autoConvertToAllVariants ($text) | |
convert text to all supported variants | |
capitalizeAllNouns () | |
caseFold ($s) | |
Return a case-folded representation of $s. | |
checkTitleEncoding ($s) | |
commafy ($_) | |
Adds commas to a given number. | |
commaList (array $list) | |
Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message. | |
convert ($text) | |
convert text to different variants of a language. | |
convertCategoryKey ($key) | |
convertForSearchResult ($termsArray) | |
convertGrammar ($word, $case) | |
Grammatical transformations, needed for inflected languages Invoked by putting {{grammar:case|word}} in a message. | |
convertHtml ($text, $isTitle=false) | |
Perform output conversion on a string, and encode for safe HTML output. | |
convertLinkToAllVariants ($text) | |
If a language supports multiple variants, converts text into an array of all possible variants of the text: 'variant' => text in that variant. | |
convertPlural ($count, $forms) | |
Plural form transformations, needed for some languages. | |
convertTitle ($title) | |
Convert a Title object to a string in the preferred variant. | |
date ($ts, $adj=false, $format=true, $timecorrection=false) | |
dateFormat ($usePrefs=true) | |
This is meant to be used by time(), date(), and timeanddate() to get the date preference they're supposed to use, it should be used in all children. | |
digitGroupingPattern () | |
digitTransformTable () | |
emphasize ($text) | |
Italic is unsuitable for some languages. | |
fallback8bitEncoding () | |
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. | |
firstChar ($s) | |
Get the first character of a string. | |
fixVariableInNamespace ($talk) | |
formatBitrate ($bps) | |
Format a bitrate for output, using an appropriate unit (bps, kbps, Mbps, Gbps, Tbps, Pbps, Ebps, Zbps or Ybps) according to the magnitude in question. | |
formatComputingNumbers ($size, $boundary, $messageKey) | |
formatExpiry ($expiry, $format=true) | |
Decode an expiry (block, protection, etc) which has come from the DB. | |
formatNum ($number, $nocommafy=false) | |
Normally we output all numbers in plain en_US style, that is 293,291.235 for twohundredninetythreethousand-twohundredninetyone point twohundredthirtyfive. | |
formatSize ($size) | |
Format a size in bytes for output, using an appropriate unit (B, KB, MB, GB, TB, PB, EB, ZB or YB) according to the magnitude in question. | |
formatTimePeriod ($seconds, $format=array()) | |
gender ($gender, $forms) | |
Provides an alternative text depending on specified gender. | |
getAllMessages () | |
getArrow () | |
An arrow, depending on the language direction. | |
getBookstoreList () | |
Exports $wgBookstoreListEn. | |
getCode () | |
Get the RFC 3066 code for this language object. | |
getConverter () | |
Return the LanguageConverter used in the Language. | |
getConvRuleTitle () | |
Get the conversion rule title, if any. | |
getDateFormats () | |
getDateFormatString ($type, $pref) | |
Get a format string for a given type and preference. | |
getDatePreferenceMigrationMap () | |
getDatePreferences () | |
getDefaultDateFormat () | |
getDefaultVariant () | |
getDir () | |
Return the correct HTML 'dir' attribute value for this language. | |
getDirMark ($opposite=false) | |
A hidden direction mark (LRM or RLM), depending on the language direction. | |
getExtraHashOptions () | |
returns language specific options used by User::getPageRenderHash() for example, the preferred language variant | |
getExtraUserToggles () | |
getFallbackLanguageCode () | |
Same as getFallbacksFor for current language. | |
getFallbackLanguages () | |
getFormattedNamespaces () | |
A convenience function that returns the same thing as getNamespaces() except with the array values changed to ' ' where it found '_', useful for producing output to be displayed e.g. | |
getFormattedNsText ($index) | |
A convenience function that returns the same thing as getNsText() except with '_' changed to ' ', useful for producing output. | |
getGenderNsText ($index, $gender) | |
Returns gender-dependent namespace alias if available. | |
getHebrewCalendarMonthName ($key) | |
getHebrewCalendarMonthNameGen ($key) | |
getHijriCalendarMonthName ($key) | |
getHtmlCode () | |
Get the code in Bcp47 format which we can use inside of html lang="" tags. | |
getImageFile ($image) | |
getIranianCalendarMonthName ($key) | |
getLangObj () | |
getLanguageName ($code) | |
Get the native language name of $code. | |
getLocalNsIndex ($text) | |
Get a namespace key by value, case insensitive. | |
getMagic ($mw) | |
Fill a MagicWord object with data from here. | |
getMagicWords () | |
getMessage ($key) | |
getMessageFromDB ($msg) | |
Get a message from the MediaWiki namespace. | |
getMonthAbbreviation ($key) | |
getMonthAbbreviationsArray () | |
getMonthName ($key) | |
getMonthNameGen ($key) | |
getMonthNamesArray () | |
getNamespaceAliases () | |
getNamespaceIds () | |
getNamespaces () | |
getNsIndex ($text) | |
Get a namespace key by value, case insensitive. | |
getNsText ($index) | |
Get a namespace value by key $mw_ns = $wgContLang->getNsText( NS_MEDIAWIKI ); echo $mw_ns; // prints 'MediaWiki' | |
getParsedTitle () | |
For languages that support multiple variants, the title of an article may be displayed differently in different variants. | |
getPreferredVariant () | |
getQuickbarSettings () | |
getSpecialPageAliases () | |
Get special page names, as an associative array case folded alias => real name. | |
getURLVariant () | |
getUserToggle ($tog) | |
getVariantname ($code, $usemsg=true) | |
short names for language variants used for language conversion links. | |
getVariants () | |
Get the list of variants supported by this language see sample implementation in LanguageZh.php. | |
getWeekdayAbbreviation ($key) | |
getWeekdayName ($key) | |
hasVariant ($variant) | |
Check if the language has the specific variant. | |
hasVariants () | |
Check if this is a language with variants. | |
hasWordBreaks () | |
Most writing systems use whitespace to break up words. | |
iconv ($in, $out, $string) | |
initContLang () | |
Hook which will be called if this is the content language. | |
initEncoding () | |
isMultibyte ($str) | |
isRTL () | |
For right-to-left language support. | |
lc ($str, $first=false) | |
lcCallback ($matches) | |
lcfirst ($str) | |
linkPrefixExtension () | |
To allow "foo[[bar]]" to extend the link over the whole word "foobar". | |
linkTrail () | |
A regular expression to match legal word-trailing characters which should be merged onto a link of the form [[foo]]bar. | |
listToText (array $l) | |
Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message. | |
markNoConversion ($text, $noParse=false) | |
Enclose a string with the "no conversion" tag. | |
needsGenderDistinction () | |
Whether this language makes distinguishes genders for example in namespaces. | |
normalize ($s) | |
Convert a UTF-8 string to normal form C. | |
normalizeForSearch ($string) | |
Some languages have special punctuation need to be normalized. | |
parseFormattedNumber ($number) | |
pipeList (array $list) | |
Same as commaList, but separate it with the pipe instead. | |
recodeForEdit ($s) | |
recodeInput ($s) | |
replaceGrammarInNamespace ($m) | |
segmentByWord ($string) | |
Some languages such as Chinese require word segmentation, Specify such segmentation when overridden in derived class. | |
segmentForDiff ($text) | |
languages like Chinese need to be segmented in order for the diff to be of any use | |
semicolonList (array $list) | |
Take a list of strings and build a locale-friendly semicolon-separated list, using the local semicolon-separator message. | |
separatorTransformTable () | |
setCode ($code) | |
setNamespaces (array $namespaces) | |
Arbitrarily set all of the namespace names at once. | |
specialList ($page, $details, $oppositedm=true) | |
Make a list item, used by various special pages. | |
specialPage ($name) | |
sprintfDate ($format, $ts) | |
This is a workalike of PHP's date() function, but with better internationalisation, a reduced set of format characters, and a better escaping format. | |
time ($ts, $adj=false, $format=true, $timecorrection=false) | |
timeanddate ($ts, $adj=false, $format=true, $timecorrection=false) | |
transformUsingPairFile ($file, $string) | |
Transform a string using serialized data stored in the given file (which must be in the serialized subdirectory of $IP). | |
translateBlockExpiry ($str) | |
truncate ($string, $length, $ellipsis= '...', $adjustLength=true) | |
Truncate a string to a specified length in bytes, appending an optional string (e.g. | |
truncateHtml ($text, $length, $ellipsis= '...') | |
Truncate a string of valid HTML to a specified length in bytes, appending an optional string (e.g. | |
uc ($str, $first=false) | |
Convert a string to uppercase. | |
ucCallback ($matches) | |
ucfirst ($str) | |
Make a string's first character uppercase. | |
ucwordbreaks ($str) | |
capitalize words at word breaks | |
ucwordbreaksCallbackAscii ($matches) | |
ucwordbreaksCallbackMB ($matches) | |
ucwords ($str) | |
ucwordsCallbackMB ($matches) | |
ucwordsCallbackWiki ($matches) | |
unsegmentForDiff ($text) | |
and unsegment to show the result | |
userAdjust ($ts, $tz=false) | |
Used by date() and time() to adjust the time output. | |
userDate ($ts, User $user, array $options=array()) | |
Get the formatted date for the given timestamp and formatted for the given user. | |
userTime ($ts, User $user, array $options=array()) | |
Get the formatted time for the given timestamp and formatted for the given user. | |
userTimeAndDate ($ts, User $user, array $options=array()) | |
Get the formatted date and time for the given timestamp and formatted for the given user. | |
viewPrevNext (Title $title, $offset, $limit, array $query=array(), $atend=false) | |
Generate (prev x| next x) (20|50|100...) type links for paging. | |
Static Public Member Functions | |
static | classFromCode ($code) |
static | factory ($code) |
Get a cached language object for a given language code. | |
static | getCaseMaps () |
static | getClassFileName ($code) |
static | getCodeFromFileName ($filename, $prefix= 'Language', $suffix= '.php') |
Get the language code from a file name. | |
static | getFallbackFor ($code) |
Get the first fallback for a given language. | |
static | getFallbacksFor ($code) |
Get the ordered list of fallback languages. | |
static | getFileName ($prefix= 'Language', $code, $suffix= '.php') |
Get the name of a file for a certain language code. | |
static | getLanguageNames ($customisedOnly=false) |
Get native language names, indexed by code. | |
static | getLocalisationCache () |
Get the LocalisationCache instance. | |
static | getMessageFor ($key, $code) |
Get a message for a given language. | |
static | getMessageKeysFor ($code) |
Get all message keys for a given language. | |
static | getMessagesFileName ($code) |
static | getMessagesFor ($code) |
Get all messages for a given language WARNING: this may take a long time. | |
static | getTranslatedLanguageNames ($code) |
Get translated language names. | |
static | hebrewNumeral ($num) |
Hebrew Gematria number formatting up to 9999. | |
static | isValidBuiltInCode ($code) |
Returns true if a language code is of a valid form for the purposes of internal customisation of MediaWiki, via Messages*.php. | |
static | isValidCode ($code) |
Returns true if a language code string is of a valid form, whether or not it exists. | |
static | preloadLanguageClass ($class) |
Includes language class files. | |
static | romanNumeral ($num) |
Roman number formatting up to 3000. | |
Public Attributes | |
$dateFormatStrings = array() | |
$mCode | |
$mConverter | |
$mExtendedSpecialPageAliases | |
$mLoaded = false | |
$mMagicExtensions = array() | |
$mMagicHookDone = false | |
$mNamespaceIds | |
$mVariants | |
$namespaceAliases | |
$transformData = array() | |
ReplacementArray object caches. | |
Static Public Attributes | |
static | $dataCache |
static | $mHebrewCalendarMonthGenMsgs |
static | $mHebrewCalendarMonthMsgs |
static | $mHijriCalendarMonthMsgs |
static | $mIranianCalendarMonthMsgs |
static | $mLangObjCache = array() |
static | $mMonthAbbrevMsgs |
static | $mMonthGenMsgs |
static | $mMonthMsgs |
static | $mWeekdayAbbrevMsgs |
static | $mWeekdayMsgs |
Protected Member Functions | |
doMagicHook () | |
preConvertPlural ($forms, $count) | |
Checks that convertPlural was given an array and pads it to requested amount of forms by copying the last one. | |
removeBadCharFirst ($string) | |
Remove bytes that represent an incomplete Unicode character at the start of string (e.g. | |
removeBadCharLast ($string) | |
Remove bytes that represent an incomplete Unicode character at the end of string (e.g. | |
Static Protected Member Functions | |
static | convertDoubleWidth ($string) |
convert double-width roman characters to single-width. | |
static | insertSpace ($string, $pattern) |
static | newFromCode ($code) |
Create a language object for a given language code. | |
Protected Attributes | |
$namespaceNames | |
Private Member Functions | |
internalUserTimeAndDate ($type, $ts, User $user, array $options) | |
Internal helper function for userDate(), userTime() and userTimeAndDate() | |
numLink (Title $title, $offset, $limit, array $query, $link, $tooltipMsg, $class) | |
Helper function for viewPrevNext() that generates links. | |
truncate_endBracket (&$tag, $tagType, $lastCh, &$openTags) | |
truncateHtml() helper function (a) push or pop $tag from $openTags as needed (b) clear $tag value | |
truncate_skip (&$ret, $text, $search, $start, $len=null) | |
truncateHtml() helper function like strcspn() but adds the skipped chars to $ret | |
Static Private Member Functions | |
static | hebrewYearStart ($year) |
This calculates the Hebrew year start, as days since 1 September. | |
static | tsToHebrew ($ts) |
Converting Gregorian dates to Hebrew dates. | |
static | tsToHijri ($ts) |
Converting Gregorian dates to Hijri dates. | |
static | tsToIranian ($ts) |
Algorithm by Roozbeh Pournader and Mohammad Toossi to convert Gregorian dates to Iranian dates. | |
static | tsToYear ($ts, $cName) |
Algorithm to convert Gregorian dates to Thai solar dates, Minguo dates or Minguo dates. | |
Private Attributes | |
$mHtmlCode = null | |
Static Private Attributes | |
static | $GREG_DAYS = array( 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 ) |
static | $IRANIAN_DAYS = array( 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29 ) |
Internationalisation code.
Definition at line 56 of file Language.php.
Reimplemented in LanguageKk, LanguageKu, LanguageSr, LanguageIu, LanguageShi, LanguageToTest, LanguageTg, LanguageZh, and LanguageGan.
Definition at line 283 of file Language.php.
References getLocalisationCache().
Reduce memory usage.
Definition at line 297 of file Language.php.
Language::addMagicWordsByLang | ( | $ | newWords | ) |
Add magic words to the extension array.
$newWords | array |
Definition at line 2638 of file Language.php.
Return 'right' or 'left' as appropriate alignment for line-end for this language's text direction.
Should be equivalent to CSS3 'end' text-align value....
Definition at line 2547 of file Language.php.
Return 'left' or 'right' as appropriate alignment for line-start for this language's text direction.
Should be equivalent to CSS3 'start' text-align value....
Definition at line 2535 of file Language.php.
Language::armourMath | ( | $ | text | ) |
Put custom tags (e.g.
-{ }-) around math to prevent conversion
$text | string |
Definition at line 3364 of file Language.php.
Language::autoConvertToAllVariants | ( | $ | text | ) |
convert text to all supported variants
$text | string |
Definition at line 3314 of file Language.php.
Definition at line 2567 of file Language.php.
Language::caseFold | ( | $ | s | ) |
Return a case-folded representation of $s.
This is a representation such that caseFold($s1)==caseFold($s2) if $s1 and $s2 are the same except for the case of their characters. It is not necessary for the value returned to make sense when displayed.
Do *not* perform any other normalisation in this function. If a caller uses this function when it should be using a more general normalisation function, then fix the caller.
$s | string |
Definition at line 2252 of file Language.php.
Language::checkTitleEncoding | ( | $ | s | ) |
$s | string |
Reimplemented in LanguageEo.
Definition at line 2260 of file Language.php.
References wfDebugDieBacktrace().
static Language::classFromCode | ( | $ | code | ) | [static] |
$code |
Definition at line 238 of file Language.php.
References ucfirst().
Referenced by newFromCode().
Language::commafy | ( | $ | _ | ) |
Adds commas to a given number.
$_ | mixed |
Reimplemented in LanguageKk_cyrl, LanguageKsh, LanguageRu, LanguageUk, LanguageBe_tarask, LanguageHy, LanguageKaa, LanguagePl, LanguageBg, LanguageEt, LanguageKu_ku, LanguageMy, and LanguageKm.
Definition at line 2744 of file Language.php.
References $digitGroupingPattern, and $matches.
Language::commaList | ( | array $ | list | ) |
Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message.
$list | array of strings to put in a comma list |
Definition at line 2846 of file Language.php.
References wfMsgExt().
Language::convert | ( | $ | text | ) |
convert text to different variants of a language.
$text | string |
Definition at line 3324 of file Language.php.
Language::convertCategoryKey | ( | $ | key | ) |
static Language::convertDoubleWidth | ( | $ | string | ) | [static, protected] |
convert double-width roman characters to single-width.
range: ff00-ff5f ~= 0020-007f
$string | string |
Definition at line 2328 of file Language.php.
Referenced by LanguageGan\convertForSearchResult(), LanguageZh\convertForSearchResult(), and LanguageYue\normalizeForSearch().
Language::convertForSearchResult | ( | $ | termsArray | ) |
$termsArray | array |
Reimplemented in LanguageZh, and LanguageGan.
Definition at line 2358 of file Language.php.
Language::convertGrammar | ( | $ | word, |
$ | case | ||
) |
Grammatical transformations, needed for inflected languages Invoked by putting {{grammar:case|word}} in a message.
$word | string |
$case | string |
Reimplemented in LanguageKk, LanguageKsh, LanguageBs, LanguageOs, LanguageHe, LanguageLa, LanguageFi, LanguageKaa, LanguageRu, LanguageHy, LanguageSl, LanguageCu, LanguageDsb, LanguageGa, LanguageHsb, LanguageTyv, LanguageUk, and LanguageHu.
Definition at line 3163 of file Language.php.
References $wgGrammarForms.
Language::convertHtml | ( | $ | text, |
$ | isTitle = false |
||
) |
Perform output conversion on a string, and encode for safe HTML output.
$text | String text to be converted |
$isTitle | Bool whether this conversion is for the article title |
Definition at line 3375 of file Language.php.
Language::convertLinkToAllVariants | ( | $ | text | ) |
If a language supports multiple variants, converts text into an array of all possible variants of the text: 'variant' => text in that variant.
$text | string |
Definition at line 3445 of file Language.php.
Language::convertPlural | ( | $ | count, |
$ | forms | ||
) |
Plural form transformations, needed for some languages.
For example, there are 3 form of plural in Russian and Polish, depending on "count mod 10". See [[w:Plural]] For English it is pretty simple.
Invoked by putting {{plural:count|wordform1|wordform2}} or {{plural:count|wordform1|wordform2|wordform3}}
Example: {{plural:{{NUMBEROFARTICLES}}|article|articles}}
$count | Integer: non-localized number |
$forms | Array: different plural forms |
Reimplemented in LanguageSr, LanguageKsh, LanguageRu, LanguageUk, LanguageHy, LanguageHe, LanguageGa, LanguageCu, LanguageHsb, LanguageSl, LanguageDsb, LanguageBe_tarask, LanguageGd, LanguageBe, LanguageLv, LanguageLt, LanguageWa, LanguageCs, LanguageLn, LanguageMk, LanguageMt, LanguageAm, LanguageBh, LanguageFr, LanguageGv, LanguageHi, LanguageMg, LanguageNso, LanguageTi, LanguageTl, LanguageAr, LanguageCy, LanguageSgs, LanguageSr_ec, LanguageSr_el, LanguageBs, LanguageHr, LanguageMo, LanguagePl, LanguageRo, LanguageSe, LanguageSh, LanguageSk, and LanguageSma.
Definition at line 3219 of file Language.php.
References $count.
Language::convertTitle | ( | $ | title | ) |
Convert a Title object to a string in the preferred variant.
$title | Title |
Definition at line 3334 of file Language.php.
References $title.
Language::date | ( | $ | ts, |
$ | adj = false , |
||
$ | format = true , |
||
$ | timecorrection = false |
||
) |
$ts | Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts) |
$adj | Bool: whether to adjust the time output according to the user configured offset ($timecorrection) |
$format | Mixed: true to use user's date format preference |
$timecorrection | String|bool the time offset as returned by validateTimeZone() in Special:Preferences |
Reimplemented in LanguageWa.
Definition at line 1817 of file Language.php.
References wfTimestamp().
Referenced by LanguageFi\translateBlockExpiry().
Language::dateFormat | ( | $ | usePrefs = true | ) |
This is meant to be used by time(), date(), and timeanddate() to get the date preference they're supposed to use, it should be used in all children.
function timeanddate([...], $format = true) { $datePreference = $this->dateFormat($format); [...] }
$usePrefs | Mixed: if true, the user's preference is used if false, the site/language default is used if int/string, assumed to be a format. |
Definition at line 1762 of file Language.php.
References $wgUser, and User\getDefaultOption().
Referenced by LanguageWa\date(), and LanguageWa\timeanddate().
Definition at line 2795 of file Language.php.
Definition at line 2802 of file Language.php.
Language::doMagicHook | ( | ) | [protected] |
Definition at line 2596 of file Language.php.
References wfProfileIn(), wfProfileOut(), and wfRunHooks().
Language::emphasize | ( | $ | text | ) |
Italic is unsuitable for some languages.
$text | String: the text to be emphasized. |
Reimplemented in LanguageJa.
Definition at line 2671 of file Language.php.
static Language::factory | ( | $ | code | ) | [static] |
Get a cached language object for a given language code.
$code | String |
Definition at line 143 of file Language.php.
References newFromCode().
Referenced by CliInstaller\__construct(), StubContLang\_newObject(), PurgeParserCache\execute(), DateFormats\execute(), ApiParse\execute(), LangMemUsage\execute(), ApiQueryAllmessages\execute(), UpdateMediaWiki\execute(), ParserTest\fuzzTest(), ResourceLoaderContext\getDirection(), RequestContext\getLanguage(), Message\inLanguage(), LoginForm\processLogin(), ParserTest\runTestsFromFiles(), DerivativeContext\setLanguage(), RequestContext\setLanguage(), RevisionTest\setUp(), LanguageBeTaraskTest\setUp(), XmlTest\setUp(), LanguageConverterTest\setUp(), ParserOptionsTest\setUp(), TestSample\setUp(), LanguageTest\setUp(), MediaWikiLangTestCase\setUp(), HtmlTest\setUp(), LanguageArTest\setUp(), LanguageMgTest\setUp(), LanguageNlTest\setUp(), LanguageRoTest\setUp(), LanguageKshTest\setUp(), LanguageMkTest\setUp(), LanguageMlTest\setUp(), LanguageMoTest\setUp(), LanguageHiTest\setUp(), LanguageShTest\setUp(), LanguageTiTest\setUp(), LanguageBeTest\setUp(), LanguageGaTest\setUp(), LanguagePlTest\setUp(), LanguageSeTest\setUp(), LanguageTlTest\setUp(), LanguageCuTest\setUp(), LanguageSgsTest\setUp(), LanguageSmaTest\setUp(), LanguageTrTest\setUp(), LanguageMtTest\setUp(), LanguageAmTest\setUp(), LanguageWaTest\setUp(), LanguageBhTest\setUp(), LanguageBsTest\setUp(), LanguageCsTest\setUp(), LanguageNsoTest\setUp(), LanguageCyTest\setUp(), LanguageDsbTest\setUp(), LanguageFrTest\setUp(), LanguageGdTest\setUp(), LanguageGvTest\setUp(), LanguageLvTest\setUp(), LanguageLtTest\setUp(), LanguageHyTest\setUp(), LanguageHeTest\setUp(), LanguageHrTest\setUp(), LanguageHsbTest\setUp(), LanguageLnTest\setUp(), LanguageUkTest\setUp(), LanguageSkTest\setUp(), LanguageSlTest\setUp(), LanguageRuTest\setUp(), BlockTest\setUp(), ApiTestCase\setUp(), TitlePermissionTest\setUp(), LanguageSrTest\setUp(), MagicVariableTest\setUp(), NewParserTest\setUp(), SideBarTest\setUp(), NewParserTest\setupGlobals(), ParserTest\setupGlobals(), WebInstaller\setupLanguage(), ParserOptions\setUserLang(), ArticleTablesTest\testbug14404(), LanguageConverterTest\testGetPreferredVariantDefaultLanguageVsUrlVariant(), LanguageConverterTest\testGetPreferredVariantHeaderUserVsUrl(), MessageTest\testInContentLanguage(), MessageTest\testInLanguage(), TimeAdjustTest\testUserAdjust(), wfGetLangObj(), and wfInstallerMain().
Definition at line 2282 of file Language.php.
Language::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
$link | String: the name of the link |
$nt | Mixed: the title object of the link |
$ignoreOtherCond | Boolean: to disable other conditions when we need to transclude a template or update a category's link |
Definition at line 3430 of file Language.php.
Language::firstChar | ( | $ | s | ) |
Get the first character of a string.
$s | string |
Definition at line 2370 of file Language.php.
References $matches, and utf8ToCodepoint().
Language::fixVariableInNamespace | ( | $ | talk | ) |
$talk |
Definition at line 3670 of file Language.php.
References $wgMetaNamespace.
Referenced by getNamespaceAliases(), and getNamespaces().
Language::formatBitrate | ( | $ | bps | ) |
Format a bitrate for output, using an appropriate unit (bps, kbps, Mbps, Gbps, Tbps, Pbps, Ebps, Zbps or Ybps) according to the magnitude in question.
This use base 1000. For base 1024 use formatSize(), for another base see formatComputingNumbers()
$bps | int |
Definition at line 3852 of file Language.php.
Language::formatComputingNumbers | ( | $ | size, |
$ | boundary, | ||
$ | messageKey | ||
) |
$size | int Size of the unit |
$boundary | int Size boundary (1000, or 1024 in most cases) |
$messageKey | string Message key to be uesd |
Definition at line 3862 of file Language.php.
References $size.
Language::formatExpiry | ( | $ | expiry, |
$ | format = true |
||
) |
Decode an expiry (block, protection, etc) which has come from the DB.
$expiry | String: Database expiry String |
$format | Bool|Int true to process using language functions, or TS_ constant to return the expiry in a given timestamp |
Definition at line 3725 of file Language.php.
References wfGetDB(), wfMessage(), and wfTimestamp().
Language::formatNum | ( | $ | number, |
$ | nocommafy = false |
||
) |
Normally we output all numbers in plain en_US style, that is 293,291.235 for twohundredninetythreethousand-twohundredninetyone point twohundredthirtyfive.
However this is not suitable for all languages, some such as Pakaran want ੨੯੩,੨੯੫.੨੩੫ and others such as Icelandic just want to use commas instead of dots, and dots instead of commas like "293.291,235".
An example of this function being called: wfMsg( 'message', $wgLang->formatNum( $num ) )
See LanguageGu.php for the Gujarati implementation and $separatorTransformTable on MessageIs.php for the , => . and . => , implementation.
$number | Mixed: the string to be formatted, should be an integer or a floating point number. |
$nocommafy | Bool: set to true for special numbers like dates |
Definition at line 2699 of file Language.php.
References $wgTranslateNumerals.
Language::formatSize | ( | $ | size | ) |
Format a size in bytes for output, using an appropriate unit (B, KB, MB, GB, TB, PB, EB, ZB or YB) according to the magnitude in question.
This method use base 1024. For base 1000 use formatBitrate(), for another base see formatComputingNumbers()
$size | int Size to format |
Definition at line 3900 of file Language.php.
References $size.
Language::formatTimePeriod | ( | $ | seconds, |
$ | format = array() |
||
) |
$seconds | int|float |
$format | Array Optional If $format['avoid'] == 'avoidseconds' - don't mention seconds if $seconds >= 1 hour If $format['avoid'] == 'avoidminutes' - don't mention seconds/minutes if $seconds > 48 hours If $format['noabbrevs'] is true - use 'seconds' and friends instead of 'seconds-abbrev' and friends For backwards compatibility, $format may also be one of the strings 'avoidseconds' or 'avoidminutes' |
Definition at line 3753 of file Language.php.
References wfMessage().
Language::gender | ( | $ | gender, |
$ | forms | ||
) |
Provides an alternative text depending on specified gender.
Usage {{gender:username|masculine|feminine|neutral}}. username is optional, in which case the gender of current user is used, but only in (some) interface messages; otherwise default gender is used.
If no forms are given, an empty string is returned. If only one form is given, it will be returned unconditionally. These details are implied by the caller and cannot be overridden in subclasses.
If more than one form is given, the default is to use the neutral one if it is specified, and to use the masculine one otherwise. These details can be overridden in subclasses.
$gender | string |
$forms | array |
Definition at line 3190 of file Language.php.
Definition at line 1984 of file Language.php.
An arrow, depending on the language direction.
Definition at line 2576 of file Language.php.
static Language::getCaseMaps | ( | ) | [static] |
MWException |
Definition at line 3699 of file Language.php.
References $wikiLowerChars, $wikiUpperChars, wfGetPrecompiledData(), wfProfileIn(), and wfProfileOut().
static Language::getClassFileName | ( | $ | code | ) | [static] |
$code | string |
Definition at line 3587 of file Language.php.
References $IP.
Get the RFC 3066 code for this language object.
NOTE: The return value of this function is NOT HTML-safe and must be escaped with htmlspecialchars() or similar
Definition at line 3507 of file Language.php.
Referenced by LanguageHu\convertGrammar().
static Language::getCodeFromFileName | ( | $ | filename, |
$ | prefix = 'Language' , |
||
$ | suffix = '.php' |
||
) | [static] |
Get the language code from a file name.
Inverse of getFileName()
$filename | string $prefix . $languageCode . $suffix |
$prefix | string Prefix before the language code |
$suffix | string Suffix after the language code |
Definition at line 3562 of file Language.php.
Return the LanguageConverter used in the Language.
Definition at line 3304 of file Language.php.
Definition at line 607 of file Language.php.
Language::getDateFormatString | ( | $ | type, |
$ | pref | ||
) |
Get a format string for a given type and preference.
$type | string May be date, time or both |
$pref | string The format name as it appears in Messages*.php |
Definition at line 1790 of file Language.php.
Definition at line 627 of file Language.php.
Definition at line 600 of file Language.php.
Definition at line 614 of file Language.php.
Definition at line 3407 of file Language.php.
Language::getDir | ( | ) |
Return the correct HTML 'dir' attribute value for this language.
Definition at line 2523 of file Language.php.
Language::getDirMark | ( | $ | opposite = false | ) |
A hidden direction mark (LRM or RLM), depending on the language direction.
$opposite | Boolean Get the direction mark opposite to your language |
Definition at line 2557 of file Language.php.
References $rtl.
returns language specific options used by User::getPageRenderHash() for example, the preferred language variant
Definition at line 3455 of file Language.php.
Definition at line 642 of file Language.php.
static Language::getFallbackFor | ( | $ | code | ) | [static] |
Get the first fallback for a given language.
$code | string |
Definition at line 3599 of file Language.php.
References isValidBuiltInCode().
Referenced by getFallbackLanguageCode().
Same as getFallbacksFor for current language.
Definition at line 314 of file Language.php.
References getFallbackFor(), and wfDeprecated().
Definition at line 323 of file Language.php.
References getFallbacksFor().
static Language::getFallbacksFor | ( | $ | code | ) | [static] |
Get the ordered list of fallback languages.
$code | string Language code |
Definition at line 3616 of file Language.php.
References isValidBuiltInCode().
Referenced by getFallbackLanguages(), and newFromCode().
static Language::getFileName | ( | $ | prefix = 'Language' , |
$ | code, | ||
$ | suffix = '.php' |
||
) | [static] |
Get the name of a file for a certain language code.
$prefix | string Prepend this to the filename |
$code | string Language code |
$suffix | string Append this to the filename |
Definition at line 3544 of file Language.php.
References isValidCode().
A convenience function that returns the same thing as getNamespaces() except with the array values changed to ' ' where it found '_', useful for producing output to be displayed e.g.
in <select> forms.
Definition at line 388 of file Language.php.
References getNamespaces().
Language::getFormattedNsText | ( | $ | index | ) |
A convenience function that returns the same thing as getNsText() except with '_' changed to ' ', useful for producing output.
$index | string |
Definition at line 420 of file Language.php.
References getNsText().
Language::getGenderNsText | ( | $ | index, |
$ | gender | ||
) |
Returns gender-dependent namespace alias if available.
$index | Int: namespace index |
$gender | String: gender key (male, female... ) |
Definition at line 432 of file Language.php.
References $wgExtraGenderNamespaces, and getNsText().
Language::getHebrewCalendarMonthName | ( | $ | key | ) |
Language::getHijriCalendarMonthName | ( | $ | key | ) |
Get the code in Bcp47 format which we can use inside of html lang="" tags.
NOTE: The return value of this function is NOT HTML-safe and must be escaped with htmlspecialchars() or similar.
Definition at line 3521 of file Language.php.
References wfBCP47().
Language::getImageFile | ( | $ | image | ) |
Definition at line 3495 of file Language.php.
Language::getLanguageName | ( | $ | code | ) |
Get the native language name of $code.
Only if defined in MediaWiki, no other data like CLDR.
$code | string |
Definition at line 722 of file Language.php.
Referenced by getVariantname().
static Language::getLanguageNames | ( | $ | customisedOnly = false | ) | [static] |
Get native language names, indexed by code.
Only those defined in MediaWiki, no other data like CLDR. If $customisedOnly is true, only returns codes with a messages file
$customisedOnly | bool |
Definition at line 663 of file Language.php.
Referenced by languages\__construct(), LanguageConverter\__construct(), ApiQuerySiteinfo\appendInterwikiMap(), ApiQuerySiteinfo\appendLanguages(), AllmessagesTablePager\buildForm(), MessageCache\clear(), RebuildLocalisationCache\execute(), WebInstaller_Language\execute(), MessageCache\figureMessage(), WebInstaller\getAcceptLanguage(), WebInstaller_Language\getLanguageSelector(), Xml\languageSelector(), Preferences\profilePreferences(), MessageCache\replace(), and wfGetLangObj().
static Language::getLocalisationCache | ( | ) | [static] |
Get the LocalisationCache instance.
Definition at line 274 of file Language.php.
References $dataCache, and $wgLocalisationCacheConf.
Referenced by __construct(), Installer\__construct(), NewParserTest\addDBData(), AllmessagesTablePager\getAllMessages(), and ParserTest\setupDatabase().
Language::getLocalNsIndex | ( | $ | text | ) |
Get a namespace key by value, case insensitive.
Only matches namespace names for the current language, not the canonical ones defined in Namespace.php.
$text | String |
Definition at line 469 of file Language.php.
References getNamespaceIds(), and lc().
Language::getMagic | ( | $ | mw | ) |
Fill a MagicWord object with data from here.
$mw |
Definition at line 2611 of file Language.php.
References $magicWords.
Definition at line 2592 of file Language.php.
Language::getMessage | ( | $ | key | ) |
$key | string |
Reimplemented in LanguageQqx.
Definition at line 1977 of file Language.php.
static Language::getMessageFor | ( | $ | key, |
$ | code | ||
) | [static] |
Get a message for a given language.
$key | string |
$code | string |
Definition at line 3650 of file Language.php.
Referenced by MessageCache\get().
Language::getMessageFromDB | ( | $ | msg | ) |
Get a message from the MediaWiki namespace.
$msg | String: message name |
Definition at line 712 of file Language.php.
Referenced by getVariantname().
static Language::getMessageKeysFor | ( | $ | code | ) | [static] |
Get all message keys for a given language.
This is a faster alternative to array_keys( Language::getMessagesFor( $code ) )
$code | string Language code |
Definition at line 3662 of file Language.php.
Referenced by ApiQueryAllmessages\execute().
static Language::getMessagesFileName | ( | $ | code | ) | [static] |
$code | string |
Definition at line 3576 of file Language.php.
References $file, $IP, and wfRunHooks().
Referenced by Digit2Html\execute(), LocalisationCache\initLanguage(), languages\loadFile(), LocalisationCache\recache(), and MessageWriter\writeMessagesToFile().
static Language::getMessagesFor | ( | $ | code | ) | [static] |
Get all messages for a given language WARNING: this may take a long time.
If you just need all message *keys* but need the *contents* of only a few messages, consider using getMessageKeysFor().
$code | string |
Definition at line 3638 of file Language.php.
Referenced by AllTrans\execute(), and DumpMessages\execute().
Language::getMonthAbbreviation | ( | $ | key | ) |
Definition at line 768 of file Language.php.
Language::getMonthName | ( | $ | key | ) |
$key | string |
Definition at line 734 of file Language.php.
Referenced by LanguageWa\date().
Language::getMonthNameGen | ( | $ | key | ) |
Definition at line 741 of file Language.php.
Definition at line 478 of file Language.php.
References $wgExtraGenderNamespaces, and fixVariableInNamespace().
Referenced by getNamespaceIds().
Definition at line 509 of file Language.php.
References $wgNamespaceAliases, getNamespaceAliases(), getNamespaces(), and lc().
Referenced by getLocalNsIndex(), and getNsIndex().
Definition at line 338 of file Language.php.
References $wgExtraNamespaces, $wgMetaNamespace, $wgMetaNamespaceTalk, fixVariableInNamespace(), MWNamespace\getCanonicalNamespaces(), and wfRunHooks().
Referenced by getFormattedNamespaces(), getNamespaceIds(), and getNsText().
Language::getNsIndex | ( | $ | text | ) |
Get a namespace key by value, case insensitive.
Canonical namespace names override custom ones defined for the current language.
$text | String |
Definition at line 539 of file Language.php.
References MWNamespace\getCanonicalIndex(), getNamespaceIds(), and lc().
Language::getNsText | ( | $ | index | ) |
Get a namespace value by key $mw_ns = $wgContLang->getNsText( NS_MEDIAWIKI ); echo $mw_ns; // prints 'MediaWiki'
$index | Int: the array key of the namespace to return |
Definition at line 406 of file Language.php.
References getNamespaces().
Referenced by getFormattedNsText(), and getGenderNsText().
For languages that support multiple variants, the title of an article may be displayed differently in different variants.
this function returns the apporiate title defined in the body of the article.
Definition at line 3466 of file Language.php.
Definition at line 3400 of file Language.php.
Referenced by LanguageKk\convertGrammar(), LanguageKk\isRTL(), LanguageKk\lcfirst(), and LanguageKk\ucfirst().
Definition at line 586 of file Language.php.
Get special page names, as an associative array case folded alias => real name.
Definition at line 2652 of file Language.php.
References wfRunHooks().
static Language::getTranslatedLanguageNames | ( | $ | code | ) | [static] |
Get translated language names.
This is done on best effort and by default this is exactly the same as Language::getLanguageNames. The CLDR extension provides translated names.
$code | String Language code. |
Definition at line 695 of file Language.php.
Referenced by ApiQuerySiteinfo\appendInterwikiMap(), ApiQuerySiteinfo\appendLanguages(), and CoreParserFunctions\language().
Definition at line 3414 of file Language.php.
Language::getUserToggle | ( | $ | tog | ) |
Language::getVariantname | ( | $ | code, |
$ | usemsg = true |
||
) |
short names for language variants used for language conversion links.
$code | String |
$usemsg | bool Use the "variantname-xyz" message if it exists |
Definition at line 556 of file Language.php.
References getLanguageName(), getMessageFromDB(), and wfMessage().
Get the list of variants supported by this language see sample implementation in LanguageZh.php.
Definition at line 3393 of file Language.php.
Language::getWeekdayAbbreviation | ( | $ | key | ) |
Language::getWeekdayName | ( | $ | key | ) |
Language::hasVariant | ( | $ | variant | ) |
Check if the language has the specific variant.
$variant | string |
Definition at line 3354 of file Language.php.
Check if this is a language with variants.
Definition at line 3343 of file Language.php.
Most writing systems use whitespace to break up words.
Some languages such as Chinese don't conventionally do this, which requires special handling when breaking up words for searching etc.
Reimplemented in LanguageZh_hans, and LanguageYue.
Definition at line 2294 of file Language.php.
static Language::hebrewNumeral | ( | $ | num | ) | [static] |
Hebrew Gematria number formatting up to 9999.
$num | int |
Definition at line 1613 of file Language.php.
static Language::hebrewYearStart | ( | $ | year | ) | [static, private] |
This calculates the Hebrew year start, as days since 1 September.
Based on Carl Friedrich Gauss algorithm for finding Easter date. Used for Hebrew date.
$year | int |
Definition at line 1466 of file Language.php.
Language::iconv | ( | $ | in, |
$ | out, | ||
$ | string | ||
) |
$in | |
$out | |
$string |
Reimplemented in LanguageEo.
Definition at line 1994 of file Language.php.
References $in, $out, wfRestoreWarnings(), and wfSuppressWarnings().
Hook which will be called if this is the content language.
Descendants can use this to register hook functions or modify globals
Definition at line 307 of file Language.php.
Reimplemented in LanguageEo.
Definition at line 2422 of file Language.php.
static Language::insertSpace | ( | $ | string, |
$ | pattern | ||
) | [static, protected] |
$string | string |
$pattern | string |
Definition at line 2348 of file Language.php.
Referenced by LanguageJa\segmentByWord(), LanguageYue\segmentByWord(), and LanguageZh_hans\segmentByWord().
Language::internalUserTimeAndDate | ( | $ | type, |
$ | ts, | ||
User $ | user, | ||
array $ | options | ||
) | [private] |
Internal helper function for userDate(), userTime() and userTimeAndDate()
$type | String: can be 'date', 'time' or 'both' |
$ts | Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts) |
$user | User object used to get preferences for timezone and format |
$options | Array, can contain the following keys:
|
Definition at line 1884 of file Language.php.
References User\getDatePreference(), User\getOption(), and wfTimestamp().
Language::isMultibyte | ( | $ | str | ) |
Language::isRTL | ( | ) |
For right-to-left language support.
Reimplemented in LanguageKk.
Definition at line 2515 of file Language.php.
static Language::isValidBuiltInCode | ( | $ | code | ) | [static] |
Returns true if a language code is of a valid form for the purposes of internal customisation of MediaWiki, via Messages*.php.
$code | string |
Definition at line 230 of file Language.php.
Referenced by getFallbackFor(), getFallbacksFor(), LocalisationCache\initLanguage(), newFromCode(), LanguageTest\testBuiltInCodeValidation(), and LanguageTest\testBuiltInCodeValidationRejectUnderscore().
static Language::isValidCode | ( | $ | code | ) | [static] |
Returns true if a language code string is of a valid form, whether or not it exists.
This includes codes which are used solely for customisation via the MediaWiki namespace.
$code | string |
Definition at line 211 of file Language.php.
References Title\getTitleInvalidRegex().
Referenced by getFileName(), newFromCode(), and RequestContext\sanitizeLangCode().
Language::lc | ( | $ | str, |
$ | first = false |
||
) |
$str | string |
$first | bool |
Definition at line 2136 of file Language.php.
Referenced by getLocalNsIndex(), getNamespaceIds(), and getNsIndex().
Language::lcCallback | ( | $ | matches | ) |
$matches | array |
Definition at line 2039 of file Language.php.
References $matches, and $wikiLowerChars.
Language::lcfirst | ( | $ | str | ) |
$str | string |
Reimplemented in LanguageKk, LanguageKaa, and LanguageTr.
Definition at line 2117 of file Language.php.
To allow "foo[[bar]]" to extend the link over the whole word "foobar".
Definition at line 2585 of file Language.php.
A regular expression to match legal word-trailing characters which should be merged onto a link of the form [[foo]]bar.
Definition at line 3488 of file Language.php.
Language::listToText | ( | array $ | l | ) |
Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separator message.
The last two strings are chained with an "and".
$l | Array |
Definition at line 2821 of file Language.php.
Language::markNoConversion | ( | $ | text, |
$ | noParse = false |
||
) |
Enclose a string with the "no conversion" tag.
This is used by various functions in the Parser
$text | String: text to be tagged for no conversion |
$noParse | bool |
Definition at line 3478 of file Language.php.
Whether this language makes distinguishes genders for example in namespaces.
Definition at line 445 of file Language.php.
References $wgExtraGenderNamespaces, and $wgExtraNamespaces.
static Language::newFromCode | ( | $ | code | ) | [static, protected] |
Create a language object for a given language code.
$code | String |
Definition at line 159 of file Language.php.
References MWInit\classExists(), classFromCode(), getFallbacksFor(), isValidBuiltInCode(), isValidCode(), preloadLanguageClass(), and setCode().
Referenced by factory().
Language::normalize | ( | $ | s | ) |
Convert a UTF-8 string to normal form C.
In Malayalam and Arabic, this also cleans up certain backwards-compatible sequences, converting them to the modern Unicode equivalent.
This is language-specific for performance reasons only.
$s | string |
Reimplemented in LanguageAr, and LanguageMl.
Definition at line 2475 of file Language.php.
References $wgAllUnicodeFixes, and UtfNormal\cleanUp().
Language::normalizeForSearch | ( | $ | string | ) |
Some languages have special punctuation need to be normalized.
Make such changes here.
$string | String |
Reimplemented in LanguageBe_tarask, LanguageZh_hans, and LanguageYue.
Definition at line 2316 of file Language.php.
Language::numLink | ( | Title $ | title, |
$ | offset, | ||
$ | limit, | ||
array $ | query, | ||
$ | link, | ||
$ | tooltipMsg, | ||
$ | class | ||
) | [private] |
Helper function for viewPrevNext() that generates links.
$title | Title object to link |
$offset | Integer offset parameter |
$limit | Integer limit parameter |
$query | Array extra query parameters |
$link | String text to use for the link; will be escaped |
$tooltipMsg | String name of the message to use as tooltip |
$class | String value of the "class" attribute of the link |
Definition at line 3975 of file Language.php.
References $limit, Html\element(), Title\getLocalURL(), and wfMessage().
Language::parseFormattedNumber | ( | $ | number | ) |
Language::pipeList | ( | array $ | list | ) |
Same as commaList, but separate it with the pipe instead.
$list | array of strings to put in a pipe list |
Definition at line 2877 of file Language.php.
References wfMsgExt().
Language::preConvertPlural | ( | $ | forms, |
$ | count | ||
) | [protected] |
Checks that convertPlural was given an array and pads it to requested amount of forms by copying the last one.
$count | Integer: How many forms should there be at least |
$forms | Array of forms given to convertPlural |
Definition at line 3236 of file Language.php.
References $count.
Referenced by LanguageBs\convertPlural(), LanguageHr\convertPlural(), LanguageSe\convertPlural(), LanguageSh\convertPlural(), LanguageSk\convertPlural(), LanguageSma\convertPlural(), LanguageMo\convertPlural(), LanguagePl\convertPlural(), LanguageRo\convertPlural(), LanguageSgs\convertPlural(), LanguageCy\convertPlural(), LanguageSr_ec\convertPlural(), LanguageSr_el\convertPlural(), LanguageAr\convertPlural(), LanguageAm\convertPlural(), LanguageHi\convertPlural(), LanguageBh\convertPlural(), LanguageTi\convertPlural(), LanguageTl\convertPlural(), LanguageFr\convertPlural(), LanguageMg\convertPlural(), LanguageGv\convertPlural(), LanguageNso\convertPlural(), LanguageLn\convertPlural(), LanguageMk\convertPlural(), LanguageMt\convertPlural(), LanguageCs\convertPlural(), LanguageWa\convertPlural(), LanguageLt\convertPlural(), LanguageLv\convertPlural(), LanguageBe\convertPlural(), LanguageGd\convertPlural(), LanguageBe_tarask\convertPlural(), LanguageDsb\convertPlural(), LanguageSl\convertPlural(), LanguageHsb\convertPlural(), LanguageCu\convertPlural(), LanguageGa\convertPlural(), LanguageHe\convertPlural(), LanguageHy\convertPlural(), LanguageUk\convertPlural(), LanguageRu\convertPlural(), LanguageKsh\convertPlural(), and LanguageSr\convertPlural().
static Language::preloadLanguageClass | ( | $ | class | ) | [static] |
Includes language class files.
$class | string Name of the language class |
Definition at line 251 of file Language.php.
References $IP.
Referenced by newFromCode().
Language::recodeForEdit | ( | $ | s | ) |
$s | string |
Definition at line 2433 of file Language.php.
References $wgEditEncoding.
Language::recodeInput | ( | $ | s | ) |
$s | string |
Definition at line 2449 of file Language.php.
References $wgEditEncoding.
Language::removeBadCharFirst | ( | $ | string | ) | [protected] |
Remove bytes that represent an incomplete Unicode character at the start of string (e.g.
bytes of the char are missing)
$string | String |
Definition at line 2976 of file Language.php.
Language::removeBadCharLast | ( | $ | string | ) | [protected] |
Remove bytes that represent an incomplete Unicode character at the end of string (e.g.
bytes of the char are missing)
$string | String |
Definition at line 2951 of file Language.php.
static Language::romanNumeral | ( | $ | num | ) | [static] |
Roman number formatting up to 3000.
$num | int |
Definition at line 1583 of file Language.php.
Language::segmentByWord | ( | $ | string | ) |
Some languages such as Chinese require word segmentation, Specify such segmentation when overridden in derived class.
$string | String |
Reimplemented in LanguageZh_hans, LanguageYue, and LanguageJa.
Definition at line 2305 of file Language.php.
Language::segmentForDiff | ( | $ | text | ) |
languages like Chinese need to be segmented in order for the diff to be of any use
$text | String |
Reimplemented in LanguageZh, and LanguageGan.
Definition at line 3284 of file Language.php.
Language::semicolonList | ( | array $ | list | ) |
Take a list of strings and build a locale-friendly semicolon-separated list, using the local semicolon-separator message.
$list | array of strings to put in a semicolon list |
Definition at line 2862 of file Language.php.
References wfMsgExt().
Definition at line 2809 of file Language.php.
Language::setCode | ( | $ | code | ) |
$code | string |
Definition at line 3531 of file Language.php.
Referenced by newFromCode().
Language::setNamespaces | ( | array $ | namespaces | ) |
Arbitrarily set all of the namespace names at once.
Mainly used for testing
$namespaces | Array of namespaces (id => name) |
Definition at line 376 of file Language.php.
Language::specialList | ( | $ | page, |
$ | details, | ||
$ | oppositedm = true |
||
) |
Make a list item, used by various special pages.
$page | String Page link |
$details | String Text between brackets |
$oppositedm | Boolean Add the direction mark opposite to your language, to display text properly |
Definition at line 3913 of file Language.php.
References $page, and wfMsgExt().
Language::specialPage | ( | $ | name | ) |
Language::sprintfDate | ( | $ | format, |
$ | ts | ||
) |
This is a workalike of PHP's date() function, but with better internationalisation, a reduced set of format characters, and a better escaping format.
Supported format characters are dDjlNwzWFmMntLoYyaAgGhHiscrU. See the PHP manual for definitions. There are a number of extensions, which start with "x":
xn Do not translate digits of the next numeric format character xN Toggle raw digit (xn) flag, stays set until explicitly unset xr Use roman numerals for the next numeric format character xh Use hebrew numerals for the next numeric format character xx Literal x xg Genitive month name
xij j (day number) in Iranian calendar xiF F (month name) in Iranian calendar xin n (month number) in Iranian calendar xiy y (two digit year) in Iranian calendar xiY Y (full year) in Iranian calendar
xjj j (day number) in Hebrew calendar xjF F (month name) in Hebrew calendar xjt t (days in month) in Hebrew calendar xjx xg (genitive month name) in Hebrew calendar xjn n (month number) in Hebrew calendar xjY Y (full year) in Hebrew calendar
xmj j (day number) in Hijri calendar xmF F (month name) in Hijri calendar xmn n (month number) in Hijri calendar xmY Y (full year) in Hijri calendar
xkY Y (full year) in Thai solar calendar. Months and days are identical to the Gregorian calendar xoY Y (full year) in Minguo calendar or Juche year. Months and days are identical to the Gregorian calendar xtY Y (full year) in Japanese nengo. Months and days are identical to the Gregorian calendar
Characters enclosed in double quotes will be considered literal (with the quotes themselves removed). Unmatched quotes will be considered literal quotes. Example:
"The month is" F => The month is January i's" => 20'11"
Backslash escaping is also supported.
Input timestamp is assumed to be pre-normalized to the desired local time zone, if any.
$format | String |
$ts | String: 14-character timestamp YYYYMMDDHHMMSS 01234567890123 |
Definition at line 886 of file Language.php.
Language::time | ( | $ | ts, |
$ | adj = false , |
||
$ | format = true , |
||
$ | timecorrection = false |
||
) |
$ts | Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts) |
$adj | Bool: whether to adjust the time output according to the user configured offset ($timecorrection) |
$format | Mixed: true to use user's date format preference |
$timecorrection | String|bool the time offset as returned by validateTimeZone() in Special:Preferences |
Definition at line 1836 of file Language.php.
References wfTimestamp().
Referenced by LanguageWa\timeanddate().
Language::timeanddate | ( | $ | ts, |
$ | adj = false , |
||
$ | format = true , |
||
$ | timecorrection = false |
||
) |
$ts | Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts) |
$adj | Bool: whether to adjust the time output according to the user configured offset ($timecorrection) |
$format | Mixed: what format to return, if it's false output the default one (default true) |
$timecorrection | String|bool the time offset as returned by validateTimeZone() in Special:Preferences |
Reimplemented in LanguageWa.
Definition at line 1856 of file Language.php.
References wfTimestamp().
Language::transformUsingPairFile | ( | $ | file, |
$ | string | ||
) |
Transform a string using serialized data stored in the given file (which must be in the serialized subdirectory of $IP).
The file contains pairs mapping source characters to destination characters.
The data is cached in process memory. This will go faster if you have the FastStringSearch extension.
$file | string |
$string | string |
Definition at line 2499 of file Language.php.
References $file, and wfGetPrecompiledData().
Referenced by LanguageMl\normalize(), and LanguageAr\normalize().
Language::translateBlockExpiry | ( | $ | str | ) |
Note that this function is somewhat misnamed: it deals with translating the *duration* ("1 week", "4 days", etc), not the expiry time (which is an absolute timestamp). Please note: do NOT add this blindly, as it is used on old expiry lengths recorded in log entries. You'd need to provide the start date to match up with it.
$str | String: the validated block duration in English |
Definition at line 3254 of file Language.php.
References SpecialBlock\getSuggestedDurations().
Language::truncate | ( | $ | string, |
$ | length, | ||
$ | ellipsis = '...' , |
||
$ | adjustLength = true |
||
) |
Truncate a string to a specified length in bytes, appending an optional string (e.g.
for ellipses)
The database offers limited byte lengths for some columns in the database; multi-byte character sets mean we need to ensure that only whole characters are included, otherwise broken characters can be passed to the user
If $length is negative, the string will be truncated from the beginning
$string | String to truncate |
$length | Int: maximum length (including ellipses) |
$ellipsis | String to append to the truncated text |
$adjustLength | Boolean: Subtract length of ellipsis from $length. $adjustLength was introduced in 1.18, before that behaved as if false. |
Definition at line 2904 of file Language.php.
References wfMsgExt().
Language::truncate_endBracket | ( | &$ | tag, |
$ | tagType, | ||
$ | lastCh, | ||
&$ | openTags | ||
) | [private] |
truncateHtml() helper function (a) push or pop $tag from $openTags as needed (b) clear $tag value
&$tag | string Current HTML tag name we are looking at |
$tagType | int (0-open tag, 1-close tag) |
$lastCh | char|string Character before the '>' that ended this tag |
&$openTags | array Open tag stack (not accounting for $tag) |
Definition at line 3141 of file Language.php.
Language::truncate_skip | ( | &$ | ret, |
$ | text, | ||
$ | search, | ||
$ | start, | ||
$ | len = null |
||
) | [private] |
truncateHtml() helper function like strcspn() but adds the skipped chars to $ret
$ret | |
$text | |
$search | |
$start | |
$len |
Definition at line 3118 of file Language.php.
Language::truncateHtml | ( | $ | text, |
$ | length, | ||
$ | ellipsis = '...' |
||
) |
Truncate a string of valid HTML to a specified length in bytes, appending an optional string (e.g.
for ellipses), and return valid HTML
This is only intended for styled/linked text, such as HTML with tags like and , were the tags are self-contained (valid HTML). Also, this will not detect things like "display:none" CSS.
Note: since 1.18 you do not need to leave extra room in $length for ellipses.
string | $text | HTML string to truncate |
int | $length | (zero/positive) Maximum length (including ellipses) |
string | $ellipsis | String to append to the truncated text |
Definition at line 3002 of file Language.php.
References wfMsgExt().
static Language::tsToHebrew | ( | $ | ts | ) | [static, private] |
Converting Gregorian dates to Hebrew dates.
Based on a JavaScript code by Abu Mami and Yisrael Hersch ([email protected], http://www.kaluach.net), who permitted to translate the relevant functions into PHP and release them under GNU GPL.
The months are counted from Tishrei = 1. In a leap year, Adar I is 13 and Adar II is 14. In a non-leap year, Adar is 6.
$ts | string |
Definition at line 1325 of file Language.php.
static Language::tsToHijri | ( | $ | ts | ) | [static, private] |
Converting Gregorian dates to Hijri dates.
Based on a PHP-Nuke block by Sharjeel which is released under GNU/GPL license
$ts | string |
Definition at line 1274 of file Language.php.
static Language::tsToIranian | ( | $ | ts | ) | [static, private] |
Algorithm by Roozbeh Pournader and Mohammad Toossi to convert Gregorian dates to Iranian dates.
Originally written in C, it is released under the terms of GNU Lesser General Public License. Conversion to PHP was performed by Niklas Laxström.
Link: http://www.farsiweb.info/jalali/jalali.c
$ts | string |
Definition at line 1216 of file Language.php.
static Language::tsToYear | ( | $ | ts, |
$ | cName | ||
) | [static, private] |
Algorithm to convert Gregorian dates to Thai solar dates, Minguo dates or Minguo dates.
Link: http://en.wikipedia.org/wiki/Thai_solar_calendar http://en.wikipedia.org/wiki/Minguo_calendar http://en.wikipedia.org/wiki/Japanese_era_name
$ts | String: 14-character timestamp |
$cName | String: calender name |
Definition at line 1504 of file Language.php.
Language::uc | ( | $ | str, |
$ | first = false |
||
) |
Convert a string to uppercase.
$str | string |
$first | bool |
Definition at line 2088 of file Language.php.
Language::ucCallback | ( | $ | matches | ) |
$matches | array |
Definition at line 2030 of file Language.php.
References $matches, and $wikiUpperChars.
Language::ucfirst | ( | $ | str | ) |
Make a string's first character uppercase.
$str | string |
Reimplemented in LanguageKk, LanguageKaa, LanguageTr, and LanguageAz.
Definition at line 2068 of file Language.php.
Referenced by classFromCode().
Language::ucwordbreaks | ( | $ | str | ) |
capitalize words at word breaks
$str | string |
Definition at line 2205 of file Language.php.
Language::ucwordbreaksCallbackAscii | ( | $ | matches | ) |
$matches | array |
Definition at line 2014 of file Language.php.
References $matches.
Language::ucwordbreaksCallbackMB | ( | $ | matches | ) |
$matches | array |
Definition at line 2022 of file Language.php.
References $matches.
Language::ucwords | ( | $ | str | ) |
Language::ucwordsCallbackMB | ( | $ | matches | ) |
$matches | array |
Definition at line 2048 of file Language.php.
References $matches.
Language::ucwordsCallbackWiki | ( | $ | matches | ) |
$matches | array |
Definition at line 2056 of file Language.php.
References $matches, and $wikiUpperChars.
Language::unsegmentForDiff | ( | $ | text | ) |
and unsegment to show the result
$text | String |
Reimplemented in LanguageZh, and LanguageGan.
Definition at line 3294 of file Language.php.
Language::userAdjust | ( | $ | ts, |
$ | tz = false |
||
) |
Used by date() and time() to adjust the time output.
$ts | Int the time in date('YmdHis') format |
$tz | Mixed: adjust the time by this amount (default false, mean we get user timecorrection setting) |
Definition at line 1677 of file Language.php.
References $t, $wgLocalTZoffset, $wgUser, wfRestoreWarnings(), and wfSuppressWarnings().
Referenced by LanguageWa\date(), and LanguageWa\timeanddate().
Language::userDate | ( | $ | ts, |
User $ | user, | ||
array $ | options = array() |
||
) |
Get the formatted date for the given timestamp and formatted for the given user.
$ts | Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts) |
$user | User object used to get preferences for timezone and format |
$options | Array, can contain the following keys:
|
Definition at line 1923 of file Language.php.
References $options.
Language::userTime | ( | $ | ts, |
User $ | user, | ||
array $ | options = array() |
||
) |
Get the formatted time for the given timestamp and formatted for the given user.
$ts | Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts) |
$user | User object used to get preferences for timezone and format |
$options | Array, can contain the following keys:
|
Definition at line 1946 of file Language.php.
References $options.
Language::userTimeAndDate | ( | $ | ts, |
User $ | user, | ||
array $ | options = array() |
||
) |
Get the formatted date and time for the given timestamp and formatted for the given user.
$ts | Mixed: the time format which needs to be turned into a date('YmdHis') format with wfTimestamp(TS_MW,$ts) |
$user | User object used to get preferences for timezone and format |
$options | Array, can contain the following keys:
|
Definition at line 1969 of file Language.php.
References $options.
Language::viewPrevNext | ( | Title $ | title, |
$ | offset, | ||
$ | limit, | ||
array $ | query = array() , |
||
$ | atend = false |
||
) |
Generate (prev x| next x) (20|50|100...) type links for paging.
$title | Title object to link |
$offset | Integer offset parameter |
$limit | Integer limit parameter |
$query | String optional URL query parameter string |
$atend | Bool optional param for specified if this is the last page |
Definition at line 3931 of file Language.php.
References $limit, and wfMessage().
Language::$dataCache [static] |
Definition at line 80 of file Language.php.
Referenced by getLocalisationCache().
Language::$dateFormatStrings = array() |
Definition at line 67 of file Language.php.
Language::$GREG_DAYS = array( 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 ) [static, private] |
Definition at line 1201 of file Language.php.
Language::$IRANIAN_DAYS = array( 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29 ) [static, private] |
Definition at line 1202 of file Language.php.
Language::$mCode |
Definition at line 63 of file Language.php.
Language::$mConverter |
Definition at line 61 of file Language.php.
Language::$mExtendedSpecialPageAliases |
Definition at line 68 of file Language.php.
Language::$mHebrewCalendarMonthGenMsgs [static] |
array( 'hebrew-calendar-m1-gen', 'hebrew-calendar-m2-gen', 'hebrew-calendar-m3-gen', 'hebrew-calendar-m4-gen', 'hebrew-calendar-m5-gen', 'hebrew-calendar-m6-gen', 'hebrew-calendar-m7-gen', 'hebrew-calendar-m8-gen', 'hebrew-calendar-m9-gen', 'hebrew-calendar-m10-gen', 'hebrew-calendar-m11-gen', 'hebrew-calendar-m12-gen', 'hebrew-calendar-m6a-gen', 'hebrew-calendar-m6b-gen' )
Definition at line 123 of file Language.php.
Language::$mHebrewCalendarMonthMsgs [static] |
array( 'hebrew-calendar-m1', 'hebrew-calendar-m2', 'hebrew-calendar-m3', 'hebrew-calendar-m4', 'hebrew-calendar-m5', 'hebrew-calendar-m6', 'hebrew-calendar-m7', 'hebrew-calendar-m8', 'hebrew-calendar-m9', 'hebrew-calendar-m10', 'hebrew-calendar-m11', 'hebrew-calendar-m12', 'hebrew-calendar-m6a', 'hebrew-calendar-m6b' )
Definition at line 115 of file Language.php.
Language::$mHijriCalendarMonthMsgs [static] |
array( 'hijri-calendar-m1', 'hijri-calendar-m2', 'hijri-calendar-m3', 'hijri-calendar-m4', 'hijri-calendar-m5', 'hijri-calendar-m6', 'hijri-calendar-m7', 'hijri-calendar-m8', 'hijri-calendar-m9', 'hijri-calendar-m10', 'hijri-calendar-m11', 'hijri-calendar-m12' )
Definition at line 131 of file Language.php.
Language::$mHtmlCode = null [private] |
Definition at line 65 of file Language.php.
Language::$mIranianCalendarMonthMsgs [static] |
array( 'iranian-calendar-m1', 'iranian-calendar-m2', 'iranian-calendar-m3', 'iranian-calendar-m4', 'iranian-calendar-m5', 'iranian-calendar-m6', 'iranian-calendar-m7', 'iranian-calendar-m8', 'iranian-calendar-m9', 'iranian-calendar-m10', 'iranian-calendar-m11', 'iranian-calendar-m12' )
Definition at line 108 of file Language.php.
Language::$mLangObjCache = array() [static] |
Definition at line 82 of file Language.php.
Language::$mLoaded = false |
Definition at line 63 of file Language.php.
Language::$mMagicExtensions = array() |
Definition at line 64 of file Language.php.
Language::$mMagicHookDone = false |
Definition at line 64 of file Language.php.
Language::$mMonthAbbrevMsgs [static] |
array( 'jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec' )
Definition at line 103 of file Language.php.
Language::$mMonthGenMsgs [static] |
array( 'january-gen', 'february-gen', 'march-gen', 'april-gen', 'may-gen', 'june-gen', 'july-gen', 'august-gen', 'september-gen', 'october-gen', 'november-gen', 'december-gen' )
Definition at line 98 of file Language.php.
Language::$mMonthMsgs [static] |
array( 'january', 'february', 'march', 'april', 'may_long', 'june', 'july', 'august', 'september', 'october', 'november', 'december' )
Definition at line 93 of file Language.php.
Language::$mNamespaceIds |
Definition at line 70 of file Language.php.
Language::$mVariants |
Definition at line 63 of file Language.php.
Language::$mWeekdayAbbrevMsgs [static] |
array( 'sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat' )
Definition at line 89 of file Language.php.
Language::$mWeekdayMsgs [static] |
array( 'sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday' )
Definition at line 84 of file Language.php.
Language::$namespaceAliases |
Definition at line 70 of file Language.php.
Language::$namespaceNames [protected] |
Definition at line 70 of file Language.php.
Language::$transformData = array() |
ReplacementArray object caches.
Definition at line 75 of file Language.php.