View source for Extension:ContentTranslation/scn

<languages/>
{{Extension
|status        = stable
|type1         = interface
|type2         = page action
|username      = 
|author        = <span lang="en" dir="ltr" class="mw-content-ltr">[[Wikimedia Language engineering|Language team]]</span>
|description   = Armigghia ca pirmetti a l'editura di tradùciri n'artìculu di na lingua a n'àutra cu l'aiutu di traduttura autumàtici e d'àutri aiuti â traduzzioni.
|image         = 
|imagesize     = 
|update        = <span lang="en" dir="ltr" class="mw-content-ltr">Continuous updates</span>
|mediawiki     = 1.37+
|php           = 7.2+
|license       = GPL-2.0+
|download      = {{WikimediaDownload|phab=ECTX}}
|readme        = 
|changelog     = 
|tags          = 
|rights        = 
|example       = 
|compatibility policy = rel
|phabricator = MediaWiki-extensions-ContentTranslation
|table1        = cx_translations
|table2        = cx_translators
|table3        = cx_lists
|table4        = cx_suggestions
|table5        = cx_corpora
|table6        = cx_notification_log
|table7        = cx_significant_edits
|table8        = cx_section_translations
|newhook1      = SectionTranslationBeforePublish
}}
<div lang="en" dir="ltr" class="mw-content-ltr">
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 {{ll|Content translation}} for background and additional information. The extension is being developed by the Wikimedia Language Engineering team.
</div>

<span id="Installation"></span>
== Nstallazzioni ==
{{ExtensionInstall
|custom-steps0={{Note|1=This extension requires a [[#Content Translation server|CXserver]] to be setup first. Moreover it has [[#Extension dependencies|extension dependencies]].}}
|registration=required
|db-update=yes
|composer=yes
|vagrant=contenttranslation
}}

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Content Translation server ===
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">The extension needs the Content Translation server (a.k.a. cxserver) up and running.</span>
Talìa [[Content_translation/Setup]] pâ nstallazzioni dô server di Content Translation.
<span lang="en" dir="ltr" class="mw-content-ltr">When running Content Translation locally, following can be added to <code>LocalSettings.php</code> to use production cxserver:</span>

<syntaxhighlight lang="php">
$wgContentTranslationSiteTemplates['cx'] = 'https://cxserver.wikimedia.org/v1';
</syntaxhighlight>

<span id="Extension_dependencies"></span>
=== Dipinnenzi d'estinzioni ===

ContentTranslation addipenni di l'estinzioni siguenti:

{| class="wikitable"
| {{ll|Extension:UniversalLanguageSelector|UniversalLanguageSelector}}
| {{required}}
|
|-
| {{ll|Extension:VisualEditor|VisualEditor}}
| {{required}}
| <span lang="en" dir="ltr" class="mw-content-ltr">Required for editor component.</span>
|-
| {{ll|Extension:Cite|Cite}}
| {{required}}
| <span lang="en" dir="ltr" class="mw-content-ltr">Required if you want to support references while translating.</span>
|-
| {{ll|Extension:WikimediaMessages|WikimediaMessages}}
| {{required}}
|
|-
| {{ll|Extension:GuidedTour|GuidedTour}}
| {{optional}}
| <span lang="en" dir="ltr" class="mw-content-ltr">If installed, it will be used to show an explanation about moving a page out of user space.</span>
|-
| {{ll|Extension:Echo|Echo}}
| {{optional}}
| <span lang="en" dir="ltr" class="mw-content-ltr">If installed, it will be used for showing "congratulations" notifications after completing translation milestones.</span>
|-
| {{ll|Wikibase}}
| {{optional}}
| <span lang="en" dir="ltr" class="mw-content-ltr">If installed and configured similarly to Wikipedia, it will be used for automatic addition of interlanguage links (as sitelinks).</span>
|-
| {{ll|Extension:EventLogging|EventLogging}}
| {{optional}}
| <span lang="en" dir="ltr" class="mw-content-ltr">If installed, can be used to log publishing, errors, and other events.</span>
|-
| {{ll|Extension:BetaFeatures|BetaFeatures}}
| {{optional}}
| <span lang="en" dir="ltr" class="mw-content-ltr">If installed, ContentTranslation will appear as a beta feature in the preferences.</span>
|}

<div lang="en" dir="ltr" class="mw-content-ltr">
== Configuration variables ==
</div>
{{Draft-section}}
<span lang="en" dir="ltr" class="mw-content-ltr">For the full list and defaults, see [[phab:diffusion/ECTX/browse/master/extension.json|extension.json]] in the source repository.</span>

{|class="wikitable"
| ContentTranslationDomainCodeMapping
| Used to map between non-standard language codes and actual domains. The default is the same as in Wikipedia codes and domains.
|-
| 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.
|}

<div lang="en" dir="ltr" class="mw-content-ltr">
== Url parameters ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Content Translation mainly works on the special page Special:ContentTranslation. The URL parameters are
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* 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. Campaigns are defined in [https://noc.wikimedia.org/conf/highlight.php?file=InitialiseSettings.php InitialiseSettings.php] <code>wmgContentTranslationCampaigns</code> variable.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Example
</div>
* https://fi.wikipedia.org/wiki/Special:ContentTranslation?campaign=wiki-for-human-rights&page=Arja_Havakka&from=fi&to=en&targettitle=Arja_Havakka
<span id="See_also"></span>
== Talìa macari ==

* [[Special:MyLanguage/Content translation|Traduzzioni di cuntinuti]]
* [[Special:MyLanguage/Content translation/Specification|Spicìfica tècnica]]
{{OnWikimedia}}

{{feedback
|author=[[Wikimedia Language engineering]]
|ml=mediawiki-i18n
}}

[[Category:WYSIWYG extensions{{#translation:}}]]
[[Category:Localisation extensions{{#translation:}}]]
[[Category:Language Engineering{{#translation:}}]]
[[Category:Content Translation{{#translation:}}]]