Rozšíření:Disambiguator

From mediawiki.org
This page is a translated version of the page Extension:Disambiguator and the translation is 100% complete.
Základní informace k tomuto rozšíření MediaWiki
Disambiguator
Stav rozšíření: stabilní
Zavádění Speciální stránka
Popis Umožňuje označení stránek rozcestníku magickým slovem
Napsal(i) Ryan Kaldari (Kaldaridiskuse)
Nejnovější verze Průběžně aktualizováno
Zásady kompatibility Vydání snímků následuje MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki 1.28+
PHP 5.4+
Licence Licence MIT
Zdrojový kód

  • $wgDisambiguatorIndicateLinks
Čtvrtletní stahování 82 (Ranked 70th)
Používání veřejných wikin 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.
  • Yes 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 Rozšíření: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