Jump to content

Rozšíření:CommonsMetadata

Hlášení problémů: #CommonsMetadata
From mediawiki.org
This page is a translated version of the page Extension:CommonsMetadata and the translation is 100% complete.
Languages:
Příručka k rozšířením MediaWiki
CommonsMetadata
Stav rozšíření: stabilní
Zavádění API
Popis Pokusy o extrahování metadat ze stránek Commons
Autoři Brian Wolff (bawolffdiskuse)
Zásady kompatibility Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki 1.25+
PHP 5.4+
Změny v databázi Ne
Parametry
  • $wgCommonsMetadataForceRecalculate
  • $wgCommonsMetadataPublicDomainPageUrl
  • $wgCommonsMetadataSetTrackingCategories
Použité háčky (hooks)
Licence GNU General Public License 2.0 nebo novější
Stáhnout
Stáhněte si rozšíření
Git [?]:
Přeložte rozšíření CommonsMetadata, používá-li lokalizaci z translatewiki.net
Problémy Otevřené úkoly · Nahlásit chybu

Rozšíření CommonsMetadata je pokusem o extrahování metadat ze stránek Wikimedia Commons, ale je také dostupné ve všech ostatních projektech Wikimedie. Přidává do rozhraní imageinfo API další informace na základě šablon a kategorií v popisu obrázku. Používá ho několik rozšíření/nástrojů (například Extension:MultimediaViewer , Extension:VisualEditor , Extension:MobileFrontend , Mobile-Content-Service (MCS)) k poskytování lepších lightboxů nebo dialogů pro výběr obrázků.

Rozšíření v jeho současné podobě má být dočasným řešením, které bude nakonec nahrazeno Wikidata na Commons.

Instalace

  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného CommonsMetadata ve vaší složce extensions/.
    Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:
    cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CommonsMetadata
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód: 
    wfLoadExtension( 'CommonsMetadata' );
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Motivace a designové volby

Podívejte se na stránku mailarchive:wikitech-l/2013-August/071593.html

Předpoklady tohoto rozšíření jsou následující.

  • V budoucnu převezme Wikidata správu metadat na Commons. Aby se předešlo rušivým změnám, které bude brzy nutné znovu změnit, mělo by rozšíření fungovat s běžnými metadaty tak, jak je to v současnosti (takže by nezavádělo nové funkce parseru). Proto se používá screen scraping.
  • Obsah mnoha polí na stránce s popisem Commons zahrnuje bohaté formátování (zejména: odkazy, kurzívu, tučné písmo. V některých případech i složitější věci, jako jsou vložené obrázky).
    • Výsledkem je, že rozšíření vypíše analyzovaný html kód (wikitext je na nic, prostý text data nezachytí).
    • Data navíc bývají formátována pro zobrazení lidmi, nikoli (například) pro data formátovaná strojem. Pokud pole s datem uvádí něco jako "kolem roku 17. století", je obtížné to převést na přesné datum (může být mnoho příkladů).
    • Pro uplatnění tohoto postupu použijte také formátování metadat EXIF, které je řízeno na wiki (například Commons propojuje název kamery s článkem na Wikipedii).
  • Pokud se nám nepodaří extrahovat informace z popisné stránky, ale soubor má autora označeného v metadatech EXIF/XMP/iptc, měli bychom to použít jako záložní řešení.
  • V ideálním případě by takový systém byl co nejvíce zaměřen na Commons, s oddělenými částmi Commons a těmi, které nesouvisejí s Commons.
  • Stránky s popisem na Commons mají vícejazyčné popisy. Mnoho uživatelů pravděpodobně chce jeden jazyk.
    • Tato implementace platí pro data a položky podle jazykových konvencí. Navíc pro explicitně vícejazyčná pole (popis) existuje možnost vrátit všechny jazyky nebo pouze jeden jazyk. I v režimu jednoho jazyka jsou některé položky stále specifické pro daný jazyk (například oddělovač tisíců u čísel).

Konfigurace

Parametr Výchozí Popis
$wgCommonsMetadataSetTrackingCategories false Pokud odpovídající informace nejsou poskytnuty prostřednictvím šablon na stránce souboru (pro některé z těchto) metadat EXIF, přidejte na stránky souborů následující kategorie sledování:
  • Files with no machine-readable license (commonsmetadata-trackingcategory-no-license)
  • Files with no machine-readable description (commonsmetadata-trackingcategory-no-description)
  • Files with no machine-readable author (commonsmetadata-trackingcategory-no-author)
  • Files with no machine-readable source (commonsmetadata-trackingcategory-no-source)
  • Files with no machine-readable patent (commonsmetadata-trackingcategory-no-patent) (pro 3D soubory)
$wgCommonsMetadataPublicDomainPageUrl https://commons.wikimedia.org/wiki/Help:Public_domain Odkaz použitý pro atribut 'license' v kódu schema.org pro soubory ve veřejné doméně.
$wgCommonsMetadataForceRecalculate false Vynucení výpočtu metadat, i když obrázek pochází z cizího repozitáře, který by je poskytoval. To je určeno pro místní rozvoj.

