Jump to content

راهنما:حالت پیشنهادی

From mediawiki.org
This page is a translated version of the page Help:Suggestion mode and the translation is 59% complete.
برای اطلاعات فنی دقیق، ویرایشگر دیداری/حالت پیشنهادی را ببینید.

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

از اوایل سال ۲۰۲۶، همه انواع پیشنهادها به عنوان یک ویژگی بتا در دسترس هستند تا از ویرایشگران باتجربه بازخورد جمع‌آوری شود. در آینده نزدیک، اکثر انواع به طور پیش‌فرض برای تازه‌واردان و/یا بسته به نحوه پیکربندی هر نوع توسط مدیران محلی، برای ویرایشگران باتجربه در دسترس خواهند بود.

برای ویراستاران - فهرست انواع پیشنهاد

افزودن پیوند

این پیشنهاد، یک پیوند بالقوه به مقاله‌ای دیگر را برجسته می‌کند. این پیوندها توسط یک الگوریتم ماشین پیشنهاد می‌شوند و ماشین‌ها بی‌نقص نیستند! پیوندهای پیشنهادی حدود ۷۵٪ صحیح هستند، اما باید توسط انسان بررسی شوند. این پیشنهادها ممکن است شامل کلماتی باشند که نیازی به پیوند ندارند یا ممکن است به مقاله اشتباهی پیوند داده باشند. از قضاوت خود برای تصمیم‌گیری در مورد درست یا غلط بودن آنها و مفید بودنشان برای سایر خوانندگان استفاده کنید.

ممکن است مستندات محلی بیشتری به زبان شما از طریق موارد زیر موجود باشد:

تبدیل ارجاع

این پیشنهاد، ارجاعاتی را که صرفاً پیوندهای ساده هستند، برجسته می‌کند. می‌توانید روی دکمه‌ی «تبدیل» کلیک کنید تا به‌طور خودکار ارجاع دقیق‌تری ایجاد شود. این ابزار تلاش می‌کند تا فراداده‌هایی مانند نویسنده و تاریخ انتشار را در مقصد پیوند جستجو کند.

شما باید جزئیاتی را که ابزار پر می‌کند بررسی کنید تا قبل از انتشار ویرایش خود، از صحت آنها اطمینان حاصل کنید.

ممکن است مستندات محلی بیشتری به زبان شما از طریق موارد زیر موجود باشد:

پیوندهای ابهام‌زدایی

این پیشنهاد پیوندهایی را برجسته می‌کند که به صفحات ابهام‌زدایی اشاره دارند (که به خوانندگان کمک می‌کنند تا در مواقعی که یک عنوان می‌تواند به چندین موضوع ممکن اشاره کند، پیمایش کنند). پیوندها به صفحات ابهام‌زدایی از درون محتوای اصلی مقالات ویکی‌پدیا معمولاً خطا هستند. این پیوندها معمولاً با پیوند دادن به صفحه‌ای با عنوان خاص‌تر که می‌توان در صفحه ابهام‌زدایی یافت، قابل اصلاح هستند.

برای مثال، اگر صفحه‌ای دارای پیوندی در عبارتی مانند «یک نوع مجموعه ریاضی» باشد، اما «مجموعه» به یک صفحه ابهام‌زدایی پیوند می‌دهد، آنگاه می‌توان پیوند را تصحیح کرد تا به مقاله خاص‌تری با عنوان «مجموعه (ریاضیات)» اشاره کند و در عین حال برچسب پیوند «مجموعه» را حفظ کند.

ممکن است مستندات محلی بیشتری به زبان شما از طریق موارد زیر موجود باشد:

پیوندهای تکراری

این پیشنهاد زمانی برجسته می‌شود که بیش از یک پیوند به یک صفحه مقصد در نزدیکی هم وجود داشته باشد. در محتوای نثر نوشتاری، ترجیحاً فقط یک بار در هر بخش اصلی به یک اصطلاح/مقصد لینک داده شود. این به خوانندگان کمک می‌کند تا درک کنند که هر لینکی نشان‌دهنده «زمینه جدیدی» است که ممکن است بخواهند از آن بازدید کنند.

ممکن است مستندات محلی بیشتری به زبان شما از طریق موارد زیر موجود باشد:

پیوندهای خارجی

این پیشنهاد زمانی برجسته می‌شود که یک پیوند خارجی به سایتی در جای دیگری از اینترنت در محتوای اصلی یک مقاله ظاهر شود. پیوندهای خارجی معمولاً نباید در بدنه مقاله قرار گیرند، مگر به عنوان استنادهایی که به تأییدپذیری کمک می‌کنند، یا در پایین مقاله اگر پیوندهای رسمی مرتبط باشند.

