Rozšíření:WikibaseMediaInfo

Příručka k rozšířením MediaWiki

WikibaseMediaInfo Stav rozšíření: stabilní
Popis	Rozšíření Wikibase pro správu strukturovaných metadat mediálních souborů
Autoři	Tým strukturovaných dat
Nejnovější verze	průběžné aktualizace
MediaWiki	master
Změny v databázi	Ano
Parametry $wgMediaInfoMediaSearchProfiles $wgMediaInfoSupportedDataTypes $wgMediaInfoProperties $wgMediaInfoExternalEntitySearchBaseUri $wgMediaInfoCustomMatchFeature $wgMediaInfoHelpUrls $wgMediaInfoMediaSearchTitleMatchBaseUri
Přidaná práva mediainfo-term
Použité háčky (hooks) ArticleUndelete BeforePageDisplay CirrusSearchAddQueryFeatures CirrusSearchProfileService CirrusSearchRegisterFullTextQueryClassifiers GetEntityByLinkedTitleLookup GetEntityContentModelForTitle GetPreferences MediaWikiServices MultiContentSave ParserOutputPostCacheTransform ResourceLoaderRegisterModules RevisionUndeleted ScribuntoExternalLibraries SearchDataForIndex2 SidebarBeforeOutput WikibaseClientEntityTypes WikibaseRepoEntityNamespaces WikibaseRepoEntityTypes
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball readme
Přeložte rozšíření WikibaseMediaInfo
Problémy	Otevřené úkoly · Nahlásit chybu

WikibaseMediaInfo je rozšíření Wikibase , které přidává entitu MediaInfo pro zpracování strukturovaných dat o multimediálních souborech.

Rozšíření se napojí na stránku souboru. Ukládá doplňková metadata (titulky a popisky) o souboru v entitě MediaInfo Entity. Uživatel si může tato data prohlížet, vytvářet, upravovat a mazat.

Požadavky

• UniversalLanguageSelector
• CirrusSearch
• Wikibase (Client and Repository)
• WikibaseCirrusSearch

Instalace

• Ujistěte se, že jsou tato rozšíření správně nainstalována a nastavena: CirrusSearch, Wikibase (klient a repozitář) a WikibaseCirrusSearch.
• Stáhněte soubor/y a vložte je do adresáře pojmenovaného WikibaseMediaInfo 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/WikibaseMediaInfo
  

• Při instalaci z Gitu spusťte Composer pro instalaci závislostí PHP zadáním composer install --no-dev v adresáři rozšíření. (Vyskytnou-li se nějaké komplikace, podívejte se na T173141.)
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'WikibaseMediaInfo' );
  

• Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
• Vyžaduje nastavení v konfiguračním souboru..
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Uživatelské rozhraní MediaInfo

Entity MediaInfo se zobrazují na příslušné stránce File (soubor) a lze je z ní upravovat a také při nahrávání souboru pomocí UploadWizard.

There are separate sections in the UI for editing captions and statements.

An editing interface is always shown for default properties (defaults are defined in config). On live Commons, depicts is the only default property — users are encouraged to describe what an image depicts. Statements with other properties can be added by the user at will.

Slovník pojmů

Entita MediaInfo

Entita Wikibase, která obsahuje strukturovaná data o mediálních souborech. It is stored in a slot on a File page and consists of

• an ID in the form Mxxx, where xxx is the id of the associated wiki page
• libovolný počet titulků (jeden pro každý jazyk)
• libovolný počet výpisů

If there is no caption or statement data, then the entity is not stored in the database - in this case, it is known as a 'virtual entity'

Titulek

Krátký text popisující mediální soubor a jeho jazyk. Used to provide a short description of the file (the same as 'labels' in Wikibase).

Statement

A single fact about a media file consisting of a key-value pair such as Licence=CC-BY-SA or Depicts=Dog.

Keys are always a property. Values can be any wikibase datatype.

Strictly, a wikibase 'statement' means a key-value pair (a 'claim') plus a rank (preferred, normal, or deprecated) and zero or more documentary references. We don't typically have documentary references for descriptions of files, and all statements have a normal rank by default, so in MediaInfo, we prefer to use the term 'statement' instead of 'claim'.

Property

A property is a file's property that can have a value - for example, 'depicts' (what an image is a picture of), 'resolution', 'created by', 'license'. Each property has a unique id in wikibase in the form Pxxx such as P123.

Item

An item is a concept, topic, or object with an ID - for example, on Wikidata, the CC0 license is Q6938433, physics is Q413 and the planet Earth is Q2. Each item has a unique id in wikibase in the form Qxxx such as Q123.

Kvalifikátor

Kvalifikátor je sekundární tvrzení, které modifikuje primární tvrzení. Například obrázek může mít v popředí strom a v pozadí moře, v takovém případě k němu mohou být přiřazeny 2 tvrzení typu 'depicts' – 'depicts=tree(platí pro part=foreground)' a 'depicts=sea(platí pro part=background)'.

Vyhledávání

Hledat podle popisku

Uživatelé mohou vyhledávat soubory podle popisků MediaInfo stejně jako by vyhledávali cokoli jiného. Pokud například uživatel nahraje obrázek Eiffelovy věže a zadá jako vícejazyčné popisky souborů 'Tour Eiffel' (francouzsky) a 'Eiffel Tower' (anglicky), obrázek bude moci najít jiný uživatel, který vyhledává buď 'Eiffel Tower', nebo 'Tour Eiffel'.

Hledání tvrzení/výroků

Vyhledávání tvrzení/prohlášení probíhá pomocí klíčových slov WikibaseCirrusSearch. Podrobnosti viz: Help:WikibaseCirrusSearch

Implementace vyhledávání

