帮助:Twinkle

H:TW

Twinkle是一个基于JavaScript的工具，有助于提高编者进行维护工作的效率。关于Twinkle的详细资讯和安装方法，请参见维基百科:Twinkle。请注意，本地化的Twinkle无法在Internet Explorer上运作。

当您完成安装Twinkle后，您在打开不同页面时，会在页面顶部出现TW标识，并看到一系列不同的选项卡或链接。

安装

安装Twinkle很简单，请参考维基百科:Twinkle中的指示。

在您开始使用Twinkle前，您应该认真阅读此页以了解Twinkle的功能及使用时机。有许多的配置选项允许您更改Twinkle的默认行为。

注意：不要忘了，您对于Twinkle所有操作造成的后果负有责任。您必须了解维基百科的方针与指引并且在方针的约束下使用Twinkle，否则您可能会被封禁。

练习使用Twinkle

有几个沙盒能帮助您测试Twinkle的强大功能：

测试条目标记，请使用沙盒。
测试用户页相关功能（警告用户、以及Talkback），请使用用户讨论页警告沙盒。

注意：请不要在上述沙盒执行提删，或者请求保护的操作，因为这些会真的通知到管理，且不要在沙盒页面进行取消连入的操作，因为这将移除所有到沙盒的链接。要测试这些功能建议您去Beta站开启名为“Twinkle测试版本。”的小工具做测试。

安装故障解答

Twinkle安装失败的可能原因：

您必须已登录，并且至少获得自动确认用户权限。
您必须使用支持的浏览器，Twinkle不支持旧版的Internet Explorer。
如果您使用旧版本的Opera、Safari或者Firefox浏览器，请尝试启用JavaScript标准库，位于系统设置页面的小工具选单中。
安装之后，您可能需要清除您的浏览器缓存。
如您进行了手动安装，需要提醒您Twinkle必须安装在您的skin.js文件（不是.css）中。
如果您没有使用小工具并更换了皮肤，请确保您的脚本文件有导入 Twinkle 组件。
如果您使用Windows且正在使用触屏，您可能需要长按“TW”按钮来显示菜单。

如果您尝试了上方的建议，但仍无法使用Twinkle，或者您发现有其他问题，请至Twinkle工具讨论处。并且如有必要，请将问题发布于此。如果您要这样做，请提供以下资讯：

您看到了什么？
您希望看到什么？
怎样才能重现错误的内容或者行为？请准确说明您做了和看到什么。
确认您已经清除过浏览器缓存。
注明您的浏览器及其版本、操作系统及其版本。
注明您浏览器显示的JavaScript错误内容。这一点可以在浏览器的错误控制台或者JavaScript控制台找到，复制相关的错误资讯。以下是各浏览器错误控制台的位置：
- Firefox：菜单→工具→故障控制台（或Firefox按钮→网络开发者→错误控制台）。您应该按位于上方的“错误”按钮来隐藏可以忽略的大量警告。
- Opera：菜单→页面→开发人员工具→错误控制台。
- Chrome：页面菜单→开发人员→JavaScript控制台（Ctrl+Shift+J）。
- Safari：页面菜单→开发→显示错误控制台（Ctrl+Alt+C 或 Shift+Command+J）。您可能需要先在偏好设置→高级中启用它。

我们强烈建议您阅读http://www.chiark.greenend.org.uk/~sgtatham/bugs.html以获得关于如何有效地报告错误的建议，以确保你所描述的问题可以被尽快解决。

安装单独的Twinkle模块

在早期版本，Twinkle允许单独安装一些模块，但目前已无法再通过此方法安装，请改用此链接提供的方法来安装。

模块

Twinkle被设计成一个以数个模块呈现的工具，每个模块都对特定的任务提供了更快的解决方案。这些模块可以通过页面顶部的标签来访问（在Monobook皮肤中），或者在靠近搜索框的“TW”弹出式菜单中（在Vector皮肤中）。

速删

速删代表快速删除（CSD，Criteria for Speedy Deletion）。如果您认为文章符合快速删除的标准之一，您可以使用Twinkle的这个功能来提请速删。

使用方法

