Jump to content

بررسی ویرایش/پیکربندی

From mediawiki.org
This page is a translated version of the page Edit check/Configuration and the translation is 10% complete.

بررسی ویرایش offers people actionable feedback about Wikipedia policies while they are editing.

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

پیکربندی در ویکی

جستارهای وابسته: Help:Suggestion mode#For administrators
جستارهای وابسته: پیکربندی انجمن

Edit Check can be configured in some ways on-wiki by local administrators by editing the MediaWiki:Editcheck-config.json message. This will be null initially, signifying that it is unconfigured and the Edit Check defaults should apply completely.

The message must be valid JSON , or it will be ignored and the defaults will be applied. Any unspecified values will be filled in with the default values.

A summary of the configuration of Edit Check on a given wiki can be found at Special:EditChecks. JavaScript files mentioned on that special page are module filenames in the extension's code.

Generic check configuration

This can apply to any check, unless otherwise stated in that check's section. It tends to address the meta level of check functionality: account types, experience level, parts of the document, etc.

If a parameter is not used in the local configuration, then its default value is used. Default values and their per-check overrides can be found on Special:EditChecks. All of the configuration items have to match in order for a check to show. E.g. Using both inCategory and hasTemplate in a check, would require both to be true for that check to appear.

Name Type Description Default
account String, Boolean, or Object Specifies which account state the edit check should apply to. Valid values are "loggedin", "loggedout", false. The default false results in the edit check applying to all users. Use an object with checkMode and/or suggestionMode to set separate values per mode. A string or number applies only to check mode. false
maximumEditCount Integer, Boolean, or Object Specifies an upper bound for the number of edits at which this check is shown. The default 100 means that the edit check will only be shown to users with ۱۰۰ edits or fewer. The number of edits is based on user edit count and includes edits from all namespaces. Set this to false to remove the threshold. Use an object with checkMode and suggestionMode to set separate values per mode. A string or number applies only to check mode. 100
minimumEditCount Integer, Boolean, or Object Specifies a lower bound for the number of edits required before this check is shown. The default 0 means that the edit check will be shown to all users. The number of edits is based on user edit count and includes edits from all namespaces. Set this to false to remove the threshold. Use an object with checkMode and suggestionMode to set separate values per mode. A string or number applies only to check mode. 0
ignoreSections Array An array of section titles, which will be compared case-insensitively to headings. If a heading matches an item in this array, all content within that section will be ignored for checks.

Each section title has to be between ", separated by a ,: ["External links", "Unsupported claims", "Discussion"]. If an empty string is present, it refers to the lead section.

[]
ignoreLeadSection (deprecated) Boolean If true, the content of the lead section will be ignored for checks. A "lead section" is content that precedes the first heading in an article. An article without any headings doesn't have a lead section. false
includeSections Array or Boolean An array of section titles, which will be compared case-insensitively to headings. If a heading matches an item in this array, only content within those sections will be used for checks.

Each section title has to be between ", separated by a ,: ["External links", "Unsupported claims", "Discussion"].

Specify which sections this check can be shown in. An empty string is used to refer to the lead section, e.g. (['']) means only the lead section. The default false allows the check to be shown in any section.

false
ignoreDisambiguationPages Boolean If true, this check won't run on disambiguation pages. false
ignoreQuotedContent Boolean If true, this check will try to not run on content that's within quotes, or within a blockquote. It determines this by checking whether the start of a potential match is a quote-character or is within a pair of quote-characters.[1] It will also not run on content within a single template.[2] If you're editing in English it will try to accommodate single-quotes, but trailing possessive apostrophes can confuse it. false
inCategory

notInCategory

Array Specifies category names whose presence or absence in the document model determines whether a check can be shown. undefined
hasTemplate

lacksTemplate

Array Specifies template names whose presence or absence in the document model determines whether a check can be shown. undefined
showAsCheck

showAsSuggestion

Boolean Whether to be shown as a check and/or suggestion. Checks are shown on content that the user has already edited in their edit session, while suggestions are shown with lower-priority across the entire article. true

Reference check configuration

The default configuration values are as follows:

{
    "addReference": {
        "minimumCharacters": 50,
        "beforePunctuation": false,
        "account": false,
        "maximumEditCount": 100,
        "ignoreSections": [],
        "ignoreLeadSection": false
    }
}