ممکن است مستندات محلی بیشتری به زبان شما از طریق موارد زیر موجود باشد:

سطوح عنوان

این پیشنهاد نشان می‌دهد که چه زمانی ممکن است سطوح عنوان از ساختار ترتیبی صحیح پیروی نکنند. عنوان‌ها باید به صورت تو در تو قرار گیرند، از سطح ۲ (==) برای عنوان‌های اصلی شروع می‌شوند، سپس سطح ۳ (===) برای عنوان‌های فرعی و به همین ترتیب. عنوان‌های سطح ۱ به طور خودکار برای عنوان مقاله رزرو شده‌اند و نباید در متن بدنه مقاله ظاهر شوند.

برای مثال (نشان دادن نشانه‌گذاری منبع ویکی‌متن برای وضوح):

نمونه‌هایی از استفاده صحیح و نادرست از عناوین تو در تو
صحیح نادرست

[اینجا مقدمه مقاله]
== بخش == [سطح ۲]
=== زیر-بخش === [3]
== بخش == [2]
=== زیر-بخش === [3]
==== زیر-زیر-بخش ==== [4]
== بخش == [2]

[اینجا مقدمه مقاله]
==== بخش؟ ==== [4]
=== بخش؟ === [3]
== بخش؟ == [2]
== بخش؟ == [2]
==== بخش؟ ==== [4]
=== بخش؟ === [3]

ممکن است مستندات محلی بیشتری به زبان شما از طریق موارد زیر موجود باشد:

زیرنوشت تصویر ناموجود

این پیشنهاد تصاویری را که زیرنوشت ندارند، برجسته می‌کند. زیرنوشت متنی است که در زیر تصویر کوچک ظاهر می‌شود. اکثر زیرنوشت‌ها توجه را به چیزی در تصویر جلب می‌کنند که آشکار نیست، مانند ارتباط آن با متن. زیرنوشت ممکن است چند کلمه یا چند جمله باشد. نوشتن زیرنوشت‌های خوب تلاش می‌خواهد؛ در کنار عنوان و سرعنوان‌های بخش، زیرنوشت‌ها رایج‌ترین کلمات خوانده شده در یک مقاله هستند، بنابراین باید مختصر و آموزنده باشند.

ممکن است مستندات محلی بیشتری به زبان شما از طریق موارد زیر موجود باشد:

پیوند سال

گاهی اوقات ویرایشگر قبلی تلاش کرده است تا یک پیوند را به‌روزرسانی کند، اما آنها فقط برچسب پیوند را تغییر داده‌اند. این ممکن است یک تصادف یا خرابکاری بوده باشد. شما می‌توانید با بررسی اینکه به کدام سال اشاره شده است و سپس اطمینان از مطابقت پیوند و برچسب پیوند، به رفع این موارد کمک کنید. اگر مطمئن نیستید، در صفحه بحث مقاله بپرسید.

برای ویراستاران باتجربه - برچسب‌های بازبینی

جستارهای وابسته: Edit check/Tags

شما می‌توانید ویرایش‌هایی را که توسط فردی انجام شده‌اند که یک پیشنهاد را دیده یا از آن استفاده کرده است، در بخش تغییرات اخیر و فهرست پیگیری خود بررسی کنید.

برچسب‌های زیر موجود است:

  • Editsuggestion-seen: احتمالاً حداقل یک پیشنهاد ویرایش توسط کاربر مشاهده شده است
  • Editsuggestion-used: حداقل از یک دکمه پیشنهاد ویرایش به عنوان بخشی از ویرایش استفاده شده است

انواع دیگری از برچسب ویرایش در حال توسعه هستند.

برای مدیران - شخصی‌سازی محلی

مدیران می‌توانند هر نوع پیشنهاد موجود را پیکربندی کنند. پیکربندی‌های موجود در هر ویکی در صفحه Special:EditChecks آنها فهرست شده‌اند و می‌توانند در صفحه json پیوند داده شده تنظیم شوند. برای مستندات مربوط به پارامترهای موجود که می‌توانند تغییر داده یا اضافه شوند، به بررسی ویرایش/پیکربندی مراجعه کنید.

Configuration happens on a per-wiki basis so that volunteers can ensure each Suggestion aligns with local policies and conventions and is integrated with existing moderation processes.

The aspects of a Suggestion that are community configurable will vary on a case-by-case basis.

Create a local configuration page