点击“速删”按钮。您将可以看到一个速删原因列表，这取决于不同名称空间而有所不同。在过去，当您选择了一项理由后，Twinkle就会立即提请速删；现在您必须在选择理由后点击提删按钮。关于这一点，可以在Twinkle设置中修改。如果需要额外资讯（比如说理由等等）时，Twinkle可能会提示您。然后Twinkle就会在页面上标示适合的速删模板。

如果您选中了如果可能，通知页面创建者，根据快速删除方针，页面创建者将会收到警告模板。如果创建者的讨论页不存在，同时对方也会收到欢迎消息（但会使用{{firstarticle}}模板）。在一般情况下，不用取消勾选“通知页面创建者”；然而，有时候必须考虑到，通知用户并不适合，所以要小心使用。
应用多个理由选项位于窗口上方。当其被选中时，所有理由前的单选框将变为复选框，以便您标记多个理由。当标记完成后，点击“提交”将更改应用到页面中。
在您的Twinkle设置中，您可以开启CSD用户空间日志。此功能将在您的用户命名空间下记录您提报过的所有快速删除记录。由于已删除页面并不会出现在您的用户贡献中，所以非管理员用户仅能通过此方法来查看其标记过的快速删除页面，并检查其中有多少个已被删除。它也可用来检查被驳回的速删请求（页面内蓝色的连接），并从中提升您标记的质量。
在标记一个快速删除时，其页面默认不会加入到您的监视列表中。您可以在参数设置中启用它，或是选择在您使用哪些理由时才自动加入。另外，如果一个拥有巡查权的用户从Special:最新页面进入条目，在标记速删时页面会默认地被标记为已巡查。当然，您也可以在参数设置中禁用它。

注意

Twinkle的速删功能提供了一套简单的在页面悬挂速删模板的方法。然而，要时刻提醒自己你在使用Twinkle对维基百科造成的所有更改负有责任，所以在用Twinkle将页面悬挂速删模板前请再三思考，并且要记住不要伤害新手。
当标注某些标记时（如Wikipedia:G8和Wikipedia:G15）Twinkle不会通知页面创建者。这是出于避免额外打扰页面创建者的目的，或者可能适得其反。如果您真的想用它们，可以在您的Twinkle设置中设置使用哪些速删理由时通知页面创建者，但请注意某些警告模板实际上并不存在。

管理员附加功能

管理员可以使用Twinkle来删除页面（且可使其讨论页和重定向页一并删除），在执行删除前可以修改删除原因。

保护

请求页面保护（RFPP，Request for Page Protection），此功能可用于请求保护或解除保护当前页面，通常用于被严重破坏的页面或是可能因现实事件而导致的高流量页面。

使用方法

点击“保护”按钮。您需要先选择操作类型，这会影响接下来的选项。

请求保护页面：如果您想要经由Wikipedia:RFPP来请求保护的话，请使用此选项。您必须选择保护类型，接着选择保护期限（永久或暂时）并可在下方字段写明理由。
用保护模板标记此页：您将可以选择标记选项。您可以选择保护模板，或是
- 勾选使用图标（small=yes），这会在条目右上方显示一个小锁图案来取代文字模板
- 选择用<noinclude>包裹保护模板，以避免保护模板被包含嵌入到其他页面。

注意

当您在一个尚未被建立的条目按下保护功能时，您将无法选择用保护模板标记此页，而仅能提交请求保护页面（请求增加或解除白纸保护）。

管理员附加功能

管理员会拥有额外选项来对页面实施保护，而非只是提出请求。

提删

XfD（Anything for Deletion）是维基百科内用来讨论某个页面是否应该被删除的场所的总称。您可以使用Twinkle工具对任何页面快速地发起一个删除讨论。

请参阅WP:XFD#特别情况来选择一个适合的讨论空间。

一旦运行XfD工具，Twinkle会标记提删模板到页面上、创建删除讨论（这可能会建立一个新的存废讨论页面）、在页面创建者的讨论页上通知（如果您选择了此项）。

使用方法

点击提删按钮。在显示的窗口中，您可以选择提删讨论空间。Twinkle的默认选择通常是正确的，但有时仍会出错。

当选择了一个适合的讨论空间后，以下选项将会显示：

页面存废讨论（AfD，Article for Deletion）
- 使用<noinclude>包裹模板：此选项几乎不常用到，除非页面被嵌入包含；
- 选择提删类别：默认为“删除”，当您认为您提删的目的不是删除而另有其它方案时，更改此项；
  - 合并到：当上一步的提删类别被选为“合并”时可用，在此填入当前条目需要合并到的目标条目。
