Extension:ContentTranslation/af
From Linux Web Expert
| ContentTranslation Release status: stable |
|
|---|---|
| Implementation | User interface, Page action |
| Description | 'n Gereedskapstuk wat redakteurs toelaat om 'n artikel te vertaal van een taal na 'n ander met die hulp van masjienvertaling en ander vertalings-hulpmiddels. |
| Author(s) | Language team |
| Compatibility policy | Snapshots releases along with MediaWiki. Master is not backward compatible. |
| MediaWiki | 1.37+ |
| PHP | 7.2+ |
| Tables | cx_translations cx_translators cx_lists cx_suggestions cx_corpora cx_notification_log cx_significant_edits cx_section_translations |
| License | GNU General Public License 2.0 or later |
| Download | |
| Quarterly downloads | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| Public wikis using | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
| Translate the ContentTranslation extension if it is available at translatewiki.net | |
| Issues | Open tasks · Report a bug |
The ContentTranslation extension is a tool that allows editors to translate an article from one language to another with the help of machine translation and other translation aids. See Inhoudsvertaling for background and additional information. The extension is being developed by the Wikimedia Language Engineering team.
Installasie
This extension requires a Content Translation server to be setup first. Morover it has three extension dependencies.
- <translate> [[<tvar name=2>Special:ExtensionDistributor/ContentTranslation/af</tvar>|Download]] and move the extracted <tvar name=name>
ContentTranslation/af</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
<translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ContentTranslation%2Faf - <translate> Only when installing from Git, run <tvar name=composer>Composer</tvar> to install PHP dependencies, by issuing <tvar name=code>
composer install --no-dev</tvar> in the extension directory.</translate> <translate> (See <tvar name=phab><translate> task <tvar name=1>T173141</tvar></translate></tvar> for potential complications.)</translate> - <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php</tvar> file:</translate>
wfLoadExtension( 'ContentTranslation/af' );
- <translate> Run the [[<tvar name=update>Special:MyLanguage/Manual:Update.php</tvar>|update script]] which will automatically create the necessary database tables that this extension needs.</translate>
- File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>
<translate> Vagrant installation:</translate>
- <translate> If using <tvar name=vagrant>Vagrant</tvar>, install with <tvar name=code>
vagrant roles enable contenttranslation --provision</tvar></translate>
Content Translation server
Die uitbreiding benodig die Inhoud Vertaling Server (o.b.a. cxserver)
See Content translation/cxserver/Setup for setting up the Content Translation server.
When running Content Translation locally, following can be added to LocalSettings.php to use production cxserver:
$wgContentTranslationSiteTemplates['cx'] = 'https://cxserver.wikimedia.org/v1';
Vertalingsdatabasis
Die uitbreiding het 'n opsionele paneelbord funksie wat vertalers toelaat om al die vertalings regoor al die tale te sien.
In 'n veeltalige installasie van hierdie uitbreiding, byvoorbeeld in die Wikipedia wiki's, word 'n sentrale databasis vereis om die paneelbord funksie te bedien.
Table definitions for that database are in sql directory in the extension source code; Content translation/Product Definition/Database has more details.
Nadat die databasis geskep is, stel die $wgContentTranslationDatabase globale veranderlike as die naam van die databasis:
$wgContentTranslationDatabase = 'db_name';
Uitbreidingsafhanklikhede
Inhoudsvertaling is afhanklik van die volgende uitbreidings:
| UniversalLanguageSelector | <translate> Required</translate> | |
| VisualEditor | <translate> Required</translate> | Benodig vir die redakteurs-komponent. |
| Cite | <translate> Required</translate> | Required if you want to support references while translating. |
| GuidedTour | <translate> Optional</translate> | If installed, it will be used to show an explanation about moving a page out of user space. |
| Echo | <translate> Optional</translate> | If installed, it will be used for showing "congratulations" notifications after completing translation milestones. |
| Wikibase | <translate> Optional</translate> | If installed and configured similarly to Wikipedia, it will be used for automatic addition of interlanguage links (as sitelinks). |
| EventLogging | <translate> Optional</translate> | If installed, can be used to log publishing, errors, and other events. |
| BetaFeatures | <translate> Optional</translate> | If installed, ContentTranslation will appear as a beta feature in the preferences. |
Configuration variables
| File:Under construction icon-blue.svg | <translate> This section is currently a draft.</translate> <translate> Material may not yet be complete, information may presently be omitted, and certain parts of the content may be subject to radical, rapid alteration.</translate> <translate> More information pertaining to this may be available on the [[<tvar|1>Extension talk:ContentTranslation/af</>|talk page]].</translate> |
For the full list and defaults, see extension.json in the source repository.
- ContentTranslationDomainCodeMapping
- Used to map between non-standard language codes and actual domains. The default is the same as in Wikipedia codes and domains.
- ContentTranslationRESTBase
- Configuration of RESTBase URL and connection parameters. The defaults are for Wikipedia.
- ContentTranslationDatabase
- The name of the database in which the common tables for managing translations across wikis are stored. The default is null, which means that the default database is used.
- ContentTranslationCluster
- In a Wikipedia-like database configuration, the name of the cluster on which the database is hosted. The default is null, which means that the default cluster is used.
- ContentTranslationEventLogging
- Whether EventLogging is enabled. The default is false.
- ContentTranslationHighMTCategory
- A category to which pages that have a high level of machine translation are added upon publishing. The default is null.
- ContentTranslationSiteTemplates
- Templates for essential URLs. The defaults assume Wikipedia, so this variable must be configured differently for other sites. Where relevant, $1 is replaced by the language code, and $2 is replaced by the page title.
- ContentTranslationTranslateInTarget
- Whether to open Special:ContentTranslation in the target wiki when clicking the button in the entry point. The domain will be based on $wgContentTranslationSiteTemplates. The default is to open Special:ContentTranslation on the same wiki. (For Wikipedia this is set to true.)
- ContentTranslationAsBetaFeature
- Whether ContentTranslation is a beta feature.
- ContentTranslationTargetNamespace
- The default target namespace for published articles. The default is Main.
- ContentTranslationCampaigns
- Campaigns that are available in the URL as valid values for the campaign parameter in the URL. This allows automatic enabling of the beta feature and event logging.
- ContentTranslationCXServerAuth
- CXServer connection configuration.
- ContentTranslationEnableSuggestions
- Whether to use the suggestions tab and automatic suggestions. This needs the GapFinder API. This is false by default, but true in Wikipedia.
- RecommendToolAPIURL
- The URL for the GapFinder API, needed if ContentTranslationEnableSuggestions is true.
Url parameters
Content Translation mainly works on the special page Special:ContentTranslation. The URL parameters are
- page: source title
- targettitle: target title
- from: source language
- to: target language
- campaign: campaign name
- In Wikimedia wikis, if content translation is not enabled in the user settings then only links to pre-defined campaign will work. Campaings are defined in InitialiseSettings.php
wmgContentTranslationCampaignsvariable.
- In Wikimedia wikis, if content translation is not enabled in the user settings then only links to pre-defined campaign will work. Campaings are defined in InitialiseSettings.php
Example
See also
| File:Wikimedia-logo black.svg | <translate> This {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is being used on one or more [[<tvar name=2>m:Special:MyLanguage/Wikimedia projects</tvar>|Wikimedia projects]].</translate> <translate> This probably means that the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is stable and works well enough to be used by such high-traffic websites.</translate> <translate> Look for this {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension's|skin's}} name in Wikimedia's <tvar name=2>CommonSettings.php</tvar> and <tvar name=3>InitialiseSettings.php</tvar> configuration files to see where it's installed.</translate> <translate> A full list of the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extensions|skins}} installed on a particular wiki can be seen on the wiki's <tvar name=ver>Special:Version</tvar> page.</translate> |
| File:OOjs UI icon information-progressive.svg |
Categories:
- Pages with script errors
- Pages with broken file links
- Stable extensions/af
- User interface extensions/af
- Page action extensions/af
- Extensions with manual MediaWiki version
- GPL licensed extensions/af
- Extensions in Wikimedia version control/af
- All extensions/af
- Extensions not in ExtensionJson
- Drafts
- Extensions used on Wikimedia/af
- WYSIWYG extensions/af
- Localisation extensions/af
- Language Engineering/af
- Content Translation/af