Testování

Varování Varování: Pokud toto rozšíření vyvíjíte nebo testujete, NE doporučujeme kopírovat šablony Commons pro metadata obrázků, protože jejich kompilace trvá extrémně dlouho a mají složité závislosti jako Scribunto. Místo toho si pořiďte rozšířenou verzi pouze s wikitextem/HTML a ručně vkládejte různé odkazy na parametry (nebo to nedělejte). Příklad (pro použití se "Special:Import") naleznete zde. Nebo použijte Vagrant, který standardně obsahuje určité šablony.

Při testování se vzdálenými obrazy (např. obrazy z Commons, pokud jste povolili $wgUseInstantCommons ) můžete nastavit $wgCommonsMetadataForceRecalculate = true;, aby CommonsMetadata analyzoval stránku s popisem obrazu a extrahoval metadata (obvykle, pokud by vzdálený repozitář měl také nainstalovaný CommonsMetadata, pouze by zkopíroval výstup API odtud).

Použití

Použijte API imageinfo a zahrňte vlastnost extmetadata jako informační vlastnost obrázku specifikovanou pomocí iiprop.

Příklad

https://commons.wikimedia.org/w/api.php?action=query&prop=imageinfo&format=json&iiprop=extmetadata&iilimit=10&titles=File%3ACommon%20Kingfisher%20Alcedo%20atthis.jpg

Zobrazit tento příklad v API sandboxu:

https://www.mediawiki.org/wiki/Special:ApiSandbox#action=query&prop=imageinfo&format=json&iiprop=extmetadata&iilimit=10&titles=File%3ACommon%20Kingfisher%20Alcedo%20atthis.jpg

Vrácená data

Rozšíření aktuálně poskytuje v poli extmetadata odpovědi následující položky (názvy polí byly, pokud možno, zvoleny tak, aby odpovídaly formátu IPTC-IIM používanému v záhlavích EXIF):

Data založená na strojově čitelných datech v šabloně Informace:

  • ImageDescription – popis obrázku
  • Artist – jméno autora (může obsahovat složitý HTML kód, více autorů atd.)
  • Credit – zdroj
  • DateTimeOriginal – čas vytvoření (časové razítko ISO 8601 oddělené mezerami, kdykoli je to možné, ale může to být jakýkoli jiný textový popis data, případně s příměsí HTML)
  • ObjectName – název (u knihy/obrazu; jinak pouze název souboru)
  • Permission – obsah pole Oprávnění v šabloně. Může to být mnoho věcí (šablona licence, ID OTRS, podrobnosti o tom, jak přiřadit...)
  • AuthorCount – počet šablon s autory (např. Kniha, Fotografie...). Počet skutečných autorů může být vyšší, pokud šablona popisuje více autorů v jednom řetězci.

Data založená na strojově čitelných datech v šabloně umístění:

  • GPSLatitude – zeměpisná šířka
  • GPSLongitude – zeměpisná délka
  • GPSMapDatum – typ souřadnic (prozatím podporován pouze WGS-84)

Data založená na strojově čitelných datech v šabloně licence:

  • LicenseShortName – krátký lidsky čitelný název licence
  • LicenseUrl
  • UsageTerms
  • Copyrighted – True nebo False (pro obrázky ve veřejné doméně)

U obrázků s více licencemi jsou tyto hodnoty v současné době nespolehlivé.

  • Attribution – vlastní zdroj, který by měl nahradit Artist + Credit (může také pocházet ze šablony Informace)
  • AttributionRequired – booleanish (phab:T86726), určuje, zda existuje právní požadavek na přiřazení
  • NonFree – booleanish, true znamená, že obrázek není pod svobodnou licencí. (Používá se pouze pro obrázky mimo Commons.)

Další údaje:

  • CommonsMedadataExtension – obsahuje číslo verze analyzátoru metadat; většinou pro interní použití
  • License – nejlepší odhad licence obrázku (většinou pro interní použití programem MediaViewer, může se změnit; LicenseShortName je pravděpodobně spolehlivější)
  • Categories – seznam kategorií obrázku oddělený znaky |.
  • Assessments – seznam hodnocení obrázku oddělených znaky | (aktuálně je podporováno pět hodnot: poty, potd, featured, quality, valued). Na základě analýzy názvů kategorií pravděpodobně nebude fungovat pro obrázky, které nejsou hostovány na Commons.
  • Restrictions – omezení opětovného použití, jako jsou ochranné známky nebo práva na ochranu osobnosti; pole klíčových slov (názvy tříd z této tabulky, bez předpony restriction-). Viz také na restrict-* icons v MediaVieweru.
  • DeletionReason – pokud je nastaveno, šablona je zvažována k odstranění. (Na základě šablony nuke, mimo Commons pravděpodobně nespolehlivé.) Obsahuje důvod smazání, ale je formulován tak, aby se vztahoval na položku v protokolu, takže může být zavádějící (např. minulý čas, když ve skutečnosti ještě není rozhodnuto, zda bude obrázek smazán).

Související odkazy

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:CommonsMetadata/cs&oldid=8237904"