Довідка:Розширення:FileImporter

Зверніть увагу! Коли Ви редагуєте цю сторінку, то погоджуєтесь робити свій внесок під ліцензією CC0. Детальніше про умови ліцензії можна дізнатися на сторінці довідки.

Розширення FileImporter і FileExporter спрямовані на полегшення процесу перенесення файлів з локальної вікі у Вікісховище. Новий функціонал дозволяє переносити файли зі збереженням усієї супутньої інформації, у той же час документуючи таке перенесення в історії редагувань.

Розширення FileExporter додає посилання на Вікісховище на сторінках локальної вікі й передає вибрану URL-адресу розширенню FileImporter. Натомість FileImporter — це розширення, призначене для Вікісховища, яке імпортує файл разом з усіма супутніми даними, якщо він відповідає всім формальним вимогам. Технічно відбувається не «перенесення», а «копіювання» файлів.

Експортер файлів впроваджено у Вікісховище в червні 2018 року. Щоб скористатися ним, Вам треба активувати Експортер файлів як бета-функцію у Вашій локальній вікі. FileExporter is deployed and enabled as default feature on all Wikimedia wikis since August 2020.

Передумови

Метою створення розширень FileImporter та FileExporter було виконання запиту, висловленого німецькомовною спільнотою в її технічному списку побажань, а розроблено командою з технічних питань Вікімедіа Німеччина (WMDE). Більше інформації можна знайти на головній сторінці проекту на Меті.

Використання

З чого почати

1) Щоб увімкнути FileExporter у локальній вікі, Вам треба увійти в систему і поставити галочку біля назви бета-функції «Експортер файлів» на відповідній сторінці налаштувань.

2) Має бути файл конфігурації для Вашої вікі. Чимало таких файлів уже існують на основі файлів з інструмента CommonsHelper2. Ми просимо користувачів переглянути ці файли й оновити їх, або створити, якщо файл для Вашої вікі відсутній, щоб переконатись, що імпортування відбуватимуться правильно.

Щоб дізнатись більше, див. документацію щодо того, як працюють файли конфігурації і для чого вони взагалі потрібні.

Крок за кроком

Вам треба увійти в систему, щоб користуватися цією функцією.

• 
  1: На локальній сторінці файлу клацніть вкладку «Експортувати до Вікісховища» (над зображенням).
• 
  2: Імпортер файлів перевіряє, чи файл можна імпортувати, і чи треба здійснити якісь заміни шаблонів під час імпортування. Цей крок базується на файлі конфігурації конкретної вікі. Дізнайтесь більше.
• 
  3: Сторінка попереднього перегляду на Вікісховищі показує Вам, що буде імпортовано. Ви можете відредагувати назву файлу й інформацію про сторінку та клацнути «Імпортувати файл», щоб скопіювати такий файл на Вікісховище.
• 
  4: Файл імпортовано, включно з іменем оригінального завантажувача та іменем того, хто здійснив імпорт, а також з попередньою історією редагувань як самого файлу, так і сторінки його опису, та з будь-якими змінами, здійсненими у процесі імпорту.

Як можна відшукати імпортовані файли

• В історії редагувань файлу імпорт показано як нульову версію (тобто редагування, яке насправді не внесло жодної зміни в сторінку файлу).

If changes were made during import, an additional text revision is created.

• New revisions that are created during import are tagged with Modified with FileImporter.

This way it can be filtered on the recent changes page.

• Для імпорту створюється новий запис у журналі завантажень, а також запис у журналі імпорту, з посиланнями на відповідну нульову версію файлу, ім'я користувача, який здійснив імпорт, а також із міткою часу у формі дати імпортування.

Наявність водночас записів є стандартною для завантажень, але вона призводить до «дублювання» записів в останніх змінах і списках спостереження, див. цей файл як приклад та його [$ur2 записи в журналі].

• Для (старих) версій імпортованого файлу створюються записи в журналі завантажень із зазначенням дати й користувача, який здійснив початкове завантаження, так що всі версії файлу можна простежити в журналі завантажень на Вікісховищі. These revisions are also tagged with Imported with FileImporter.

• Imported files are marked with an invisible comment that says "This file was moved here using FileImporter from" and mentions the full URL of the source file.

CirrusSearch's insource: feature can be used to find files with this comment, e.g.: insource:"This file was moved here using FileImporter from //en.wikipedia". Note this also finds later derivatives of imported files, but not files where the comment was removed.

How to add categories

The message fileimporter-post-import-revision-annotation (empty by default) can be used to add any additional wikitext to every imported file. The message accepts two parameters:

• $1 - Full URL of the source file.
• $2 - Time of the import in ISO 8601, e.g. 2004-02-12T15:19:21+00:00.

For example, to categorize by source wiki, an interface administrator can set the message to {{#invoke:Imported with FileImporter|main|url=$1|time=$2}}, where the invoked Lua module ("Module:Imported with FileImporter" in this example) looks like this:

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: Експорт на test.wikipedia.org
  • FileExporter як бета-функція на mediawiki.org та test2.wikipedia.org.  OK (щоб протестувати процес експортування, Вам треба бути автопідтвердженим користувачем у цих вікі.)
  • FileImporter на test.wikipedia.org  OK
• 2018-06-25: Експорт до Вікісховища
  • FileExporter як бета-функція на de.WP, fa.WP, ar.WP  OK
  • експортування з mediawiki.org до Вікісховища  OK
  • FileImporter на Вікісховищі OK
• 2018-07-11:
  • FileExporter як бета-функція на Вікіджерелах  OK
• 2019-01-16:
  • Впровадження бета-функції «Експортер файлів» у всі інші вікі  OK
• 2019-09-24:

• • Deployment as a default feature on de.WP, fa.WP, ko.WP, mr.WP and sourceswiki (wikisource.org)  OK

• 2020-08-05:

• • Deployment as a default feature on all remaining Wikis

 OK

Посилання

• Головна сторінка проєкту на Меті
• FileImporter - інструкції з використання розширення
• Extension:FileImporter/List of configured wikis - налаштування FileImporter
• FileExporter - інструкції з використання розширення
• phab:tag/move-files-to-commons/ - проєкт на Фабрикаторі
• Загальний огляд: як відбувається порівняння шаблонів у розширенні FileImporter