Extension:Translate

MediaWiki extensions manual

Translate Release status: stable
Implementation	Special page , Locale , API , Parser function
Description	Enables in-wiki owersetin n pruifreadin
Author(s)	Niklas Laxström, Siebrand Mazeland n ithers
Latest version	2022-04-26
Compatibility policy	Master maintains backward compatibility.
MediaWiki	>= 1.36.4 < 1.37 || >= 1.37.2
Database changes	Yes
Composer	mediawiki/translate
Tables	revtag translate_groupreviews translate_groupstats translate_messageindex translate_metadata translate_reviews translate_sections translate_stash translate_tms translate_tmt translate_tmf
License	GNU General Public License 2.0 or later
Download	Incluidit in the Leid Extension Bundle Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review Uiser documentation Changelog
Help	Help:Extension:Translate/sco
Example	Translatewiki.net – or try how to translate a page now
Parameters $wgTranslateFuzzyBotName $wgTranslatePageTranslationULS $wgTranslateDocumentationLanguageCode $wgTranslateGroupSynchronizationCache $wgTranslateUserManagerName $wgTranslateSandboxLimit $wgTranslateStatsProviders $wgTranslateGroupAliases $wgTranslateRcFilterDefault $wgTranslateAuthorExclusionList $wgTranslateKeepOutdatedTranslations $wgTranslateGroupRoot $wgTranslatePageMoveLimit $wgEnablePageTranslation $wgTranslateEnableMessageBundleIntegration $wgTranslatePermissionUrl $wgTranslateUsePreSaveTransform $wgTranslateSecondaryPermissionUrl $wgTranslateSupportUrlNamespace $wgTranslateDisabledTargetLanguages $wgTranslateMessageIndex $wgPageTranslationLanguageList $wgTranslateTranslationServices $wgTranslateGroupFiles $wgTranslateMessageNamespaces $wgTranslateValidationExclusionFile $wgTranslateTranslationDefaultService $wgTranslateYamlLibrary $wgTranslateSandboxPromotedGroup $wgTranslateUseSandbox $wgTranslateLanguageFallbacks $wgTranslateSupportUrl $wgTranslateCacheDirectory $wgTranslateWorkflowStates
Added rights translate translate-import translate-manage translate-messagereview translate-groupreview
Hooks used AbortEmailNotification AbuseFilter-builder AbuseFilter-computeVariable AbuseFilterAlterVariables AdminLinks AlternateEdit ArticleContentOnDiff ArticleDeleteComplete ArticlePrepareTextForEdit ChangesListSpecialPageQuery ChangesListSpecialPageStructuredFilters DeleteAccount EditFilterMergedContent EditPage::showEditForm:initial GetPreferences LanguageGetTranslatedLanguageNames LoadExtensionSchemaUpdates MakeGlobalVariablesScript MergeAccountFromTo OutputPageParserOutput PageContentLanguage PageSaveComplete ParserAfterTidy ParserFirstCallInit ParserTestTables RevisionRecordInserted SkinTemplateNavigation::SpecialPage SpecialRecentChangesPanel SpecialSearchProfileForm SpecialSearchProfiles SpecialSearchSetupEngine TitleIsAlwaysKnown Translate:newTranslation TranslateEventMessageMembershipChange TranslateEventTranslationReview TranslateInitGroupLoaders TranslateSupportedLanguages UserGetReservedNames getUserPermissionsErrorsExpensive
Hooks provided Translate:GettextFFS:headerFields Translate:MessageGroupStats:isIncluded Translate:modifyMessageGroupStates Translate:newTranslation TranslateBeforeAddModules TranslateEventMessageGroupStateChange TranslateEventMessageMembershipChange TranslateEventTranslationReview TranslateGetAPIMessageGroupsParameterList TranslateGetAPIMessageGroupsPropertyDescs TranslateGetBoxes TranslateGetSpecialTranslateOptions TranslateInitGroupLoaders TranslateMessageGroupPathVariables TranslatePostInitGroups TranslatePrefillTranslation TranslateProcessAPIMessageGroupsProperties TranslateSupportedLanguages TranslateTranslationAids
Translate the Translate extension
Check usage and version matrix.
Issues	Open tasks · Report a bug

Extension-Translate

Documentation for Extension:Translate

Translators (main help page )

• How to translate
• Best practices
• Statistics and reporting
• Quality assurance
• Message group states
• Offline translation
• Glossary

Translation administrators

• How to prepare a page for translation
• Page translation administration
• Unstructured element translation
• Group management
• Move translatable page

Sysadmins and developers

• Installation
• Configuration
• Getting started with development
• Developer guide
• Extending Translate
• Validators
• Insertables
• Group configuration
• Group configuration example
• Translation memories
• Translation aids

Translate this template

