Citoid/Enabling Citoid on your wiki/uk

Citoid — це генератор автоматично заповнених цитувань, який автоматично створює заповнений шаблон цитування із онлайн-джерел, на основі URL або ж якогось академічного ідентифікатора на кшталт DOI, PMID чи PMCID. Запланована також підтримка ISBN. Зараз він доступний як окрема функція у Візуальному редакторі, однак пізніше його використання уможливлять і для редактора вікірозмітки. Citoid використовує перекладачів Zotero для трансформування посилання на сторінку у деталізовану інформацію.





Крок 1: Увімкніть інструмент цитування
Сервіс Citoid використовує інструмент цитування у Візуальному редакторі. Цей інструмент вже увімкнений у більшості великих Вікіпедій, а також в багатьох менших проектах. Якщо інструмент цитування вже увімкнений, у меню «» можна побачити один або більше локальних шаблонів цитувань, на додаток до типів цитувань «» та «». Якщо ж інструмент цитування не увімкнений, тоді Вам доведеться його увімкнути, перш ніж перейти до виконання наступного кроку. Кожен шаблон цитування потребуватиме звичайного блоку TemplateData для того, щоб Візуальний редактор міг його використовувати.

Крок 2: Налаштуйте Citoid
Конфігурація розширення Citoid відбувається за допомогою спеціальних карт TemplateData, а також спеціальної сторінки зі специфічним кодом для сервісу Citoid. Дуже важливо виконати ці два кроки в строго такому ж порядку, в якому вони й подані тут.

Крок 2.а: створіть секцію з картами для Citoid у кожному з шаблонів цитувань
Оскільки Citoid має свій власний набір полів для кожного типу документу (зокрема, «журнал» у Citoid записаний як «publicationTitle», але як «journal» у шаблоні Template:Cite_journal), Вам доведеться додати спеціальну секцію TemplateData до відповідних шаблонів, аби вони працювали з Citoid. Такий особливий блок TemplateData забезпечить карту, що сполучатиме поля сервісу Citoid із полями відповідних шаблонів. This special mapping creates a map between Citoid's fields and the template's fields. Якщо надати карті назву «Citoid», це дасть змогу сервісу Citoid дізнатися, яку саме карту шукати. У секції «maps» дозволяється використовувати нескінченну кількість карт із унікальними ключами. Зверніть увагу, що карти TemplateData можна переглядати лише в режимі редагування; їх не видно у таблиці TemplateData. An unlimited number of maps with unique keys are allowed in the maps object. Note that you can only see TemplateData maps in edit mode; they are not visible in the TemplateData table. Also note that if you recently created TemplateData for your wiki by copying it from another wiki, it probably already includes the Citoid maps, so you can just skip this step after verifying.

Найновіші секції «maps», сумісні з розширенням Citoid, перебувають у бета-версії Вікіпедії:
 * w:Template:Cite news/doc
 * w:Template:Cite journal/doc
 * w:Template:Cite web/doc
 * w:Template:Cite book/TemplateData
 * w:Template:Citation/doc

Крок 2.б: Налаштування спеціальної сторінки MediaWiki
Вам треба буде налаштувати спеціальну сторінку в просторі назв MediaWiki — MediaWiki:Citoid-template-type-map.json. Ця сторінка поєднує власні типи сервісу Citoid (website, book, journalArticle) із відповідними шаблонами (Cite web, Cite book, Cite journal). This message maps the 34 native Citoid types (, ,  ,  ,  , etc.) to the appropriate templates (Cite web, Cite book, Cite journal, etc.).

Вам треба поєднати шаблон цитування із кожним типом сервісу Citoid. Якщо для окремого типу не буде вказано жодного шаблону, Citoid не працюватиме. Тож краще підібрати неточний варіант, аніж залишити взагалі без шаблону. Наприклад, у Вашій вікі може не бути спеціального шаблону для цитування вкладишів в упаковці для DVD, тож у цьому випадку скористайтеся шаблоном для книги або відео. Можна використати загальний шаблон, як в en.wiki Template:Citation, який годиться для усіх типів, якщо для використаного Вами типу джерела немає окремого шаблону. You may consider using a generic template, such as en.wiki's Template:Citation, as a catch-all for types if there is no good match for the type of source you are mapping.

