帮助:Twinkle

H:TW

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

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

安装

安装 Twinkle 很简单，请参考Wikiversity:Twinkle中的指示。

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

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

练习使用Twinkle

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

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

注意：请不要在上述沙箱执行速删、提删，或者请求保护的操作，因为这些会真的通知到管理员。并且，不要在沙箱页面进行取消反链的操作，因为这将移除所有到沙箱的连结。

安装故障解答

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 设置中修改。如果需要额外资讯（比如说理由，URL 或者版权资讯等等）时，Twinkle 可能会提示您。然后 Twinkle 就会在页面上标示适合的速删范本。

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

注意

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

管理员附加功能

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

保护

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

使用方法

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

请求保护页面：如果您想要经由 Wikiversity:RFPP 来请求保护的话，请使用此选项。您必须选择保护类型，接著选择保护期限（永久或暂时）并可在下方栏位写明理由。
用保护范本标记此页：您将可以选择标记选项。您可以选择保护范本，或是

勾选使用图示（small=yes），这会在条目右上方显示一个小锁图案来取代文字范本
选择用<noinclude>包裹保护范本，以避免此页面被包含嵌入。

注意

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

管理员附加功能

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

提删

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

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

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

使用方法

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

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

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

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

当如可能，通知页面创建者被选中时，会使得 Twinkle 发送一个通知到页面创建者的讨论页上。通常此选项应该被选中，但不是每次都应被选中，特别是针对破坏者时。

当然，您必须为此次提删指定一个理由。您可以在理由中使用任何维基语法。

如果您在参数设置中设置了相关参数，被提删页面将会加入您的监视清单中。预设不会有页面因为提删而被加入监视清单。您可以在参数设置面板中找到更多资讯。

在提删模组中，没有在使用者页名字空间下记录提删日志的功能，因为所有删除讨论都保存在特定页面中。

注意

在进行 XfD 时，Twinkle 可能会很慢，特别是在日期列表加入讨论时；原因目前未知，有人猜测这是伺服器问题。如果 Twinkle 在进行 XfD 时卡住没有反应，请保持耐心。在某些情况下，你可能需要等待 20 秒以上。

管理员附加工具

~~Twinkle 不包含供管理员关闭存废讨论的工具。如果您想使用这样的工具，请参见：en:User:Mr.Z-man/closeAFD。~~

https://github.com/jimmyxu/twinkle/blob/master/modules/twinkleclose.js

最后

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

反链

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

标记

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

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

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

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

DI（图片速删）

DI（Deletable Image）适用于没有合理来源或版权的图像。

警告［用户讨论页］

警告功能允许您在该使用者的讨论页上留下警告讯息。

使用方法

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

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

点选提交后即会在该用户讨论页上加入您选择的警告范本，然后您的浏览器会重新整理页面。

通告

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

目前支援以下范本：

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

更多范本可能在未来陆续加入。

告状

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

使用方法

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

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

撤销与回退

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

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

欢迎

Depending on your preferences, this link will automatically welcome the user with the template specified in the "Template to use when welcoming automatically" preference, or open the user's talk page with Twinkle's welcome dialogue already visible (by default). This feature is available when viewing any diff across all namespaces.

管理员专用模组

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

批量删除（Batch deletion ("D-batch")）：这一模组可让您删除一个分类下的部分或全部的页面，并取消条目上的连结且删除该页面的讨论页、重定向页。大量关闭 AfD 时适合使用此模块，但由于删除过程自动进行，所以在使用时应谨慎。您完全了解它的处理过程，否则可能会因滥用而导致严重破坏。在某些情况下，这可能不是最好的处理方法。
批量删除图像：与批量删除类似，只不过是删除图像。之所以有两个模块是因为处理过程不太相同。
批量反删除（Batch undeletion ("Und-batch")）：与批量删除类似，但是执行反删除操作而非删除操作。此功能仅用于用户的子页面，所以您必须先在用户空间包含嵌入或是建立一个页面列表。
批量保护（Batch protection ("P-batch")）：与批量删除类似，但是执行保护操作而非删除操作。通常用作有大量页面被破坏时的紧急措施。

设置

最方便的设置Twinkle的方法是使用参数设置面板（见Wikiversity: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..."
  }
};

高级参数

These parameters are handy to tweak if your browser or network connection is struggling to perform operations without encountering database locks or network timeouts. 高级参数不包含在参数设置面板中。因此必须通过手动编辑Special:MyPage/twinkleoptions.js来实现。

普通用户可设置以下参数：

revertMaxRevisions: Defines the maximum number of revisions to query when looking for a clean revision to roll back to. The server limit is 50. 预设值是50.

Administrators can use other parameters to fine-tune batch operations, etc.

batchdeleteChunks: Defines how many pages should be processed at a time when performing batch deletions. The server limit is 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.
batchundeleteChunks: Defines how many pages should be processed at a time when performing batch undeletions. The server limit is 50. 建议您不要更改此参数。预设值是50.
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.

Location of Twinkle menu items

The default location of the Twinkle menu items in the Vector skin is in a drop-down menu; in all other skins they are displayed on the top row of tabs. If you like, you can change the location and layout of those items on your page by manually setting some options in your twinkleoptions.js:

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

For example, if you want to move the items to the toolbox menu on the left-hand side of the screen, add the line "portletId": "p-tb", to your Twinkle preferences, like so:

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

If you want to display the items as tabs as in the old monobook skin, add the line "portletId": "p-views", to your Twinkle preferences, like so:

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.