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), трябва да добавите специално асоцииране, наречено 'citoid' в обекта  на  TemplateData за всеки шаблон за цитиране. This special mapping creates a map between Citoid's fields and the template's fields. Картата трябва да се нарича 'citoid', за да може разширението Citoid да знае коя карта да търси. 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.б: Конфигуриране на специално МедияУики съобщение
Трябва да конфигурирате специално МедияУики: съобщение за именно пространство,. This message maps the 34 native Citoid types (, ,  ,  ,  , etc.) to the appropriate templates (Cite web, Cite book, Cite journal, etc.).

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

Примерно съобщение в именно пространство може да откриете в Уикипедия на английски език: https://en.wikipedia.org/wiki/MediaWiki:Citoid-template-type-map.json.

Citoid изчезна от уикито ми
Моля, съобщавайте всяко прекъсване на работата на Phabricator и смятайте задачата за временно решение.

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


Когато създадете МедияУики съобщението в стъпка 2b, предишното падащо меню за цитиране (File:VisualEditor_-_Cite_Pulldown.png) трябва да бъде заменено с нов бутон за услугата Сitoid в менюто на лентата с инструменти. 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 преводачи за всеки сайт. You can see a list of all Zotero translators at https://github.com/zotero/translators. Right now, Zotero best supports English-language sources. Нуждаем се от вашата помощ, за да подобрим покритието и на други сайтове. 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 формат, който е международен стандарт. 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 in also in ISO (YYYY-MM) but these are not accepted by some citation templates. 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