說明: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.