Rozšíření:Disambiguator

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

Disambiguator Stav rozšíření: stabilní
Implementace	Speciální stránka
Popis	Umožňuje označení stránek rozcestníku magickým slovem
Autoři	Ryan Kaldari (Kaldaridiskuse)
Nejnovější verze	Průběžně aktualizováno
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki	1.28+
PHP	5.4+
Licence	Licence MIT
Stáhnout	Stáhněte si rozšíření Git [?]: stáhněte si Git master procházení úložiště (GitHub) zobrazení historie přispěvatelé repozitáře (GitHub) kontrola kódu
Parametry $wgDisambiguatorIndicateLinks
Použité háčky (hooks) AncientPagesQuery ChangeTagsListActive EditPage::showEditForm:initial GetDoubleUnderscoreIDs GetLinkColours LinksUpdateComplete ListDefinedTags LonelyPagesQuery RandomPageQuery RecentChange_save ShortPagesQuery wgQueryPages
Čtvrtletní stahování	51 (Ranked 82nd)
Veřejné wiki používající rozšíření	6,730 (Ranked 31st)
Přeložte rozšíření Disambiguator, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření Disambiguator je navrženo tak, aby programově usnadnilo práci s disambiguačními (odstranění dvojsmyslů) stránkami. Umožňuje vám označit všechny jednoznačné stránky __DISAMBIG__ kouzelným slovem (nebo ekvivalentním aliasem), které je pak jako takové označí v databázi. To umožňuje ostatním rozšířením volitelně zpracovávat stránky s jednoznačností jako samostatnou třídu stránek, i když jsou stále považovány za "normální" stránky.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Disambiguator 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/Disambiguator
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'Disambiguator' );
  

• Nakonfigurujte podle potřeby.
•  Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Konfigurace

Následující konfigurační proměnné lze nastavit z vašeho souboru LocalSettings.php.

• $wgDisambiguatorIndicateLinks - zda přidat třídu CSS 'mw-disambig' k odkazům na stránky disambiguace (výchozí hodnota je true)
• $wgDisambiguatorNotifications - zda varovat uživatele, když zadá odkaz na jednoznačnou stránku v editorech wikitextu (výchozí hodnota je false)

Funkce

Disambiguator poskytuje následující funkce:

• Programatická identifikace jednoznačných stránek prostřednictvím __DISAMBIG__ magického slova
• Nové speciální stránky pro výpis všech stránek s jednoznačností a stránek odkazujících na stránky s odlišností
• Nové funkce API ekvivalentní výše uvedeným speciálním stránkám a také funkce API pro dotazování, zda stránka je či není jednoznačnou stránkou
• Upravuje Special:LonelyPages tak, aby ignoroval jednoznačné stránky
• Upravuje Special:Random tak, aby ignoroval jednoznačné stránky (vyžaduje MediaWiki 1.26.0)
• Pokud je povoleno VisualEditor , umožňuje označit stránku jako jednoznačnou stránku prostřednictvím rozhraní vlastností stránky
• Pokud je povoleno VisualEditor , v inspektoru odkazů se zobrazí, zda je stránka jednoznačnou stránkou či nikoli
• Pokud je povoleno VisualEditor , zobrazí se v dialogovém okně odkazu, zda je stránka jednoznačnou stránkou či nikoli
• Pokud je nakonfigurováno, přidá třídu CSS 'mw-disambig' k odkazům na jednoznačné stránky (viz #Konfigurace výše)
• Varuje uživatele WikiEditor při odkazu na jednoznačnou stránku a umožňuje mu odkaz opravit.

Použití

Pro end-user help se podívejte na stránku: Help:Extension:Disambiguator.

Na wiki

Jakmile je Disambiguator nainstalován, nejlepším způsobem, jak jej použít, je přidat magické slovo __DISAMBIG__ do šablony, která je pak zahrnuta na všech vašich disambiguačních stránkách.

Jakmile je kouzelné slůvko na svém místě, budou mít všechny vaše stránky disambiguace v databázi přiřazenou vlastnost stránky 'disambiguation'. Tato vlastnost se nachází v tabulce page_props .

Budete mít také dva nové Speciální stránky :

• Special:DisambiguationPages - který uvádí všechny stránky s jednoznačností na vaší wiki.
• Special:DisambiguationPageLinks - který uvádí všechny stránky na vaší wiki, které odkazují na jednoznačné stránky. (Toto je náhrada za starou stránku Special:Disambiguations, která je zastaralá.)

S API

Chcete-li vypsat všechny stránky s jednoznačností:

api.php?action=query&list=querypage&qppage=DisambiguationPages

Chcete-li vypsat všechny odkazy na jednoznačné stránky:

api.php?action=query&list=querypage&qppage=DisambiguationPageLinks

Všimněte si, že na wikinách běžících v MiserMode (všechny wikiny WMF) jsou speciální stránky i rozhraní API pro DisambiguationPageLinks omezeny na určitý počet výsledků (obvykle 1000–5000).

Chcete-li zjistit, zda je jednotlivá stránka jednoznačnou stránkou:

api.php?action=query&titles=Bug&prop=pageprops&ppprop=disambiguation

Pokud se jedná o jednoznačnou stránku, zahrne 'disambiguation' do svých stránek. Všimněte si, že disambiguation pageprop, pokud je přítomen, bude mít svou hodnotu nastavenou na prázdný řetězec, takže buďte opatrní při testování jako boolean.

SQL

Chcete-li zjistit, zda je jednotlivá stránka jednoznačnou stránkou, zkontrolujte v tabulce page_props přítomnost pp_propname = 'disambiguation'. Stránky, které nejsou jednoznačnými stránkami, nebudou mít tento pp_propname. pp_value není důležité.

SELECT page_title, pp_propname
FROM page
LEFT JOIN page_props ON pp_page = page_id AND pp_propname = 'disambiguation'
WHERE page_namespace = 0
AND page_title IN ('John', 'COVID-19') -- John is a disambiguation page on enwiki, COVID-19 is not

Možné plány do budoucna

• Přidejte možnost skrýt stránky s nejednoznačností před: Special:AllPages (task #9936), Special:PrefixIndex (task #11319), Special:WhatLinksHere (task #9935), Special:AncientPages (task #76287)
• Zvažte rozšíření odkazového dialogu v editoru wikitextu o schopnost detekovat disambigs ve výsledcích vyhledávání a vytáhnout seznam odkazů
• Kompletní seznam chyb pro toto rozšíření