Zobrazení zdroje stránky Modul:Wikidata/Formatters/Dokumentace

{{Podstránka s dokumentací}}

Interní modul, který zprostředkovává převod strukturovaných dat do wikitextu. Každému typu hodnoty je vytvořen základní formátovací submodul, pro účely specifického formátování lze naprogramovat vlastní formátovací submodul.

== Struktura submodulu ==
{{#tag:syntaxhighlight|
-- vzorový submodul, viz [[Modul:Wikidata/Formatters/empty]]

{{Modul:Wikidata/Formatters/empty}}
|lang=Lua
}}
Doporučeno je implementovat a exportovat tyto tři metody:
; <code>getRawValue</code>
: Převede strukturovaná data do ''raw'' hodnoty, kterou lze dále zpracovávat (např. šablonami nebo parserovými funkcemi ve wikitextu). Návratovou hodnotou může být řetězec nebo objekt (tabulka) implementující metametodu <code>[[mw:Extension:Scribunto/Lua reference manual#tostring|__tostring]]</code>.
; <code>formatRawValue</code>
: Převede ''raw'' hodnotu (typicky takovou, kterou vrací <code>getRawValue</code>) do wikitextu, který bude zobrazen čtenáři.
; <code>formatValue</code>
: Zformátuje strukturovaná data do wikitextu, který bude zobrazen čtenáři. Lze implementovat jako ve vzorovém modulu kombinací <code>getRawValue</code> a <code>formatRawValue</code> nebo samostatně, zvlášť pokud by se takto ztrácely informace.

== Dostupné submoduly ==
'''Základní:'''
* [[Modul:Wikidata/Formatters/globecoordinate]] – zeměpisné souřadnice
* [[Modul:Wikidata/Formatters/monolingualtext]] – text v jazyce
* [[Modul:Wikidata/Formatters/quantity]] – číselné hodnoty (s jednotkami)
* [[Modul:Wikidata/Formatters/string]] – textové řetězce
* [[Modul:Wikidata/Formatters/time]] – časové údaje
* [[Modul:Wikidata/Formatters/wikibase-entityid]] – odkazy na jiné položky

'''Vlastní:'''
* [[Modul:Wikidata/Formatters/approx]] – číselné hodnoty slovy (pro {{š|Počet obyvatel}})
* [[Modul:Wikidata/Formatters/email]] – odkazy na e-maily
* [[Modul:Wikidata/Formatters/flag]] – státy s vlajkami
* [[Modul:Wikidata/Formatters/round]] – lidsky čitelné číselné údaje velkých řádů
* [[Modul:Wikidata/Formatters/url]] – odkazy na webové stránky
* a [[Speciální:Stránky podle začátku/Modul:Wikidata/Formatters/|další]]

<includeonly>
{{Zamčeno}}
[[Kategorie:Wikipedie:Moduly]]
</includeonly>