Extension:ContentTranslation

راهنمای افزونهٔ مدیاویکی

ContentTranslation وضعیت انتشار: پایدار
انجام	رابط کاربری, Page action
توضیحات	ابزاری است که به ویرایشگران امکان می‌دهد تا مقاله‌ای را با کمک ترجمهٔ ماشینی و سایر ابزارهای ترجمه، از یک زبان به زبان دیگر ترجمه کنند.
نویسنده(گان)	گروه زبان
سیاست سازگاری	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.37+
PHP	7.2+
تغییر پایگاه داده	بله
Composer	mediawiki/content-translation
Virtual domain	virtual-cx
جدول‌ها cx_translations cx_translators cx_lists cx_suggestions cx_corpora cx_notification_log cx_significant_edits cx_section_translations
پارامترها $wgContentTranslationVersion $wgContentTranslationContentImportForSectionTranslation $wgContentTranslationDomainCodeMapping $wgContentTranslationCXServerAuth $wgContentTranslationCxServerHost $wgContentTranslationEnableAnonSectionTranslation $wgContentTranslationFeaturedCollectionLink $wgContentTranslationAsBetaFeature $wgContentTranslationTranslateInTarget $wgContentTranslationDevMode $wgRecommendToolAPIURL $wgDraftMaxAge $wgContentTranslationFeaturedCollectionDescription $wgContentTranslationEnableMT $wgContentTranslationFeaturedCollection $wgAutomaticTranslationLanguageSearcherEntrypointEnabledLanguages $wgContentTranslationSiteTemplates $wgContentTranslationUnmodifiedMTThresholdForPublish $wgContentTranslationTargetNamespace $wgContentTranslationPublishRequirements $wgContentTranslationCampaigns $wgSectionTranslationTargetLanguages
Hooks used BeforeCreateEchoEvent BeforePageDisplay ChangeTagsListActive ContributeCards EchoGetBundleRules EditPage::showEditForm:initial GetBetaFeaturePreferences GetPreferences ListDefinedTags LoadExtensionSchemaUpdates ResourceLoaderRegisterModules SaveUserOptions SectionTranslationBeforePublish SkinAfterContent SpecialContributionsBeforeMainOutput
Hooks provided SectionTranslationBeforePublish
Licence	پروانۀ همگانی گنو ۲٫۰ یا بعدتر
بارگیری	Download extension Git [?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball
راهنما	Help:Extension:ContentTranslation/fa
Translate the ContentTranslation extension if it is available at translatewiki.net
Issues	Open tasks · گزارش یک مشکل

افزونه ترجمهٔ محتوا ابزاری است که به ویرایشگران امکان می‌دهد تا مقاله‌ای را با کمک ترجمهٔ ماشینی و سایر ابزارهای ترجمه، از یک زبان به زبان دیگر ترجمه کنند. برای اطلاعات بیشتر، ترجمه محتوا را ببینید. این افزونه توسط تیم مهندسی زبان ویکی‌مدیا توسعه یافته‌است.

نصب‌کردن

This extension requires a CXserver to be setup first. Moreover it has extension dependencies.

• Download and move the extracted ContentTranslation folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ContentTranslation
  

• Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See T173141 for potential complications.)
• کد زیر را در انتهای $LocalSettings خودتان اضافه کنید:

  wfLoadExtension( 'ContentTranslation' );
  

• اسکریپت به‌روزرسانی اجرا کنید تا به طور خودکار جدول‌های پایگاه داده‌ها ضروری که این افزونه نیازمند دارد را ایجاد کند.
• انجام شد – به Special:Version در ویکی خودتان بروید تا مطئمن شوید که افزونه با موفقیت نصب شده است.

Vagrant installation:

• اگر از Vagrant استفاده می‌کنید، با vagrant roles enable contenttranslation --provision نصب کنید

Content Translation server

The extension needs the Content Translation server (a.k.a. cxserver) up and running. 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';

وابستگی‌های افزونه

ترجمهٔ محتوا وابسته به افزونه‌های زیر است:

UniversalLanguageSelector	Required
VisualEditor	Required	Required for editor component.
Cite	Required	Required if you want to support references while translating.
WikimediaMessages	Required
GuidedTour	Optional	If installed, it will be used to show an explanation about moving a page out of user space.
Echo	Optional	If installed, it will be used for showing "congratulations" notifications after completing translation milestones.
Wikibase	Optional	If installed and configured similarly to Wikipedia, it will be used for automatic addition of interlanguage links (as sitelinks).
EventLogging	Optional	If installed, can be used to log publishing, errors, and other events.
BetaFeatures	Optional	If installed, ContentTranslation will appear as a beta feature in the preferences.

Configuration variables

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.
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. Campaigns are defined in InitialiseSettings.php wmgContentTranslationCampaigns variable.

نمونه

• https://fi.wikipedia.org/wiki/Special:ContentTranslation?campaign=wiki-for-human-rights&page=Arja_Havakka&from=fi&to=en&targettitle=Arja_Havakka

جستارهای وابسته

• ترجمهٔ محتوا
• مشخصات فنی