VisualEditor/Citation tool/bg

Инструментът за цитиране на Визуалния редактор' позволява на потребителите да използват шаблони за източници от уикито си вътре в самия редактор. За да активирате инструмента, е нужно следното: работеща инсталирана версия на Визуален редактор и Parsoid; шаблони за източници във вашето уики, които използват TemplateData, който посочва как те са използвани; и специално .json съобщение, за да се свържете Визуалния редактор и шаблоните заедно.

Внасяне на шаблони за източници
Ще имате нужда от шаблони за цитиране в базата данни на вашето уики, за да използвате функциите за източници. Ако нямате (например след инсталиране) ще трябва да ги вземете. Копирането от Уикипедия е най-лесният начин да го направите. Ако вече имате шаблони, може да пропуснете тези стъпки.


 * 1) Инсталиране на Extension:Scribunto, Extension:ParserFunctions, Extension:Cite и Extension:TemplateData. Повечето шаблони за цитиране на Уикипедия използват езика за програмиране Lua, който е достъпен благодарение на Scribuntо, и също така използват парсерните функции на разширенията. Разширението Cite ви позволява да използвате таговете .  Всички Уикипедии и други уикита на Фондация Уикимедия вече са инсталирали всички тези неща.
 * 2) Експортиране на шаблони за цитиране от Уикипедия: Manual:Using_content_from_Wikipedia. Добри места за начало са w:Template:Cite web, w:Template:Cite news, w:Template:Cite journal, w:Template:Cite book Последните версии на тези шаблони в английската Уикипедия, както и някои други, също изискват поддръжка на Lua модули.
 * 3) Качете вашите шаблони с помощта на Специални:Внасяне на страници във вашето уики.

Template data
You'll need Extension:TemplateData for the citation tool to be able to load the template data into the fields in VisualEditor and each template must have template data defined. For more information on how to define template data for citations, and to see screenshots of how a citation window should look with and without template data defined, see: Wikipedia:VisualEditor/TemplateData

Дефиниране на инструмента за цитиране
За да активирате инструмента за цитиране на Визуалния редактор на уикито си, трябва да създадете специално съобщение от вашия уики:. Това е така, защото всяко уики е различно и затова е нужно да персонализирате кои функции то да използва; например, имената на шаблоните, използвани в уикито ви може да са различни от тези в друго.

Цел на конфигуриращото съобщение
Съобщението:

След като е създадено конфигурационното съобщение, инструментът за цитиране ще бъде достъпен за всички потребители на Визуалния редактор на вашето уики в рамките на няколко минути.
 * Посочва кои шаблони за стандартно цитиране използва вашето уики (може да посочите до 5).
 * Имайте предвид, че всеки шаблон трябва да има дефиниран TemplateData или ще бъде много трудно за потребителите да разберат системата. Ако уикито ви в момента не използва шаблони за цитиране, като добър общ комплект можете да копирате шаблоните от английската Уикипедия.
 * Посочва какви описания искате да използвате за всеки вид цитиране.
 * Има четири стандартни, "web", "book", "news" и "journal", които съответстват на  и т.н.
 * Посочва каква икона искате да използвате за всеки вид цитиране.
 * Има четири стандартни, "ref-cite-web", "ref-cite-book", "ref-cite-news" и "ref-cite-journal", които съответстват на CSS класове с икона като SVG фоново изображение, наречени съответно  и т.н.

Допълнителни видове
Ако обмисляте добавянето на допълнителен вид шаблон, разработващият екип би искал първо да говори с вас - за да даде съвет, да помогне при създаването на подходяща икона и за да можем да обмислим дали другите уикита също биха искали този шаблон да е дефиниран за всички уикита.

За да добавите допълнителен вид, трябва да:


 * 1) Решете какъв вид искате да създадете
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Създадете негово описание
 * 4) * В примера, бихте могли да сложите името "db" и да добавите описание  със стойност "база данни". Това трябва да бъде направено на езика на съдържанието на вашето уики. Ако уикито използва множество езици или скриптове, може да се наложи да създадете няколко от тези описания.
 * 5) Създадете негова икона
 * 6) * В примера, бихте могли да направите икона на описанието "ref-cite-dbase" и да създадете иконата като SVG файл, качен в Общомения, да създадете класа на иконата " " в  и добавите иконата, която искате с " " или подобен линк.

Примери
Можете да видите примерни съобщения за дефиниране на Уикипедия на английски и Уикипедия на полски език.

Отстраняване на проблеми
Ако отидете до Специални:Версия и имате инсталиран TemplateData, но полетата не се показват в прозореца за редактиране, може да се наложи да отворите в режим на редактиране шаблона за цитиране, да направите празна промяна, и отново да го съхраните. Това се дължи на бъг, при който TemplateData е вграден (т.е. присъстващ в Шаблон:Cite_web/doc вместо директно върху Шаблон:Cite_web) и не се зарежда в базата данни, докато не се редактира шаблона родител; вижте.

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.