Citoid/Enabling Citoid on your wiki/bg

Citoid е автоматичен генератор за попълване на цитиране, който автоматично създава шаблон за цитиране от онлайн източници, въз основа на URL-адреси или академични референтни идентификатори като DOI, PMID или PMCID. Планира се поддръжка за ISBN. Понастоящем е достъпен като функция на Визуалния редактор, но в бъдеще ще бъде достъпен и в уикитекстовия редактор. Citoid използва Zotero преводачи за преобразуване на линк към страница в подробна информация.





Стъпка 1: Активиране на инструмента шаблон за цитиране
Услугата Citoid използва инструмента за цитиране на Визуалния редактор. Той вече е активиран на по-големите Уикипедии и множество по-малки проекти. Ако инструментът за цитиране е активиран, тогава менюто "" ще изброява един или повече локални шаблона за цитиране, в допълнение към "" и "". Ако инструментът за цитиране не е активиран, тогава трябва да го активирате, преди да продължите. Всеки шаблон за цитиране ще изисква нормален TemplateData, за да работи.

Стъпка 2: Конфигуриране на Citoid
Разширението Citoid трябва да бъде конфигурирано с помощта на специални карти на TemplateData и специално и конкретизиращо Citoid съобщение. Важно е да направите тези две стъпки подред!

Стъпка 2.а: Създаване на 'Citoid' карти със стойност за всеки шаблон Източник
Тъй като Citoid има свой собствен набор от полета за всеки тип документ (например, името в journal се нарича "publicationTitle" в Citoid, но "journal" в Шаблон:Cite_journal), трябва да добавите специален TemplateData за Citoid. Този специален TemplateData създава карта между полетата на Citoid и тези на шаблона. This special mapping creates a map between Citoid's fields and the template's fields. Повикването на картата "Citoid" позволява на разширението да узнае коя карта да търси. В обекта с карти се допускат неограничен брой карти с уникални ключове. Имайте предвид, че можете да видите 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.

Най-актуалните обекти с карти, които са съвместими с разширението 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: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, така че в този случай помислете за използването на шаблон, предназначен за книга или видео. Ако нямате добро съвпадение за вида източник, към който насочвате, може да обмислите възможността за използване на генеричен шаблон, например шаблона от английската Уикипедия 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 изчезна от уикито ми
Моля, съобщавайте всяко прекъсване на работата на Phabricator и смятайте задачата за временно решение.

Новият бутон за цитиране не се появява в лентата с инструменти


Когато създадете МедияУики съобщението в стъпка 2b, предишното падащо меню за цитиране (File:VisualEditor_-_Cite_Pulldown.png) трябва да бъде заменено с нов бутон за услугата Сitoid в менюто на лентата с инструменти. Ако новият бутон не се появява, може би има проблем с 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 кеша си.

Появяват се празни препратки
Празните препратки най-често се появяват, когато се опитвате да вмъкнете шаблон за цитиране, който все още няма картови данни. Този проблем също така се случва, ако шаблонът има такива данни, но те не достигат приложно-програмния интерфейс на МедияУики. Ако картовия обект присъства в 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.

Датата за достъп е форматирана по различен начин в уикито ми
Датите са в ISO формат, който е международен стандарт. От страната на администраторския панел се придържаме към ISO и за в бъдеще всички дати ще бъдат в ISO, а не само датата на достъп. Това е така, защото е недвусмислен начин за представяне на датата на всички езици. Ако общността ви не харесва начина, по който това изглежда за крайния потребител, възможно е да редактирате шаблона за цитиране като форматирате ISO датите в нещо, което е стандарт за вашия език. Например, можете да добавите логическо правило в шаблона, така че ако е открита дата, която е в ISO формат гггг/мм/дд, тя да се преформатира *да се появява* на страницата във вида дд/мм/гггг. Все пак, ако направите това, базовите данни ще останат същите (т.е. когато редактирате в уикитекст или в режим на Визуален редактор). 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.

Много езикови уики шаблони (pl, it, en) не приемат xx-XX стил на езиковите кодове
Вижте за съответната задача. Вижте нишката от разговори в, за да научите как различните уикита решиха да заобиколят това ограничение.

Вижте също

 * Ръководство за Zotero
 * Zotero сървър за преводи -- xpcshell-базиран Zotero сървър за преводи и zotero-node, изоставен nodejs еквивалент
 * Валидни имена на полета за всеки вид елемент
 * Zotero field mappings
 * Изследване: Поддръжка на Citoid за цитирането в Уикипедия
 * https://www.zotero.org/support/dev/translators/testing
 * Learn how to write a translator with Sebastian Karcher, Zotero (video, slides, links)
 * Списък на сайтове със Zotero преводачи
 * Примери за различни itemType URL-адреси
 * James Forrester talks Citoid and Zotero at m:WikiCite 2017