Help:VisualFileChange.js
 | Це — документація для VisualFileChange, додатка на JavaScript для масового редагування. Сам по собі цей скрипт розташований на сторінці MediaWiki:VisualFileChange.js. |
Що таке VFC?
Програма VisualFileChange (також відома як AjaxMassDelete), додає посилання «Perform batch task» на Вашу панель інструментів на вікісторінках. Клацання на це посилання дозволить Вам здійснити дії з деякими, або всіма завантаженнями одного користувача, файлами в категорії, або файлами, відтвореними в галереї. До таких дій належать створення запитів на масове вилучення, вставляння тегів чи вільного тексту, і налаштовні заміни тексту (підтримуються регулярні вирази).
Документація
See also Help:AjaxQuickDelete, щоб дізнатися про основи автоматичних запитів на вилучення, або способу «позначити файл і сповістити завантажувача».
Крок 0: Як встановити
Щоб встановити його:
- Вручну: у "вкладці «Додатки» в Налаштуваннях, розділ «Робочі інструменти»: поставте галочку біля «VisualFileChange» і клацніть «Зберегти» внизу сторінки.
- Автоматично: клацніть сюди і виконайте інструкції.
- Якщо у Вас немає прав автопатрульного: додайте
mw.loader.load( 'ext.gadget.VisualFileChange' );до свого common.js або <skin>.js
Тепер Ви мали б бачити посилання «Perform batch task» на своїй панелі інструментів. Клацання на це посилання запустить VisualFileChange.
Щоб змінити текст Perform batch task, додайте
window.vFC_PortletText = '<your new portlet text>'; до свого common.js або <skin>.js
Крок 1: Вставте дописувача
Скрипт дає підказки щодо дописувача, назви сторінки, категорії, чи пошукового запиту. Переконайтесь, що Ви ввели коректну назву.
Крок 2: Виберіть дію, введіть причину, текст заміни й зразок, шаблони або вільний текст
Члени OTRS: спершу вкажіть ID або URL, а після цього перемкніться на OTRS- remove tags. За допомогою OTRS- add Ви зможете додати будь-який шаблон до розділу з дозволами, не вилучивши при цьому шаблонів про швидке вилучення чи інших шаблонів.
Поставте галочку біля Clean permission-section? щоб вилучити все інше з розділу для дозволів, якщо там щось є.
Крок 3: Завантажте стільки файлів, скільки Ви хочете змінити
Змінені будуть лише ті файли, які Ви вибрали, і які перебувають у діалоговому вікні. Щоб отримати більше файлів, прокрутіть вниз, або клацніть more. Але не завантажуйте надто багато файлів, інакше Ваш браузер може аварійно закритися. Натомість можете продовжити звідти, де зупинились, використавши «more options» у початковому діалозі або автоматично створений профіль.
Крок 4: Виберіть елементи, над якими треба здійснити дії
У списку виводяться лише ті елементи, які початково були завантажені вказаним користувачем. Якщо є вилучені зображення, нумерація є переривчастою. Скрипт виявить чимало шаблонів про проблеми й шаблони OTRS, а також типові різновиди ліцензій, і покаже їх під кожною мініатюрою. Приклад
Кмітливий вибір — фільтрування завантажених файлів
Якщо Ви не вкажете нічого, враховуватиметься все, і всі галочки в діалозі мініатюр отримають такий стан, як і в цьому діалозі. Це дає змогу як виділяти, так і прибирати виділення.
- RegExpr /R/
RegExpr, також відомий як регулярний вираз, або regex — це модель, яка використовується для пошуку збігів більш як одного «рядка» (напр., текст чи назва зображення). Вони можуть бути корисними багато де, тож, якщо у Вас немає досвіду користування ними, не лінуйтесь і вивчіть їх; чим швидше Ви це зробите, тим краще.
У діалозі кмітливого вибору вставте RegExpr без прапорців (вони зараз не підтримуються) (Test.*); однак при виконанні налаштованої заміни, вставляйте RegExpr із прапорцями (/\{\{FlickrView.*\|\d{4}\}\}/ig). Не забувайте уникати «спеціальних символів».
Будь ласка, протестуйте свій RegExpr, перед тим як використати його, і скористайтеся можливістю перевірити свої зміни, які будуть спричинені поточним набором правил заміни, щоб уникнути небажаних замін. Можете скористатись https://regex101.com/ (чи подібними інструментами), щоб протестувати свій RegExpr.
When using regular expressions, VFC follows the same convention as Perl, PHP, and others that in the replacement string, $0 matches the whole matched string, /[|]\s*[Ss]ource\s*=\s*([^|}]*) on MyCoolWebsite/| Source = {{MyCoolWebsite|$1}}/[|]\s*[Ss]ource\s*=\s*([^|}]*) on MyCoolWebsite/ with a replacement string | Source = {{MyCoolWebsite|$1}} would turn |source=FOO.BAR on MyCoolWebsite</nowiki> into | Source = {{MyCoolWebsite|FOO.BAR}}.
Приклади для порівняння: de, en, en
Вибір діапазону — кілька файлів між двома файлами
Виберіть файл А, затисніть ⇧ Shift і виберіть файл Б. Усі файли між цими двома отримають стан файлу Б.
Налаштовна заміна: прапорці
- Якщо встановлено
/R/, модель сприймається як регулярний вираз. Якщо тло за кнопкою червоне, то дуже ймовірно, що Ви забули клацнути цю кнопку. Якщо тло за полем моделі червоне, Ви клацнули на цю кнопку, але ця модель не є валідним регулярним виразом. - Якщо встановлено
%V%, VisualFileChange шукає змінних (напр., метаданих файлу, таких як%GPSLatitude%, або назви файлу%PAGENAME%) у «Text to insert instead». Ця опція увімкнена за замовчуванням. Приклади.
Крок 5: Виконайте
Скрипт покаже Вам, що він зараз робить. Зрештою, він підкаже Вам, що робити далі. Перед тим як виконати, скрипт збереже Ваш внесок в автоматичний профіль. Це дасть Вам змогу продовжити з останніх завантажених файлів. Якщо Ви перезапустите VisualFileChange і вставите ту ж ціль, з'явиться велике жовте вікно. Просто клацніть на посилання для зручного продовження роботи.
Нетипові налаштування
VisualFileChange дає змогу налаштовувати чимало функцій на свій смак. Не рекомендується занадто сильно збільшувати кількість файлів, які мають бути завантажені при прокручуванні донизу, але в деяких випадках це може бути корисним.
Якщо Ви надішлете надто багато запитів до API водночас, можуть виникати помилки. Користувачі, які не перебувають у системі, повинні надсилати лише один запит за раз. У випадку помилок, встановіть «ask for confirmation after ... edits» значення менш як 8 і почекайте, поки діалог не запитає Вас, чи Ви хочете продовжити. Нам жаль, що таке обмеження існує, але ми не можемо змінити його, оскільки воно встановлене з боку сервера. Є також значно більше обмежень на редагування для користувачів, які не перебувають у системі.
Додаткова інформація
Розробка та виявлення й виправлення багів
- Будь ласка, повідомляйте про баги на MediaWiki talk:Gadget-VisualFileChange.js
- графік потоку роботи (застарілий)