Po uložení stránky Soubor se do indexu Elasticsearch zapíší následující data MediaInfo (všechny příklady používají vlastnosti Wikidata a ID položek):

• Data titulků ve všech jazycích jsou uložena v poli opening_text
• Deklarace jsou uloženy ve formátu propertyID=value jako prvky pole v poli statement_keywords s použitím ID vlastnosti Wikibase (a ID položky, pokud je hodnota položkou) - např. 'zobrazuje domácí kočku' je uloženo jako P180=Q146
• Nároky s kvalifikátory jsou uloženy v poli statement_keywords spolu s jejich kvalifikátory ve formátu propertyID=value[qualifierPropertyID=qualifierValue]. Například obraz Mona Lisa (položka Wikidat Q12418) zobrazuje oblohu (Q13217555) v pozadí (vlastnost Wikidat P518). Pokud bychom tato data uspořádali v nárocích Wikibase, vypadalo by to: „zobrazuje oblohu, vztahuje se na část pozadí“, což by bylo uloženo jako P180=Q12418[P518=Q13217555]
• Upozorňujeme, že nároky s kvalifikátory jsou také uloženy bez kvalifikátoru, aby se zvýšila jejich dohledatelnost. Takže například pokud někdo zadal výše uvedený klauzuli claim-plus-qualifier, uloží se také claim P180=Q12418, takže někdo může soubor najít jak samotným vyhledáváním 'depicts sky', tak i vyhledáváním 'depicts sky, applies to part background'.
• Data o deklaracích s kvalifikátory, kde hodnota kvalifikátoru je množství, jsou uložena v poli statement_quantity ve formátu propertyID=hodnota|množství, např. 'zobrazuje člověka, množství 1' je uloženo jako P180=Q5|1.

Upozorňujeme, že ne všechny deklarace identity jsou uloženy. Definice identity bude indexována v ElasticSearch, pouze pokud jsou splněny VŠECHNY následující podmínky:

• Nárok má skutečnou hodnotu (tj. jeho hodnota není 'žádná hodnota' nebo 'neznámá hodnota') A
• Víme, jak zpracovat jeho hodnotu pro indexování. V budoucnu mohou být přidány další procesory hodnot, ale v současné době požadujeme, aby hodnota deklarace byla buď ID položky Q, řetězec (alfanumerický), nebo množství (číselné) A
• ID vlastnosti deklarace na Wikidatech NENÍ v konfigurovatelném seznamu vyloučených ID ($wgWBRepoSettings[ 'searchIndexPropertiesExclude' ]) A buď je ID její vlastnosti v konfigurovatelném seznamu ID vlastností, které by měly být indexovány ($wgWBRepoSettings[ 'searchIndexProperties' ]) NEBO je typ její vlastnosti v konfigurovatelném seznamu typů vlastností, které by měly být indexovány ($wgWBRepoSettings[ 'searchIndexTypes' ])

Upozorňujeme, že aby bylo možné uložit množství v deklaraci, musí splňovat všechna výše uvedená kritéria A ID vlastnosti pro kvalifikátor množství musí být přítomno v konfigurovatelném seznamu ID vlastností ($wgWBRepoSettings[ 'searchIndexQualifierPropertiesForQuantity' ]).

Profil vyhledávání MediaSearch

Strukturovaná data (popisy a příkazy) jsou nyní také zahrnuta ve výchozím profilu vyhledávání při vyhledávání (pouze) v jmenném prostoru NS_FILE. Vyhledávací výrazy jako "pes" budou zahrnovat i soubory, jejichž popisek (v jazyce uživatele) obsahuje "pes" nebo obsahuje prohlášení P180=Q144 (depicts=pes).

The Extension: WikibaseMediaInfo/MediaSearch subpage provides a more elaborate (technical) writeup of the MediaSearch search profile.

Konfigurace

Proměnné konfigurace rozšíření jsou sady párů klíč-hodnota. They are documented in more detail in WikibaseMediaInfo/extension.json. All config variables are added toLocalSettings.php.

Pro toto rozšíření jsou k dispozici následující možnosti konfigurace:

Config (in LocalSettings.php)

• $wgMediaInfoProperties Default wikibase properties that will always be shown, allowing users to add/edit/delete values for them, on the File page/UploadWizard, regardless or not they already have a value. This is the depicts (P180) property on live Commons, as we want to encourage users to fill in values for this in particular. Value is an array of key-value pairs connecting a label name to an existing wikibase database ID.

   ['depicts' => 'P180']

• $wgMediaInfoHelpUrls URLs for pages where a user can learn more about particular wikibase properties - if there is a help URL for a particular property, then there will be a "learn more" link for that property that leads to the URL from the config.

   ['P180' => 'https://www.wikidata.org/wiki/Property:P180']

Other Config

• $wgUploadWizardConfig['wikibase']['enabled'] Enables MediaInfo data on UploadWizard when set to true.

Vývoj

• Přístupy k vývoji a testování
• Datový model
• Kanonická JSON reprezentace položek MediaInfo

Testy

PHPUnit tests are in tests/phpunit. You can run tests not requiring the MediaWiki framework (located in tests/phpunit/composer) by running composer test. Tento příkaz také spouští kontroly stylu kódu pomocí PHPCS.

Testy závislé na frameworku MediaWiki (umístěném v tests/phpunit/mediawiki) musí být spuštěny pomocí endpointu composer phpunit:entrypoint jádra MediaWiki.

JavaScriptové testy se nacházejí v tests/node-qunit. Testy můžete spustit z terminálu s npm run test:unit. Měla by být použita verze uzlu 6.x.

Související odkazy

• Projekt strukturovaných dat na Wikimedia Commons
• Top rozšíření Wikibase — spravovaný seznam klíčových rozšíření Wikibase