Jump to content
MediaWiki

Rozšíření:CommonsMetadata

From mediawiki.org
This page is a translated version of the page Extension:CommonsMetadata and the translation is 100% complete.
Příručka k rozšířením MediaWiki
CommonsMetadata
Stav rozšíření: stabilní
Implementace API
Popis Pokusy o extrahování metadat ze stránek Commons
Autoři Brian Wolff (bawolff diskuse )
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
  • $wgCommonsMetadataForceRecalculate
  • $wgCommonsMetadataPublicDomainPageUrl
  • $wgCommonsMetadataSetTrackingCategories
Licence GNU General Public License 2.0 nebo novější
Stáhnout
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í:
    cdextensions/
    gitclonehttps://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
  • CopyrightedTrue 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

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.
Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích:

AltStyle によって変換されたページ (->オリジナル) /