Each wiki needs to define some basic details, such as which standard "section heading" titles to exclude from each type of default suggestion. You should create a page for this at your local MediaWiki:Editcheck-config.json. For example, below is a good default to start with, after you replace the "heading names" with your local language versions, plus add any additional headings (in lower-case). The last entry in each array (list) must not include a comma. The example below, in Spanish, excludes the "external links", "notes", "references", and "see also" headings from two types of suggestion.

{
	"addReference": {
		"ignoreLeadSection": true,
		"ignoreSections": [
			"enlaces externos",
			"notas",
			"referencias",
			"véase también"
		]
	},
	"externalLink": {
		"ignoreSections": [
			"enlaces externos",
			"notas",
			"referencias",
			"véase también"
		]
	},
	"disambiguation": {
		"ignoreSections": [
			"véase también"
		],
		"ignoreDisambiguationPages": true
	}
}

Most types of Suggestion have one or more associated links for the editor to learn, or to be reminded, of relevant documentation. By default these links point to this page. If your community has a relevant local documentation page about a suggestion type, you should override the default links. You need to use the same protocol-relative partial URLs that the default is using (not short internal wikilinks) for technical reasons. See this example edit for reference.

The links for each type are located on your wiki at these locations:

  • Convert reference
    • MediaWiki:Editcheck-convertreference-descriptionlink
  • Link to a more specific page
    • MediaWiki:Editcheck-disambiguation-descriptionlink
  • Remove unnecessary bold formatting
    • MediaWiki:editcheck-double-bold-descriptionlink
  • Remove duplicated link
    • MediaWiki:Editcheck-duplicate-link-descriptionlink
  • Remove external link
    • MediaWiki:Editcheck-external-link-descriptionlink
    • MediaWiki:Editcheck-external-link-convertlink (second link)
  • Adjust heading level
    • MediaWiki:Editcheck-headinglevel-descriptionlink
  • Add image caption
    • MediaWiki:Editcheck-image-caption-descriptionlink
  • Revise Tone?
    • MediaWiki:Editcheck-tone-descriptionlink
  • Add a link
    • MediaWiki:Editcheck-suggestedlink-descriptionlink


Create custom local types of Suggestions

Each community can create custom Suggestions. TextMatch is a locally-customizable feature that enables creating community-determined edit checks. It searches for predetermined queries and, when a match is found, displays the regular edit check dialog along with the corresponding message, title, and actions for that query.

Your community can create anything. Example ideas: Detect cliches or idioms, or relative-time references, that normally should not appear in encyclopedic writing; plus, teach the editor about local writing guidelines.

See the TextMatch documentation page for configuration options and a few specific examples.

Other communities are expanding their configuration to include local TextMatch suggestions, for example:

  • w:ru:Special:EditChecks - common grammar-error, potential LLM-usage indicators, potential advertisement, tautology and non-neutrailty, parasitic words, non-specific time detection, contractions, old country names, typos, punctuation error, wrong-named sections fixes, infobox information in article detection, soccer-related fixes, and more
  • w:he:Special:EditChecks - common typo detection
  • w:cs:Special:Editchecks - common typo detection, inappropriate writing-tone detection, relative-time keyword detection, second-person verb usage detection, cliché detection, and more
  • w:en:Special:EditChecks - potentially inappropriate spelling in British-English articles detection, potential LLM-usage indicators detection
  • Beta Cluster's examples - cliché detection, relative-time keyword detection, editorializing keyword detection, and more

If you have ideas for new types of Suggestion that are more complex than can be achieved with TextMatch, and require custom code, please add your ideas to the list.

Importing rules

You can split the main configuration file (MediaWiki:Editcheck-config.json) into smaller modules. You can find an example module on enwiki: w:MediaWiki:Editcheck-config-textmatch-british-english.json.

Example of importing text-matching config-modules into the main config file:

{
	"textMatch": {
		"matchItems": {
			"british-english": {
				"import": "MediaWiki:Editcheck-config-textmatch-british-english.json"
			},
			"other-rule-code-name": {
				"import": "MediaWiki:Editcheck-config-textmatch-other-rule.json"
			}
		}
	}
}

Experimental Suggestions

A Suggestion can be configured as Experimental by setting both showAsCheck and showAsSuggestion to false. Experimental Suggestions are only shown to users who have opted-in to the user-preference.

(The user-preference is an upcoming feature)

بازخورد

If there are particular aspects of Suggestions that you think need to be configurable on-wiki, please share what you are thinking in T327959 or on the project talk page.

برای مترجمان

You can help to translate the guidance that is shown to editors via translatewiki.

همچنین ببینید