Wikipedie:Wikidata/Přebírání do infoboxů: Porovnání verzí
Smazaný obsah Přidaný obsah
zatím přesměrování, obsah sem bude postupně doplněn |
rozpracování nápovědy k integraci Wikidat do infoboxů značka: editace z Vizuálního editoru |
||
Řádek 1:
{{Pracuje se||1. 4. 2017, 13:18 (CEST)}}
'''Přebíráním údajů z Wikidat''' se rozumí načítání údajů uložených v datových položkách sesterského projektu [[Wikipedie:Wikidata|Wikidata]] a zobrazování jich v článcích, nejčastěji pomocí [[Nápověda:Infoboxy|infoboxů]] nebo jiných [[Wikipedie:Šablony|šablon]].
== Motivace ==
{{Pahýl část}}
== Syntaxe ==
Pro zavedení přebírání údajů do infoboxu je nutné být dostatečně seznámen se způsoby [[Nápověda:Vytvoření infoboxu|jejich tvorby]] a mít alespoň základní znalosti o projektu Wikidata. V opačném případě je lepší přenechat tento úkon zkušenějším uživatelům, neboť nedomyšlené úpravy šablon mohou během chvíle způsobit technický problém v tisících článků.
Záměr zavést přebírání je také dopodoručeno oznámit na [[Wikipedie:Wikidata/Nástěnka|nástěnce Wikidat]] či diskusní stránce dané šablony, kde se k němu mají možnost vyjádřit ostatní uživatelé.
=== Parserové funkce ===
Na každém projektu Wikimedia, který má přístup k údajům na Wikidatech (v současné době se to netýká pouze všech jazykových verzí [[Wikislovník|Wikislovníku]]), jsou dostupné dvě parserové funkce. Jejich chování odpovídá [[Nápověda:Kouzelná slůvka|kouzelným slůvkům]], tzn. že jejich výstup je obvykle relativní k článku, do kterého jsou (byť skrze šablonu) vloženy.
První z nich se nazývá „#property:“ a dostupný je i její český alias „#vlastnost:“. Pro její správné fungování je nutné zadat, jaká vlastnost se má přebírat. To se provádí uvedením buď jejího identifikátoru, nebo současného českého štítku. Tyto údaje je možné zjistit na stránce vlastnosti, na kterou se dostanete tak, že v článku, ve kterém se nachází dotčený infobox, otevřete příslušející položku Wikidat kliknutím na odkaz ''Položka Wikidat'' vlevo v navigačním sloupci. Na stránce najděte vlastnost, kterou chcete přebírat, a klikněte na její nadpis. Máte-li zapnutý v rozhraní český jazyk, text hlavního nadpisu na stránce vlastnosti odpovídá jejímu českému štítku (není-li za ním uvedený jeho skutečný jazyk, např. ''angličtina''). Za hlavním nadpisem je poté v závorce uveden kód <code>P''číslo''</code>, kde ''číslo'' je pro každou vlastnost jiné. Celý zápis parserové funkce vypadá takto: <code><nowiki>{{#property:P</nowiki>''číslo''<nowiki>}}</nowiki></code> (pomocí identifikátoru) nebo <code><nowiki>{{#property:</nowiki>''štítek''<nowiki>}}</nowiki></code> (pomocí štítku). Mějte na paměti, že štítek vlastnosti může kdokoliv kdykoliv změnit, což danou funkci ve všech článcích okamžitě znefunkční a zobrazí chybovou hlášku. Proto se doporučuje použít její identifikátor, který je neměnný, tudíž stabilní. Zejména pro testovací účely je dostupný i nepovinný parametr <code>from=</code>, jehož hodnotou je identifikátor položky (ve tvaru <code>Q''číslo''</code>), ze kterého se mají údaje přebírat. Pokud ten není uveden, což je v šablonách žádoucí, touto položkou je ta, se kterou je daná stránka propojená [[Nápověda:Mezijazykové odkazy|mezijazykovým odkazem]].
Druhá, novější parserová funkce se nazývá „#statements:“. Zatímco zadávání jejích parametrů je shodné, její výstup je však odlišný, mimo jiné je opatřený HTML značkami. Ze srovnání obou funkcí vyplývá, že výstup „#property:“ neobsahuje odkazy a pro prezentační účely se hodí méně než „#statements:“.
{| class="wikitable" style="clear: all;"
|+ Porovnání parserových funkcí
! Vlastnost
! colspan="2" | Hlavní město (P36)
! colspan="2" | Vlajka (P41)
! colspan="2" | Identifikátor v databázi VIAF (P214)
|-
! Funkce !! property: !! statements: !! property: !! statements: !! property: !! statements:
|-
! Stránka [[Česko]]
| {{#property:P36|from=Q213}}
| {{#statements:P36|from=Q213}}
| {{#property:P41|from=Q213}}
| {{#statements:P41|from=Q213}}
| {{#property:P214|from=Q213}}
| {{#statements:P214|from=Q213}}
|-
! Stránka [[Německo]]
| {{#property:P36|from=Q183}}
| {{#statements:P36|from=Q183}}
| {{#property:P41|from=Q183}}
| {{#statements:P41|from=Q183}}
| {{#property:P214|from=Q183}}
| {{#statements:P214|from=Q183}}
|}
=== Modul Wikidata ===
Na české Wikipedii se místo výše popsaných parserových funkcí prosadilo využívání [[Modul:Wikidata|modulu Wikidata]], jehož hlavní předností daleko větší počet možností, které může kterýkoliv uživatel doplňovat (v praxi pouze uživatelé mající potřebné schopnosti pro tvorbu modulů).
Jako každý jiný modul, se i tento volá pomocí parserové funkce „#invoke:“. Za dvojtečkou je nutné uvést název modulu, tedy „Wikidata“, a funkci modulu, která se má volat, oddělenou od názvu modulu svislítkem. V [[Modul:Wikidata/Dokumentace|dokumentaci modulu]] je v prvním sloupci tabulky uvedeno hned několik funkcí, nicméně tou nejdůležitější, jejíž úkolem je zobrazovat údaje z Wikidat, je <code>formatStatements</code>. Základní zápis tedy vypadá takto: <code><nowiki>{{#invoke:Wikidata|formatStatements}}</nowiki></code>. Podobně jako u parserových funkcí však tento základní zápis nestačí, dalším povinným údajem je taktéž daná vlastnost, kterou však lze ze zmíněných důvodů uvést pouze pomocí identifikátoru. Tento údaj se pak stejně jako další nepovinné zadávají jako parametry v šabloně, konkrétně vlastnosti odpovídá pojmenovaný parametr <code>property</code>. Jejich kompletní seznam je opět uvedený v dokumentaci, zde jsou uvedeny jen ty nejdůležitější:
* <code>rank=</code> → postavení zobrazených hodnot (jeho výchozí hodonota je <code>valid</code>, což odpovídá zobrazení tvrzení jak preferovaných, tak s normálním postavením; další jsou například <code>preferred</code>, tedy preferovaná hodnota, nebo <code>best</code>, tedy buď preferovaná hodnota, nebo jiná hodnota s normálním postavením, pokud není žádná jiná preferovaná)
* <code>separator, conjunction=</code> → modul hodnoty obvykle odděluje čárkami a poslední dvě spojkou „a“, tyto parametry však můžou vynutit jiný oddělovač, resp. spojku, případně lze pomocí <code><nowiki><br /></nowiki></code> (v obou parametrech) umístit
* <code>limit=</code> → kolik nejvýše chceme zobazit hodnot (např. pokud nám stačí jen jedna nebo jich nechceme příliš)
** pokud k limitu připojíte parametr <code>showmore=true</code>, v případě, by byl limit překročen, se zobrazí text „více na Wikidatech...“ s odkazem přímo na dané údaje
* <code>showqualifier=</code> → vymezení, které se má zobrazit s hodnotou (např. datum, ke kterému se vztahuje počet obyvatel); zadává se jako identifikátory vlastností oddělené čárkou, případně lze pro kombinaci od–do použít hodnotu <code>time</code>
* <code>sort=</code> → vynucení vlastního pořadí hodnot: <code>alpha</code> – podle abecedy, <code>date</code> – podle časového údaje ve vymezení
== Lokální zadávání versus Wikidata ==
{{Pahýl část}}
| |||