Citoid/Enabling Citoid on your wiki/bg

Citoid is an auto-filled citation generator which automatically creates a citation template from online sources based on a URL or some academic reference identifiers like DOIs, PMIDs, or PMCIDs. Support for ISBNs is planned. Понастоящем е достъпен като функция на Визуалния редактор, но в бъдеще ще бъде достъпен и в уикитекстовия редактор. Citoid използва Zotero преводачи за преобразуване на линк към страница в подробна информация.

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

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

Стъпка 2.а: Създаване на 'Citoid' карти със стойност за всеки шаблон Източник
Тъй като Citoid има свой собствен набор от полета за всеки тип документ (например, името в journal се нарича "publicationTitle" в Citoid, но "journal" в Шаблон:Cite_journal), трябва да добавите специален TemplateData за Citoid. Този специален TemplateData създава карта между полетата на Citoid и тези на шаблона. Повикването на картата "Citoid" позволява на разширението да узнае коя карта да търси. В обекта с карти се допускат неограничен брой карти с уникални ключове. Имайте предвид, че можете да видите TemplateData картите само в режим на редактиране; те не са видими в таблицата TemplateData.

Най-актуалните обекти с карти, които са съвместими с разширението Citoid, се намират на бета версията на Уикипедия:
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_news/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_journal/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_web/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_book/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Citation/doc

Стъпка 2.б: Конфигуриране на специално МедияУики съобщение
Трябва да конфигурирате специално МедияУики: съобщение за именно пространство, MediaWiki:Citoid-template-type-map.json. Това съобщение свързва оригиналните Citoid видове (website, book, journalArticle) със съответния шаблон (Cite web, Cite book, Cite journal).

Трябва да свържете локалния шаблон за цитиране с всеки отделен вид Citoid. Ако не съвпада поне един шаблон, тогава Citoid няма да работи. По-добре е да има лошо съвпадение, отколкото никакво. Например, уикито ви няма специален шаблон за цитиране на обложки на DVD, така че в този случай помислете за използването на шаблон, предназначен за книга или видео. Ако нямате добро съвпадение за вида източник, към който насочвате, може да обмислите възможността за използване на генеричен шаблон, например шаблона от английската Уикипедия Template:Citation като универсален за всички видове.

Примерно съобщение в именно пространство може да откриете тук: Citoid/MediaWiki:Citoid-template-type-map.json.

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

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


When you create the MediaWiki message in step 2.b, the previous cite drop-down menu (File:VisualEditor_-_Cite_Pulldown.png) should be replaced by a new button for the citoid service in the toolbar menu. If the new button does not appear in the toolbar, then there may be a problem with MediaWiki:Citoid-template-type-map.json.If this page does not exist locally, or if the JSON on that page is invalid, then citoid will not work. Alternatively, you may need to refresh your JavaScript cache.

Empty references appear
Empty references most commonly appear when you are trying to insert a citation template that has no maps data. This problem also appears if the template has maps data, but that data is not reaching the MediaWiki API. If the maps object is present in TemplateData block in the template's documentation, then try making a "null edit" on the template. If that doesn't work, then there may be an issue with the map itself.

My favorite site isn't recognized by Citoid and only gets basic information
The Citoid service relies on the brilliant Zotero community for much of the "magic", as Zotero translators need to be written for each site. You can see a list of all Zotero translators at https://github.com/zotero/translators. Right now, Zotero best supports English-language sources. We need your help to improve coverage of other sites. You can write your own Zotero translator. Start by looking at an existing translator of a similar website, and by reading the general development framework instructions at https://www.zotero.org/support/dev/translators/framework.

Access date is formatted differently on my wiki
The dates are in ISO format, which is an international standard. On the back-end, we're sticking to ISO and in the future all dates will all be in ISO, not just access date. This is because it is an unambiguous way to present the date in any language. 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.

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

Вижте също

 * Ръководство за Zotero
 * Zotero translation server -- xpcshell-based Zotero translation server, and zotero-node, an abandoned nodejs equivalent
 * Valid field names for each item type
 * Zotero field mappings
 * Research:Citoid support for Wikimedia references
 * https://www.zotero.org/support/dev/translators/testing
 * http://citoid.wmflabs.org
 * Learn how to write a translator with Sebastian Karcher, Zotero (video, slides, links)
 * Списък на сайтове със Zotero преводачи
 * Examples of different itemType URLs