VisualEditor/Citation tool/uk

Інструмент цитування у Візуальному редакторі дозволяє користувачам використовувати типові для вашої вікі шаблони цитування (шаблони посилань на джерела) прямо у Візуальному редакторі. Аби увімкнути цей інструмент, вам необхідне наступне: робоча інсталяція Візуального редактора та Parsoid'а, шаблони цитування у вашій вікі, що містять блок TemplateData, завдяки якому Візуальний редактор дізнається, як ці шаблони коректно викликати, а також спеціальна сторінка у форматі .json, яка поєднує Візуальний редактор та відповідні шаблони між собою.

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


 * 1) Встановіть Extension:Scribunto, Extension:ParserFunctions, Extension:Cite, та Extension:TemplateData. Більшість шаблонів цитування у Вікіпедії використовують мову програмування Lua, використання якої уможливлюється розширенням Scribunto, а також вони використовують функції парсера цього розширення. Розширення Cite дає змогу використовувати теги.
 * 2) Експортуйте шаблони цитування із Вікіпедії: Manual:Using_content_from_Wikipedia. Експортування шаблонів Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book буде добрим початком.
 * 3) Завантажте відповідні шаблони, використовуючи сторінку 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) * For the example, you could make the label name "db" and add a label at   with the value "database". This should be in your wiki's content language. If your wiki uses multiple languages or scripts, you may need to create several of these labels.
 * 5) Create an icon for it
 * 6) * For the example, you could make the icon label "ref-cite-dbase", and create the icon as an SVG file uploaded to commons, create the icon class " " in  and add the icon you want with " " or similar.

Examples
You can see example definition messages on the English Wikipedia and the Polish Wikipedia.

Troubleshooting
If you navigate to Special:Version and TemplateData is installed, but fields aren't showing up in the citation dialog, you may need to open the citation template for editing, make no changes, and save it again. This is due to a bug where TemplateData which is transcluded (i.e. present in Template:Cite_web/doc instead of directly on Template:Cite_web) is not loaded into the database until the parent template is edited; see.

Please note that the user experience will differ slightly when using your own templates other than the standard 4. For instance, a list of fields won't show up initially in the citation dialog, but you will be able to request a list of all possible fields by clicking a button.