Any of these values can be overwritten on the wiki if required. For example:

{
    "addReference": {
        "minimumCharacters": 40,
        "beforePunctuation": true,
        "ignoreSections": [ "External links", "Unsupported claims", "Discussion" ],
        "ignoreLeadSection": true
    }
}

This would change the minimum number of characters required before the Reference Check triggers to 40, have it insert its citations before the terminal punctuation rather than after, and ignore content added within the lead section and several other listed sections.

مقادیر قابل پیکربندی

These are in addition to the generic configurable values listed above.

Name Default Description
beforePunctuation false Specify whether the citation should appear before or after a sentence's terminal punctuation. Before is the style used at the French Wikipedia: "Sentence[3]." After is the style used at the English Wikipedia: "Sentence.[3]". The default is false, resulting in the style used at most Wikipedias, including the English Wikipedia.
minimumCharacters 50 (As of ۲۰۲۳) The smallest string of consecutive characters[Footnotes 1] that will prompt a recommendation to add a citation. This should generally be small enough to trigger for most additions of significant new information, but big enough not to trigger for copyediting, in the local language.

Tone check configuration

These are in addition to the generic configurable values listed above.

Name Default Description
predictionThreshold 0.8 Specify the confidence score required from the model for a Tone Check to be shown, from 0.0 to 1.0.

This isn't quite "catch x% of tone violations", but rather "of the potential tone issues the model identifies, only show Tone Check to people when the model is ≥x% confident about its assessment."

The default is 0.8, which testing suggests aligns with edit-categorization by volunteers 95% of the time.

TextMatch configuration

The TextMatch page has additional details on the textMatch feature, which can be used to create new entirely-local types of checks.

Defaults for all checks

The special * config item can be used to set default values that apply to all other checks.

This example would set all checks to show only for logged in users, with less than ۱٬۰۰۰٬۰۰۰ edits, and not in the "External links" and "References" sections. It then overrides that for the reference check, so it only shows for users with less than 10 edits.

{
    "*": {
        "account": "loggedin",
        "maximumEditCount": 1000000,
        "ignoreSections": [ "External links", "References" ]
    },
    "addReference": {
        "maximumEditCount": 10
    }
}

The final config for any given check is built by combining the defaults for that check, the * values, and the specific values for that check. Later items will override earlier ones. The individual values are not merged, and will completely replace earlier ones.

Site-level configuration

These values can be set in the site-level configuration in LocalSettings.php.

Config Meaning Default
VisualEditorEditCheck Enables the feature false
VisualEditorEditCheckTagging Tags edits made related to edit check features false

Suggestion Mode

"Checks" are shown when they relate to content that the editor has edited in their current editing session. When suggestion mode is enabled, "suggestions" will be shown across the entire article.

Suggestions can have separate account-level limits from checks for account, maximumEditCount, minimumEditCount by setting these as objects with checkMode, suggestionMode.

When plain strings or numbers are used the limits only apply to check mode.

{
    "addReference": {
        "account": {
            "checkMode": "loggedin",
            "suggestionMode": "loggedout"
        },
        "maximumEditCount": {
            "checkMode": 10,
            "suggestionMode": 0
        },
        "minimumEditCount": {
            "checkMode": 5,
            "suggestionMode": 1
        }
    }
}

A given edit check can be restricted to only appear in a certain mode with the showAsCheck and showAsSuggestion configuration values.

دریافت راهنمایی

  • هر مدیری در ویکی شما می‌تواند این را پیکربندی انجام دهد. شما می‌توانید با جستجوی عبارت Special:ListAdmins فهرستی از مدیران را در ویکی خود پیدا کنید.
  • اگر ویکی شما توسط بنیاد ویکی‌مدیا میزبانی می‌شود اما ویکی‌پدیا نیست، باید درخواست دهید که بررسی ویرایش در ویکی شما مستقر شود. لطفاً مراحل موجود در m:درخواست تغییرات پیکربندی ویکی را دنبال کنید. Tag the فابریکاتور ticket with all the following tags: #editcheck, #wikimedia-site-requests.

منابع

پانویس ها

  1. JavaScript characters, which are UTF-16 code units