VisualEditor/Citation tool/uk

Інструмент цитування у Візуальному редакторі дозволяє користувачам використовувати типові для Вашої вікі шаблони цитування (шаблони посилань на джерела) прямо у Візуальному редакторі. Аби увімкнути цей інструмент, Вам необхідне наступне: робоча інсталяція Візуального редактора та Parsoid'а, шаблони цитування у Вашій вікі, що містять блок TemplateData, завдяки якому Візуальний редактор дізнається, як ці шаблони коректно викликати, а також спеціальна сторінка у форматі .json, яка пов'язує Візуальний редактор та відповідні шаблони між собою. To enable the tool, you'll need the following: a working installation of VisualEditor and Parsoid, citation templates on your wiki that use TemplateData to specify how they are invoked, and a special  message in order to hook VisualEditor and the templates together.

Імпортування шаблонів цитування
У базі даних Вашої вікі мають бути шаблони цитування, щоб можна було використовувати будь-яку з функцій цитування у ВР. Якщо у Вашій вікі зараз немає ніяких шаблонів цитування (наприклад, у випадку нової інсталяції), тоді Вам треба створити їх. Найпростіше це можна зробити шляхом копіювання їх із Вікіпедії. Якщо ж Ви вже маєте шаблони цитування у своїй вікі, тоді можете пропустити ці кроки.

All Wikipedias and other WMF wikis already have all of these things installed.
 * 1) Встановіть Extension:Scribunto, Extension:ParserFunctions, Extension:Cite, та Extension:TemplateData. Більшість шаблонів цитування у Вікіпедії використовують мову програмування Lua, використання якої уможливлюється розширенням Scribunto, а також вони використовують функції парсера цього розширення. Розширення Cite дає змогу використовувати теги.
 * 1) Експортуйте шаблони цитування із Вікіпедії: Manual:Using_content_from_Wikipedia. Експортування шаблонів Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book буде добрим початком. Recent versions of these templates at the English Wikipedia and some others also require the supporting Lua modules.
 * 2) Завантажте відповідні шаблони, використовуючи сторінку Special:Import у Вашій вікі (наприклад, http://localhost/index.php/Special:Import)

TemplateData
Вам буде потрібне розширення Extension:TemplateData для того, аби інструмент цитування міг завантажити дані шаблону у відповідні поля Візуального редактора, при чому кожен шаблон повинен мати заповнений блок TemplateData. Якщо Вам треба більше інформації щодо того, яким чином заповнювати TemplateData для шаблонів цитувань, а також щоб переглянути скріншоти, де показано, як має виглядати вікно інструменту цитування з TemplateData та без, перегляньте сторінку Вікіпедія:TemplateData.

Визначення інструменту цитування
Аби увімкнути інструмент цитування у Візуальному редакторі у Вашій вікі, треба створити спеціальну сторінку:. Такий процес був розроблений тому, що кожна вікі є іншою, а тому має бути можливість окремо налаштовувати, які саме функції у ній мають використовуватись; наприклад, назви шаблонів, що використовуються у Вашій вікі, можуть відрізнятись від тих, що використовуються в інших вікі.

Ціль сторінки конфігурації
Сторінка:

Як тільки сторінка конфігурації  буде створена, інструмент цитування стане доступним для усіх користувачів Візуального редактора у Вашій вікі вже за декілька хвилин.
 * Вказує, які саме шаблони використовуються у Вашій вікі для стандартних цитувань (Ви можете вказати до 5 таких шаблонів).
 * Зауважте, що кожен шаблон повинен мати блок TemplateData, інакше користувачам буде дуже важко зрозуміти систему. Якщо Ваша вікі наразі не використовує шаблонів цитування, тоді звичною процедурою є копіювання відповідних шаблонів з англійської Вікіпедії — там досить непоганий набір цих шаблонів.
 * Вказує, яку саме назву Ви хочете використовувати для кожного типу цитування.
 * Існує чотири стандартних типи, "web", "book", "news", "journal", кожному з яких відповідає окрема сторінка з назвою типу  тощо.
 * вказує, яку саме іконку Ви хочете використовувати для кожного типу цитування.
 * Існує чотири стандартних — "ref-cite-web", "ref-cite-book", "ref-cite-news" та "ref-cite-journal", яким відповідають CSS-класи з іконками у формі фонового SVG-зображення, що мають назви типу   тощо.

Додаткові типи
Якщо Ви роздумуєте над тим, щоб додати додатковий тип, команда розробників хотіла б спершу поспілкуватися з Вами, дати пораду, допомогти створити відповідну іконку, і таким чином ми змогли б подумати над тим, чи інші вікі не захотіли б мати такий самий тип, щоб він був доступний стандартно для усіх вікі.

Аби додати додатковий тип, Вам необхідно:


 * 1) Вирішити, який саме тип Ви хочете створити
 * 2) * У цьому прикладі, скажімо, Ви хотіли б мати посилання на базу даних, і могли б назвати цей тип "database".
 * 3) Створіть мітку для нього
 * 4) * Наприклад, Ви могли б обрати «db» як назву мітки, і додати мітку на  зі значенням «база даних». Це має бути записано мовою вмісту Вашої вікі. Якщо Ваша вікі використовує багато мов чи скриптів, Вам, найімовірніше, доведеться створити декілька таких міток.
 * 5) Створіть іконку для нього
 * 6) * Наприклад, Ви могли б визначити мітку іконки як "ref-cite-dbase", і створити іконку як файл SVG, завантажений на Вікісховище, створити клас іконки " " у, та додати іконку, використавши код " " чи щось подібне.

Приклади
Можна переглянути сторінки конфігурації в англійській та польській Вікіпедіях. Copy the code to your wiki and adapt the names to the local context.

Виправлення помилок
Якщо Ви зайдете на сторінку Special:Version і побачите, що TemplateData встановлено, однак поля не відображаються в діалоговому вікні цитування, Вам, найімовірніше, треба відкрити шаблон цитування в редакторі вікірозмітки, і зберегти сторінку, не здійснивши жодної зміни. Ця проблема пов'язана з баґом, при якому інформація з TemplateData, коли вона включена у шаблон (тобто присутня на підсторінці документації Template:Cite_web/doc, а не на самій сторінці шаблону Template:Cite_web), не вантажиться у базу даних, аж доки батьківський шаблон не буде відредагований; див. .

Будь ласка, зверніть увагу, що користувацький досвід дещо відрізнятиметься при використанні набору шаблонів, відмінного від набору із чотирьох стандартних шаблонів. Зокрема, список полів початково не відображатиметься у діалоговому вікні цитування — натомість Ви отримаєте змогу викликати список усіх можливих полів, натиснувши відповідну кнопку.