文件存废讨论（FfD，File for Deletion）没有额外选项。

以下选项适用于所有删除情况：

当如可能，通知页面创建者被选中时，会使得Twinkle发送一个通知到页面创建者的讨论页上。通常此选项应该被选中，但不是每次都应被选中，特别是针对破坏者时。
当然，您必须为此次提删指定一个理由。您可以在理由中使用任何维基语法。
如果您在参数设置中设置了相关参数，被提删页面将会加入您的监视列表中。默认不会有页面因为提删而被加入监视列表。您可以在参数设置面板中找到更多资讯。
在您的Twinkle设置中，您可以开启AFD用户空间日志。此功能将在您的用户命名空间下记录您的所有提删记录。

注意

在进行页面存废讨论时，Twinkle可能会很慢，特别是在日期列表加入讨论时；原因目前未知。如果Twinkle在进行XfD时卡住没有反应，请保持耐心。在某些情况下，你可能会需要等待一段时间才能完成操作。

附加工具

Twinkle包含供关闭存废讨论的工具，但他默认是关闭的。如果您想使用，请在参数设置中手动开启。

最后

这个选项向您展示了现今页面和先前页面的差异。此外，当您在查看差异时，Twinkle将会额外显示“自上”、“自我”、“当前”选项。

取消连入

取消连入，简称消连，这个选项将会解除反向链接。反向链接指的是从其他页面指向一特定页面的链接。操作时会解除某些术语与这个特定页面的链接，这通常在某一条目被快速删除被使用，以避免不符关注度、破坏、或有其他问题的条目被重新建立。它可以避免删除页面后，在其他各条目看到大量红字链接的情况。依据被删除的条目，您有可能会想要或不想要解除反向链接。

标记

标记功能会将您选择的模版加入页面或建立重定向。

您选择的所有模版标记将会自动地被添加到合适的位置中。标签支持自动添加date（日期）项。如果选择了“如可能，合并入{{multiple issues}}”这个选项，那么Twinkle就会尝试将所有模版合并到{{Multiple issues}}中，前提是您选择了三个以上的模板。如果您选择的模板不足三个，那么该选项会被忽略。

{{globalize}}和{{notability}}可以加选子分类，但不是必须的，只是这样可以更明确地展示出条目的问题。

如果您正在一个重定向页中，该视窗就会显示适用于重定向页的模版标签选项，这些模版是来自Category:重定向模板。

小作品

与标记类似的功能，不过是标记小作品模板。

图权

图权用于没有合理来源或著作权的图像。

警告［用户讨论页］

警告功能允许您在该用户的讨论页上留下警告消息。

使用方法

先点击警告按钮（这个按钮只会在用户空间时显示），一个带有以下选项的视窗将会出现：

两个拖曳式菜单（警告层级和警告类别，参见 Wikipedia:模板消息/用户讨论命名空间）
条目名称（如果您在使用了 Twinkle 回退后跳出的用户讨论页上执行警告时，此字段会自动填入）
留言（选填）将会被包含在警告模板当中。

点击提交后即会在该用户讨论页上加入您选择的警告模板，然后您的浏览器会刷新页面。

通告

通告功能让您可以在其他用户的讨论页上留下通知模板。它支持大多数的可用模板，就如同您手动加入模板一样。

目前支持以下模板：

