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

This page is a translated version of the page Help:Extension:FileImporter and the translation is 43% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎italiano • ‎português do Brasil • ‎русский • ‎српски / srpski • ‎українська • ‎فارسی • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어
Logo for the beta feature FileExporter.svg

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

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

FileImporter впроваджено у Вікісховище в червні 2018 року. Щоб скористатися ним, Вам треба активувати Експортер файлів як бета-функцію у Вашій локальній вікі.

(Exception: A few Wikimedia wikis already have the FileExporter as a default feature.)

Передумови

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

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

З чого почати

1) Щоб увімкнути FileExporter у локальній вікі, Вам треба увійти в систему і поставити галочку біля назви бета-функції «Експортер файлів» на відповідній сторінці налаштувань. Вам не треба активувати Імпортер файлів на Вікісховищі. (Be sure to visit the preferences page for the wiki from which you intend to export files. The preceding link will take you to the preferences page for the MediaWiki wiki.) Exception: A few Wikimedia wikis already have the FileExporter as a default feature. On these wikis, you don't need to activate anything.
You don't have to activate the FileImporter on Wikimedia Commons. 2) Має бути файл конфігурації для Вашої вікі. Чимало таких файлів уже існують на основі файлів з інструмента CommonsHelper2. Ми просимо користувачів переглянути ці файли й оновити їх, або створити, якщо файл для Вашої вікі відсутній, щоб переконатись, що імпортування відбуватимуться правильно. Щоб дізнатись більше, див. документацію щодо того, як працюють файли конфігурації і для чого вони взагалі потрібні.

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

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

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

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

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.
  • Для імпорту створюється новий запис у журналі завантажень, а також запис у журналі імпорту, з посиланнями на відповідну нульову версію файлу, ім'я користувача, який здійснив імпорт, а також із міткою часу у формі дати імпортування.

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

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

These revisions are also tagged with Imported with FileImporter.

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:
  • 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

Посилання