Citoid/Увімкнення сервісу Citoid у Вашій вікі

From mediawiki.org
This page is a translated version of the page Citoid/Enabling Citoid on your wiki and the translation is 100% complete.
Languages:
Основна сторінка: Citoid

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

Крок 1: Увімкніть інструмент цитування

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

Крок 2: Налаштуйте Citoid

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

Крок 2.a: Створіть значення мап «citoid» для кожного шаблону цитування 

Основна сторінка: Citoid/Maps TemplateData
Поля ISSN, ISBN, автор, редактор та деякі інші є спеціальними полями, які також можуть бути масивами [] або 2D масивами [[]] на мапі цитоїда. Докладніше

Оскільки Citoid має свій власний набір полів для кожного типу документу (зокрема, «журнал» у Citoid записаний як «publicationTitle», але як «journal» у шаблоні Template:Cite_journal), вам потрібно додати спеціальне зіставлення під назвою «citoid» в об'єкт maps TemplateData для кожного шаблону цитування. Це спеціальне зіставлення створює мапу між полями Citoid і полями шаблону. Мапа має називатися «citoid», щоб розширення Citoid знало, яку мапу шукати. В об’єкті map можна використовувати необмежену кількість мап з унікальними ключами. Зауважте, що ви можете переглядати мапи TemplateData лише в режимі редагування; вони не відображаються в таблиці TemplateData. Також зауважте, що якщо ви нещодавно створили TemplateData для своєї вікі, скопіювавши його з іншої вікі, він, ймовірно, вже містить мапи Citoid, тому ви можете просто пропустити цей крок після перевірки.

Найновіші секції «maps», сумісні з розширенням Citoid, перебувають у англійській Вікіпедії:

Крок 2.б: Налаштування спеціальної сторінки MediaWiki

Вам треба буде налаштувати спеціальну сторінку в просторі назв MediaWiki — MediaWiki:Citoid-template-type-map.json. Це повідомлення зіставляє 34 рідні типи Citoid (artwork, book, journalArticle, tvBroadcast, website, тощо) у відповідні шаблони (Cite web, Cite book, Cite journal тощо).

Вам треба поєднати шаблон цитування із кожним типом сервісу Citoid. Якщо для окремого типу не буде вказано жодного шаблону, Citoid не працюватиме. Тож краще підібрати неточний варіант, аніж залишити взагалі без шаблону. Наприклад, у вашій вікі може не бути спеціального шаблону для цитування приміток на упаковці для DVD-диска, тому подумайте про використання шаблону, призначеного для книги чи відео в цьому випадку. Ви можете розглянути можливість використання загального шаблону, такого як Шаблон:Citation en.wiki, як загального для типів, якщо немає належної відповідності типу джерела, який ви зіставляєте.

Приклад повідомлення простору назв можна знайти в англійській Вікіпедії: https://en.wikipedia.org/wiki/MediaWiki:Citoid-template-type-map.json.

Виправлення проблем

Основна сторінка: Citoid#Troubleshooting_Citoid_VisualEditor_Extension

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

Кнопка Citoid на панелі інструментів

Коли ви створюєте повідомлення MediaWiki на кроці 2.b, попереднє спадне меню цитування (File:VisualEditor_-_Cite_Pulldown.png) має бути замінено новою кнопкою для служби citoid у меню панелі інструментів. Якщо нова кнопка не з’являється на панелі інструментів, можливо, проблема з MediaWiki:Citoid-template-type-map.json. Якщо сторінка не існує локально або JSON на цій сторінці некоректний, тоді citoid не працюватиме. В іншому разі, Вам треба оновити кеш JavaScript.

З'являються порожні примітки

Порожні примітки з'являються зазвичай тоді, коли Ви намагаєтеся вставити шаблон цитування, який не має даних мап. Ця проблема виникає також, якщо шаблон має дані карт, але вони не досягають MediaWiki API. Якщо об'єкт мап наявний у блоці TemplateData в документації шаблону, спробуйте зробити в шаблоні «нульове редагування». Якщо це не спрацює, можливо, проблема з самою мапою.

Citoid не розпізнає мій улюблений сайт і видає лише базову інформацію

Основна сторінка: Citoid/Determining if a URL has a translator in Zotero

Служба Citoid покладається на блискучу спільноту Zotero для більшої частини «магії», оскільки для кожного сайту потрібно написати перекладачів Zotero. Ви можете переглянути список усіх перекладачів Zotero за https://github.com/zotero/translators. Зараз Zotero найкраще підтримує англомовні джерела. Нам потрібна ваша допомога, щоб покращити охоплення інших сайтів. Ви можете написати власного перекладача Zotero. Почніть з перегляду існуючого перекладача подібного веб-сайту та з підручника за адресою Citoid/Створення перекладачів Zotero.

У моїй вікі дати форматуються по-різному

Дати з повною інформацією (місяць, рік і день) у форматі ISO, який є міжнародним стандартом. Якщо спільноті не подобається, як це виглядає для користувача, можна відредагувати шаблон цитування, щоб відформатувати дати ISO відповідно до того, що є стандартним для вашої мови. Наприклад, ви можете додати логіку до шаблону таким чином, що якщо виявляється, що дата має формат ISO yyyy-mm-dd, дата буде переформатована *так, щоб вона відображалася* як дд/мм/рррр на сторінці. Однак якщо ви це зробите, основні дані (тобто, коли ви редагуєте вікітекст або форму у візуальному редакторі) залишаться незмінними.

Дати, які містять лише місяць і рік, також вказано в ISO (РРРР-ММ), але деякі шаблони цитування не приймають їх. Див. завдання T132308.

Багато мовних вікі-шаблони (pl, it, en) не приймають мовні коди стилю xx-XX

Дивіться завдання T115326 для відповідного завдання. Перегляньте тему на завдання T97256, щоб дізнатися, як різні вікі вирішили обійти це обмеження.


Див. також

Retrieved from "https://www.mediawiki.org/w/index.php?title=Citoid/Enabling_Citoid_on_your_wiki/uk&oldid=6095288"