{{talkback}}
{{you've got mail}}

更多模板可能在未来陆续加入。

告状

告状功能让您可以将该用户报告给管理员，包括长期破坏、不恰当用户名、用户查核。

使用方法

先点击告状按钮（这个按钮只会在用户空间时显示），一个带有以下选项的视窗将会出现：

选择报告类型：
- 破坏（WP:VIP）：如果该用户时常破坏，您可以利用此功能将该用户提报到维基百科:当前的破坏。
  - 相关页面：填入条目名称，可留空（若留空则建议于下方说明提报理由）。
  - 受到破坏的修订版本：填入遭破坏的版本编号。版本编号可由网址查看，为oldid=后的8码数字。
  - 破坏前的修订版本：填入正常版本的版本编号。
  - 并选择提报理由：
    - 已发出最后（层级4或4im）警告、封禁过期后随即破坏、显而易见的纯破坏用户、显而易见的spambot或失窃账户、仅用来散发广告宣传的用户
- 用户名（WP:UAA）：如果该用户疑似违反用户名方针，您可以利用此功能将该用户提报到维基百科:管理员布告板/不当用户名。
  - 选项包含：误导性用户名、宣传性用户名、暗示并非由一人拥有、侮辱性用户名、破坏性用户名。
- 用户查核-主账户（WP:RFCU）
- 用户查核-傀儡（WP:RFCU）
  - 如果您怀疑某位用户违反傀儡方针，您可以使用此二功能将该用户提报到维基百科:用户查核请求
    - 如果您怀疑此用户滥用傀儡，请选择用户查核-主账户（WP:RFCU）并填入傀儡的用户名。如果字段不够可以点击更多按钮来新增。
    - 如果您怀疑此用户为其他用户的傀儡，请选择用户查核-傀儡（WP:RFCU）并填入主账户的用户名。
  - 如果您选择通知相关用户，会在所有提及用户的讨论页上留下用户查核的通知消息。
但小心，若是你在你的用户页上执行，会跳出“你不想报告你自己，对吧？”。

撤销与回退

在比较一个条目的多个版本时，Twinkle会在页面上部加上四个链接。（执行以下三种回退时，若该编者有连续编辑的纪录将会全部回退，若要回退单一版本请改用撤销功能）

恢复此版本：此选项放置在旧版本上，将此版本后的所有更改全部撤销。可自定义编辑摘要。
回退（AGF）：此选项放置在最新版本上，执行回退，编辑摘要包含 AGF 也可以自定义。默认编辑摘要会填入“回退XXX (讨论)做出的出于善意的编辑。”。屏幕截图参见英文维基图片。
回退：此选项放置在最新版本上，执行回退，要求输入编辑摘要。编辑摘要为“回退到由XXX (讨论)做出的修订版本XXX：<理由>。”
回退（破坏）：此选项放置在最新版本上，执行回退。此种回退的编辑摘要会显示“回退XXX (讨论)做出的 X 次编辑，到由XXX做出的前一个修订版本”，不可自行输入。

欢迎

此功能将根据您的参数设置，自动使用“自动欢迎时使用的模板”设置中指定的欢迎模板，或者使用Twinkle的欢迎对话框打开用户的讨论页面(默认情况下)。当在所有命名空间中查看差异时，此功能均可用。

管理员专用模块

管理员除了在某些主模块上有额外功能之外，他们也拥有一些额外的模块：

批量删除（Batch deletion ("D-batch")）：这一模块可让您根据以下条件批量删除部分或全部的页面：
1. 一个页面上的链接。在该页面上从TW菜单选择批删。
2. 前缀索引。在Special:前缀索引上从TW菜单选择批删。
3. 分类子页面。在该分类页上从TW菜单选择批删。
并取消条目上的链接且删除该页面的讨论页、重定向页。大量关闭 AfD 时适合使用此模块，但由于删除过程自动进行，所以在使用时应谨慎。您完全了解它的处理过程，否则可能会因滥用而导致严重破坏。在某些情况下，这可能不是最好的处理方法。在删除摘要后带有“(批量)”后缀。
批量反删除（Batch undeletion ("Und-batch")）：与批量删除类似，但是执行反删除操作而非删除操作。此功能仅用于用户的子页面，所以您必须先在用户空间包含嵌入或是建立一个页面列表。在删除摘要后带有“(批量)”后缀。

设置

最方便的设置Twinkle的方法是使用参数设置面板（见维基百科:Twinkle/参数设置）。

技术细节

Twinkle通过在Special:MyPage/twinkleoptions.js建立一个JSON文件来保存您的参数设置，在您每次加载页面时它会自动加载。（看起来这会损失部分性能，但是您的浏览器会自动缓存此文件，所以您不需要每次都下载这个文件。）

如果参数设置面板工作异常，或者您想自行调整某些高级参数设定，您可以手动编辑Special:MyPage/twinkleoptions.js。其格式如下（不精通JavaScript的用户请格外注意）：

window.Twinkle.prefs = {
  "twinkle": {
    // 将所有个人设置放在此处，除了共享IP 标记、标记页面、欢迎及回复相关的设置
    // 例如：
    revertMaxRevisions: 13,
    summaryAd: " BTW, I use [[WT:TW|Twinkle]].",
    proddeleteChunks: 20
  },
  "friendly": {
    // 将共享IP 标记、标记页面、欢迎及回复相关的设置放在此处
    // 例如：
    watchTaggedPages: true,
    talkbackHeading: "Talkback just for you..."
  }
};

高级参数

如果您的浏览器没有遭到数据库封锁或网络链接超时的情况下不能或难以执行操作，则可以方便地调整这些参数。高级参数不包含在参数设置面板中，因此必须通过手动编辑Special:MyPage/twinkleoptions.js来实现。

普通用户可更改以下参数

revertMaxRevisions: 在查找要回退的上一个修订版本时，要查询的最大修订数。伺服器限制为50。默认值是50.

管理员可以更改以下参数

batchChunks: 定义在执行批量处理删除/取消删除时一次应处理多少页。伺服器限制为50。建议您不要更改此参数。默认值是50.
batchDeleteMinCutOff: Defines how many current pages should be left in the process of being deleted before a new batch is allowed to be initialized. 建议您不要更改此参数。默认值是5.
batchMax: Defines how many pages should be processed at most by any batch function. 建议您不要更改此参数。默认值是5000.
batchProtectChunks: Defines how many pages should be processed at a time when performing batch protections. The server limit is 50. 建议您不要更改此参数。默认值是50.
batchProtectMinCutOff: Defines how many current pages should be left in the process of being protected before a new batch is allowed to be initialized. 建议您不要更改此参数。默认值是5.
batchUndeleteMinCutOff: Defines how many current pages should be left in the process of being undeleted before a new batch is allowed to be initialized. 建议您不要更改此参数。默认值是5.
deliChunks: Defines the number of images that will be processed at a time when doing a batch deletion. 建议您不要更改此参数。默认值是500.
deliMax: Defines the maximum number of images that will be processed when doing a batch deletion. 建议您不要更改此参数。默认值是5000.
proddeleteChunks: Defines how many pages should be processed at a time when performing batch prod deletions. The server limit is 50. 建议您不要更改此参数。默认值是50.

Twinkle菜单的位置和布局

Vector皮肤中Twinkle菜单的默认位置在下拉菜单中，而在所有的其他皮肤，则显示在选项卡的顶部。如果您愿意，可以通过在您的twinkleoptions.js中手动设置一些选项来更改页面上Twinkle菜单的位置和布局：

"portletArea" "portletId" "portletName" "portletType" "portletNext"

例如，如果要将菜单移动到屏幕左侧的工具菜单，请将"portletId": "p-tb",这一行添加到您的twinkleoptions.js中，如下所示：

window.Twinkle.prefs = {
  "twinkle": {
    // ...
    "portletId": "p-tb",
    // ...
  },
  // ...
};

如果您希望将菜单内的选项单独显示为选项卡，如在monobook皮肤中所示，请在您的twinkleoptions.js中添加"portletId": "p-views",这一行，如下所示：

window.Twinkle.prefs = {
  "twinkle": {
    // ...
    "portletId": "p-views",
    // ...
  },
  // ...
};

portletId is the ID of the portlet you'd like the menus to appear in. In these case, 'p-tb' indicates the toolbar, while 'p-views' indicates the menu bar. For a full list see the catalogue of CSS classes).

Alternatively, you can create a new menu just for the Twinkle items. In that case, add

window.Twinkle.prefs = {
  "twinkle": {
    // ...
    "portletArea": "column-one",
    "portletId"  : "p-twinkle",
    "portletName": "Twinkle",
    "portletNext": "p-search",
    // ...
  },
  // ...
};

The portletId parameter now refers to the specific Twinkle tool set, 'p-twinkle'. portletArea indicates where the menu should appear (the value 'column-one' is the sidebar for Monobook; for Vector it is 'panel' and for Modern it is 'mw_portlets'; Other options include 'left-navigation' and 'right-navigation' in Vector and 'mw_contentwrapper' in Modern, which will appear on a new level above the other tabs). Change portletNext to dictate which ID the new Twinkle menu should precede; in this case 'p-search' means it will come before the search box. Change the portletName parameter to change the name displayed named along with the new menu, if applicable - in this case, "Twinkle".

Ask for support at the Twinkle talk page if you're unsure what to change.