幫助: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.