Зразок повідомлення простору назв тут: Citoid/MediaWiki:Citoid-template-type-map.json.

Citoid has disappeared from my wiki
Please report any outage on Phabricator, and see that task for a temporary workaround.

Нова кнопка цитування не з'являється на панелі інструментів


Коли Ви створюєте повідомлення MediaWiki на кроці 2.b, попереднє випадне меню цитування (File:VisualEditor_-_Cite_Pulldown-uk.png) у меню панелі інструментів має бути замінене новою кнопкою сервісу citoid. Якщо нова кнопка не з'являється на панелі інструментів, може бути проблема з MediaWiki:Citoid-template-type-map.json. If the new button does not appear in the toolbar, then there may be a problem with MediaWiki:Citoid-template-type-map.json. Якщо сторінка не існує локально або JSON на цій сторінці некоректний, тоді citoid не працюватиме. В іншому разі, Вам треба оновити кеш JavaScript.

З'являються пусті примітки
Пусті примітки з'являються зазвичай тоді, коли Ви намагаєтеся вставити шаблон цитування, який не має даних карт. Ця проблема виникає також, якщо шаблон має дані карт, але вони не досягають MediaWiki API. Якщо об'єкт карт наявний у блоці TemplateData в документації шаблону, спробуйте зробити в шаблоні «нульове редагування». Якщо це не спрацює, тоді може бути проблема з самою картою. If that doesn't work, then there may be an issue with the map itself.

Citoid не розпізнає мій улюблений сайт і видає лише базову інформацію
Сервіс Citoid покладається на прекрасну спільноту Zotero у більшій частині «магії», оскільки перекладачі Zotero мають бути написані для кожного сайту. Ви можете переглянути список усіх перекладачів Zotero на https://github.com/zotero/translators. Зараз же Zotero найкраще підтримує англомовні джерела. You can see a list of all Zotero translators at https://github.com/zotero/translators. Right now, Zotero best supports English-language sources. Нам потрібна Ваша допомога з покриттям інших сайтів. Ви можете написати власний перекладач Zotero. Почніть з пошуку існуючого перекладача подібного вебсайту і читання загальних інструкцій щодо розробки фреймворку на https://www.zotero.org/support/dev/translators/framework. You can write your own Zotero translator. Start by looking at an existing translator of a similar website, and by reading the tutorial at Citoid/Creating Zotero translators.

Dates are formatted differently on my wiki
Dates with full information (month, year, and day) are in ISO format, which is an international standard. If the community doesn't like the way this looks to the user, it is possible to edit the citation template to format the ISO dates to something that is standard in your language. For instance, you can add logic to the template such that if the date is detected to be in ISO yyyy-mm-dd format, the date is reformatted *to appear* to be dd/mm/yyyy on the page. However, if you do this, the underlying data (i.e. when you edit the wikitext, or the form in VisualEditor) will still remain the same.

Dates with only month and year are currently in English. See.

Many language wiki templates (pl, it, en) don't accept xx-XX style language codes
See for the related task. See the thread at to learn how different wikis decided to workaround this limitation.

Див. також

 * Посібник Zotero
 * Сервер перекладу Zotero -- xpcshell-базований сервер перекладу Zotero та zotero-вузол, еквівалент nodejs
 * Коректні назви полів для кожного типу елементів
 * Відображення полів Zotero
 * Research:Citoid support for Wikimedia references
 * https://www.zotero.org/support/dev/translators/testing
 * Learn how to write a translator with Sebastian Karcher, Zotero (video, slides, links)
 * List of websites with Zotero translators
 * Examples of different itemType URLs
 * James Forrester talks Citoid and Zotero at m:WikiCite 2017