Help:Extension:FileImporter

注意：當您編輯本頁面時，即同意以CC0協議授權您的貢獻。您可以在公有領域帮助页面找到更多信息。

文件导入 和文件导出 的擴展旨在使文件從本地維基移動到維基共享資源更容易。 新功能允許在原始數據完整的情況下移動文件，同時包含歷史記錄中的移動。

文件导出 提供了本地維基上維基共享資源的鏈接，並將URL移交給擴展名FileImporter。 文件导入 是維基共享資源上的擴展，在滿足所有先決條件時導入包含所有數據的文件。 從技術上講，文件不會被“移動”，而是“複製”。

FileImporter已於2018年6月部署到維基共享資源上。要使用它，您需要在本地Wiki中激活測試版FileExporter。 FileExporter is deployed and enabled as default feature on all Wikimedia wikis since August 2020.

背景

FileImporter和FileExporter旨在滿足德語社區的技術願望清單的請求，由WMDE的技術團隊開發(WikiMedia Deutschland)。 更多信息可以在Meta上的主項目頁面中找到。

用法

入门

1) 要在本地Wiki上啟用FileExporter，您必須登錄並勾選参数设置中的測試功能上的FileExporter複選框。

2) 您的wiki需要有配置文件。 基於CommonsHelper2工具中的文件，已存在許多文件。 我們要求用戶查看它們並在需要時更新或創建它們以確保導入正確完成。

有關詳細信息，請參閱文檔配置文件的工作原理及其所需內容。

步驟

您需要登錄才能使用該功能。

• 
  1：在本地文件頁上，單擊“導出到維基共享資源”選項卡（圖像上方）。
• 
  2：FileImporter檢查'是否可以導入文件以及替代品是否需要在製作導入期間替換模板。 此步驟基於wiki的配置文件。 詳情見此。
• 
  3：維基共享資源的預覽頁面顯示了將要導入的內容。 您可以編輯文件標題和頁面信息，要求FileImporter以您的名義清理源wiki，方法是在源文件中添加像NowCommons這樣的模板，或者如果您具有管理員權限，則刪除源文件。點擊單擊“導入文件”副本將文件複製到維基共享資源。
• 
  4：文件已導入，包括原始上傳者的名稱和導入程序的名稱，文件的先前歷史記錄和文件頁面，以及導入期間所做的任何更改。

如何找到導入的文件

• 在文件的修訂歷史記錄中，導入顯示為空修訂（即修訂列表中的條目實際上並未更改頁面）。 如果在導入期間進行了更改，則會創建附加文本修訂。
• 在導入過程中創建的新修訂版帶有標記Modified with FileImporter。 這樣就可以在近期變動頁面上進行過濾。
• 創建上載日誌條目和導入日誌條目，並與空修訂版和導入用戶相關聯，並用導入日期加上時間戳。 同時具有日誌條目是上載的默認值，儘管它可能會導致“加倍”條目，請參閱範例文件及該文件的日誌。
• 對於（舊）導入的文件修訂，使用原始上載的日期和用戶創建上載日誌條目，以使所有文件修訂顯示在維基共享資源的上載日誌中。 這些修訂還標有Imported with FileImporter。
• 導入的文件標有一個不可見的評論，上面寫著這個文件是使用FileImporter from移動到這裡的，並提到了源文件的完整URL。 CirrusSearch的insource:功能可用於查找帶有此註釋的文件，例如：insource:"This file was moved here using FileImporter from //en.wikipedia"。 請注意，這還會找到導入文件的後續派生文件，但不會找到註釋被刪除的文件。

如何添加類別

消息fileimporter-post-import-revision-annotation（默認為空）可用於向每個導入的文件添加任何額外的wikitext。 該消息接受兩個參數：

• $1 - 源文件的完整URL。
• $2 - 在ISO 8601中導入的時間，例如2004-02-12T15:19:21+00:00。

例如，要按源wiki進行分類，界面管理員可以將消息設置為{{#invoke:Imported with FileImporter|main|url=$1|time=$2}}，其中調用的Lua模塊（在本例中為“Module:Imported with FileImporter”）如下所示：

local exports = {}
function exports.main( frame )
    return "[[Category:Files moved to Commons from " .. mw.uri.new( frame.args.url ).host:gsub( ".org", "" ) .. "]]"
end
return exports

部署路线图

• 2018-06-12：導出到測試維基
  • FileExporter作為mediawiki.org和測試維基2上的測試版功能。  OK （要測試導出，您還需要成為這些wiki上的自動確認用戶。）
  • [1]上的FileImporter  OK
• 2018年6月25日：导出至维基共享资源
  • 文件导出器作为测试功能在德语、波斯语和阿拉伯语维基百科上提供 OK
  • 来自mediawiki.org的导出文件现在转交维基共享资源 OK
  • 文件导入器在维基共享资源提供 OK
• 2018年7月11日：
  • 文件导出器作为测试功能在sourcewiki提供 OK
• 2019年1月6日：
  • 部署文件导出器测试功能至其他wiki OK
• 2019-09-24:
  • 在de.WP、fa.WP、ko.WP、mr.WP和sourceswiki (wikisource.org) 上部署為默認功能 OK
• 2020-08-05:
  • 部署為所有剩餘Wiki上的默認功能  OK

链接

• 元維基的主頁
• 文件导入 - 扩展手册
• 扩展:文件导入/已配置的维基列表 - 文件导入配置
• 文件导出 - 扩展手册
• phab:tag/move-files-to-commons/ - Phabricator项目
• Overview:模板如何與FileImporter擴展匹配