VisualEditor/Citation tool/ru

Инструмент цитирования VisualEditor позволяет пользователям использовать шаблоны цитирования вашей вики из VisualEditor. Чтобы включить этот инструмент, вам потребуется следующее: работающая установка VisualEditor и, шаблоны цитирования в вашей вики, использующие для указания того, как они вызываются, и специальное сообщение   для подключения VisualEditor и шаблоны вместе.



Импорт шаблонов цитирования
Вам понадобятся шаблоны цитирования в базе данных вашей вики, чтобы использовать любые функции цитирования. Если у вас в настоящее время нет шаблонов цитирования на вашей вики (например, в случае новой установки), вам необходимо их получить. Скопировать их из Википедии — самый простой способ сделать это. Если у вас уже есть шаблоны цитирования на вашей вики, вы можете пропустить эти шаги.


 * 1) Установите, , , . Большинство шаблонов цитирования в Википедии используют язык программирования Lua, который предоставляет Scribunto, а также функции парсера расширения. Расширение Цитата позволяет использовать теги . All Wikipedias and other WMF wikis already have all of these things installed.
 * 2) Экспорт шаблонов цитирования из Википедии: . Экспорт w:ru:Template:Cite web, w:ru:Template:Cite news, w:ru:Template:Cite journal, w:ru:Template:Cite book — хорошее место для начала. Для последних версий этих шаблонов в английской Википедии и некоторых других также требуются поддерживающие модули Lua.
 * 3) Загрузите свои шаблоны, используя страницу Special:Import в вашей вики (например, http://localhost/index.php/Special:Import).

Template data
Вам понадобится Extension:TemplateData, чтобы инструмент цитирования мог загружать данные шаблона в поля визуального редактора, и в каждом шаблоне должны быть определены данные шаблона. Для получения дополнительной информации о том, как определить данные шаблона для цитирования, а также для просмотра скриншотов того, как должно выглядеть окно цитирования с определенными данными шаблона и без него, см.: Wikipedia:VisualEditor/TemplateData

Citation tool definition
Чтобы включить Инструмент цитирования VisualEditor в вашей вики, вам нужно создать специальное конфигурационное сообщение в вашей вики:. Это связано с тем, что каждая вики отличается, и поэтому необходимо настроить функции, которые она хочет использовать; например, названия шаблонов, используемых в вашей вики, могут отличаться от названий других вики.

Purpose of the configuration message
Сообщение конфигурации:


 * Says which templates your wiki uses for standard citations (you can state up to 5).
 * Обратите внимание, что каждый шаблон должен иметь TemplateData определены, иначе система будет очень трудна для понимания пользователями. Если ваша вики в настоящее время не использует шаблоны цитирования, обычно копируют шаблоны из английской Википедии как хороший базовый набор.
 * Says which label you wish to use for each type of citation.
 * Есть стандартные четыре, "web, "book", "news" и "journal", которые соответствуют   и т.п..
 * Says which icon you wish to use for each type of citation.
 * Есть стандартные четыре: «ref-cite-web», «ref-cite-book», «ref-cite-news» и «ref-cite-journal». ", которые соответствуют классам CSS со значком в качестве фонового изображения SVG с именем   и тп.''

После создания конфигурационного сообщения  инструмент цитирования будет запущен для всех пользователей VisualEditor в вашей вики в течение нескольких минут.



Дополнительные типы
Если вы планируете добавить дополнительный тип, команда разработчиков хотела бы сначала поговорить с вами, чтобы дать совет, помочь создать соответствующую иконку, и поэтому мы можем рассмотреть вопрос о том, могут ли другие вики также захотеть, чтобы этот тип был определен для всех вики.

Чтобы добавить дополнительный тип, вам необходимо:


 * 1) Решите, какой тип вы хотите создать
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Create a label for it
 * 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, Polish Wikipedia, French Wikipedia, Italian Wikipedia. Copy the code to your wiki and adapt the names to the local context.

"Citation needed" tool
"Citation needed" templates can be configured to show an "Add a citation" button in the editor by configuring  with a   key.

The configuration value lists templates (which can contain multiple titles for redirects) and parameter mappings. Currently supported keys are:
 * - shows the reason a citation is needed in the context item
 * - shows the date "citation needed" template was added in the context item
 * - text which has been wrapped by the template, and which should be unwrapped when a citation is added

The value of these mappings is the name of the parameter(s) in the local template:

See the example definition on English 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.