The Translate extension maks MediaWiki ae feckfu tuil tae owerset aw kynd o tex. It's uised especialie tae owerset saffware n tae manage monieleidic wikis in ae sensible waa.

Featurs

The Translate extension haes monie featurs specifically tairgetit tae owerseters, while makin back-end integration wi the actual soorce code aes easie aes possible. Meanwhile, awthing rins inside MediaWiki, this allous uisers aen awmaist endless degree o freedom fer communication n sel-organisation.

Featurs incluid:

• Structurt wiki content page owersetin.
• In-wiki localisation n exportin o saffware interface messages (or juist aboot oniething).
• Wab-based owersetin n pruifreadin interface, aes weel aes gettext based export n import fer aff-line owersetin.
• Sindrie aids tae mak the job o owerseters easier:
  • displey o owersets in globalie defined ither leids, optionlie expaundit wi uiser defined leids;
  • collaborateeve eeditin o documentation o the uiss n contex o messages;
  • owersetin memrie n machine owersetin wi ootby tuils (Apertium, Microsoft Translator, Yandex.Translate);
  • displey o the hainmaist chynge in the soorce message;
  • wairnishmants aneatt common mistaks lik boundins that'r no uised.
• Pre-makit modules fer sindrie apen soorce waurks that ye can uise aes aen example.
  • Support fer sindrie formats incluidin: PHP, Java properties, Gettext, YAML n AndroidXml (see full FFS list n File format support).
• Ae versatile plug-in system tae mak it easie tae eik new waurks aes ae message groop.
• Sindrie stateestics:
  • owersetment compleation percentages fer aw message groops in aw supportit leids;
  • owersetment compleation percentages in aw supportit leids fer onie supportit message groop;
  • tuil fer makin acteevitie graphs fer spans o time. Can display either number of edits or active users daily or hourly and includes many filters;
  • clood luikower o acteeve leids n owerseters.

Translate extension, cause o its muckle uiser base, is confirmed tae be compatible wi aw reasonablie recynt brousers, except fer some wee (style) glitches that ar quicklie fixt.

• Makin Monieleidic Wikis ae Realitie: this presentation shaws hou the Translate extension can mak ae wiki trulie monileidic, based oan the experience o KDE UserBase wiki.

• Niklas Laxström, Owersetin the wiki waa: Simple, fast, fun, Wikimania 2012 (slides available).

Support n documentation

• See Instawation
• See Confeeguration
• See Uiser documentation — incluids teachin material

• See Getting started with Translate extension development

• Live support at #translatewiki IRC channel at Libera Chat (the best times ar at European days n gloamins)
• Please report aw issues n featur requests in the eessue tracker

Translate extension wis oreegonlie deveelopt bi User:Nikerabbit; monie ither uisers, lik User:Raymond, User:SPQRobin n the Wikimedia Leid team, hae contreebutit tae its code n documentation. It's maintained bi User:Nikerabbit n User:Siebrand.

Prominant uisers o the Translate extension

• https://translatewiki.net — The mucklest wiki-based steid n communitie fer the owersetin o the interface o apen soorce saffware.
• https://userbase.kde.org — Documentation wiki fer KDE waurk that uises the page owersetin featur quite ae bit.
• https://meta.wikimedia.org — Owersets wiki content n uises the groop states featur. Owrsetin n owersetin luikower is enabled fer awmaist aw uisers o the wiki.
• https://wiki.documentfoundation.org/

See mair at Wikipedia:translatewiki.net#Notable uses.

Testimonials

Tom Hutchison o Joomla:

The Translate extension allous fer connection tae aen owersetin service n can autæ fill the owerset fer ye. At the same time aen owerseter can mak adjustments sae that ye'r no creautin heaps o pages wi onaccurate owersetins.

That's ok gif thay'r oan differant continents. That is actually a plus because work is getting done 24 hours a day. What they need is a support group chat for each other. They would all be able to read English if they are translating right? Teach a few simple wiki markup such as links and what to do with categories. Then they help others who in turn help others. We have over 40 in a chat who help each other and have fun at the same time. And they were all scared of the wiki but couldn't believe how easy it was once they started. They are actually waiting on me for more translations to do because I can't keep up with them. I know there is only 1 translating this language or that language. We have that too. One person is doing Swahili while another one is working on Japanese. Also, you mark pages for translation. You control whether to include templates or exclude variables in template calls.

Relatit pages

• Translatable template.
• Extension:TranslationNotifications – aen extension tae faceelitate communication wi owerseters.

Not to be confused with:

• Extension:ContentTranslation tool – used for one-off translation of wiki pages from one language to another.
• Extension:TranslateWiki
• m:Abstract Wikipedia for translation.

Hou tae contreebute

• Owerset this extension at translatewiki.net
• Apen bugs n featur requests
• Mair apen bugs n featur requests at translatewiki.net
• Pruifread n owerset the documentation o Translate extension