MediaWiki/Rozšíření/citoid

Na této stránce shromažďujeme všechny informace a zkušenosti s rozšířením citoid = nástroj na vyplňování citačních šablon, dostupný jako fíčura mw: VisualEditoru.

Instalace

editovat

Citoid je w: nodejs aplikace, která vyžaduje instalaci Zotero's translation serveru a dalších věcí, což je zřejmě práce pro vývojáře. Neštěstí je citoid na Wikiverzitě již nainstalovaný.

Enabling

editovat

Nainstalovaný citoid je nutno na příslušném projektu povolit a nakonfigurovat, což je práce pro správce. Postup popisuje stránka mw: Citoid/Enabling Citoid on your wiki, podle které to budeme provádět.

Citation template tool

editovat

Musí být povoleno mw: VisualEditor/Citation tool. Pozná se to tak, že menu Cite ve VisualEditoru ukazuje různé citační šablony – tj. dám Citace/Ručně a kromě ikonky Základní podoba a Použít existující vidím i další ikonky různých citačních šablon. Na WP to vidím, ale zde na WV vidím jen Základní. Takže nutno pokračovat podle postupu, popsaného na mw: VisualEditor/Citation tool#Citation tool definition:

Citation tool definition

editovat

Musíme vytvořit konfigurační zprávu MediaWiki:Visualeditor-cite-tool-definition.json

Podíváme se na příklad konfigurační zprávy na anglickojazyčné Wikipedii: w:en: MediaWiki:Visualeditor-cite-tool-definition.json – mají tam web, book, news a journal

V konfiguraci české WP máme: w: MediaWiki:Visualeditor-cite-tool-definition.json, tj. citační šablony:

Podíváme se na její zdrojový text:

[
    {
        "name": "book",
        "icon": "ref-cite-book",
        "template": "Citace monografie"
    },
    {
        "name": "online-book",
        "icon": "ref-cite-web",
        "template": "Citace elektronické monografie"
    },
    {
        "name": "news",
        "icon": "ref-cite-news",
        "template": "Citace periodika"
    },
    {
        "name": "online-news",
        "icon": "ref-cite-news",
        "template": "Citace elektronického periodika"
    }
]

A teď se podíváme na konfigurační zprávu anglickojazyčné Wikiverzity: v:en: MediaWiki:Visualeditor-cite-tool-definition.json – a tam nemají nic, zobrazuje se jen [null].

A co německá wikiverzita? v:de: MediaWiki:Visualeditor-cite-tool-definition.json – také [null]. Takže to vypadá, že Wikiverzity na to kašlou. Proč asi?

A nakonec se tedy podíváme na naši českou Wikiverzitu: MediaWiki:Visualeditor-cite-tool-definition.json – také null

Když se podívám na zdroj té stránky, je tam skutečně jen:

null

Upozornění: Editujete stránku, která definuje texty rozhraní. Změny této stránky ovlivní vzhled uživatelského rozhraní všem uživatelům této wiki.

A tak si tedy říkám, jestli by k tomu neměl napřed byrokrat udělit právo správce rozhraní?

No dobrá, jako první věc sem tedy zkusím importovat tu konfigurační zprávu z Wikipedie a uvidíme, co to udělá, případně ji pak budeme upravovat dle našich potřeb. Nechám importovat do implicitního umístění.

Dostal jsem hlášku:

Chyba databáze
Došlo k chybě při dotazu do databáze. Může to být způsobeno chybou v softwaru.
[XrfwEwpAICgAAB5R1UkAAABY] 2020-05-10 12:14:11: Kritická výjimka typu „Wikimedia\Rdbms\DBTransactionStateError“

Zkusím ještě importovat do Hlavního prostoru. Je to to samé.

Takže asi nezbyde nic jiného, než to zkusit metodou C&P.

Poznámka: Po uložení musíte vyprázdnit cache vašeho prohlížeče, jinak změny neuvidíte.

  • Firefox / Safari: Při kliknutí na Aktualizovat držte Shift nebo stiskněte Ctrl-F5 nebo Ctrl-R (na Macu ⌘-R)

O.K., a teď už se nám to ve VizualEditoru zobrazuje stejně jako na WP., i když dosud (jak se dalo očekávat) nefunguje vše jak má:

  • Šablona:Citace monografie – ikona Kniha – Šablona „Šablona:Citace monografie“ zatím nemá popis, ale nějaké informace by se mohly nacházet na její stránce – (políčka se nezobrazují)
  • Šablona:Citace elektronické monografie – ikona Elektronická monografie – <visualeditor-cite-tool-name-online-book> Citace elektronické monografie. Šablona umožňuje generování citací elektronických monografií dle norem ČSN ISO 690 a ČSN ISO 690-2. Další informace o šabloně „Citace elektronické monografie“ by mohly být uvedeny na její stránce. (políčka se zobrazují)
  • Šablona:Citace periodika – ikona Časopis/novinyCitace periodika. Šablona „Šablona:Citace periodika“ zatím nemá popis, ale nějaké informace by se mohly nacházet na její stránce. (políčka se nezobrazují)
  • Šablona:Citace elektronického periodika – ikona Časopis na webu – <visualeditor-cite-tool-name-online-news> Citace elektronického periodika. Šablona „Šablona:Citace elektronického periodika“ zatím nemá popis, ale nějaké informace by se mohly nacházet na její stránce. (políčka se nezobrazují)

Takže zatím jediná fungující šablona, která něco vkládá, je citace elektronické monografie – dobrý začátek, zkusíme se od něj odpíchnout.

Aktualizace šablon

editovat

Citační šablony jsem importoval na WV z WP 2015-08-24. Od té doby šablony procházely na WP různými revizemi. 2020-05-10 User:Martin Urbanec importoval nové revize šablon z WP a udělal pár dalších věcí a už by to mělo teoreticky chodit – viz Diskuse s uživatelem:Martin Urbanec#Citoid, Fórum:Správci/Citace#Cesta k nápravě.

Testuji:

  • Přidat citaci:
    • Ručně – namísto Elektronická monografie a Časopis na webu se zobrazuje: <visualeditor-cite-...
      • citace knihy – funguje
      • citace elektronického periodika – funguje,
    • automaticky