Extension:Interwiki

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

Interwiki Stav rozšíření: stabilní
Implementace	Speciální stránka
Popis	Přidá speciální stránku pro zobrazení a manipulaci s tabulkou interwiki
Autoři	Stephanie Amanda Stevens, SPQRobin
Nejnovější verze	4.0
MediaWiki	1.36—1.43
Změny v databázi	Ne
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
Příklad	Special:Interwiki
Parametry $wgInterwikiCentralDB $InterwikiCentralInterlanguageDB $wgInterwikiViewOnly
Přidaná práva interwiki
Přeložte rozšíření Interwiki, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření Interwiki přidává stránku Special:Interwiki do tabulky MediaWiki , aby bylo možné zobrazit a upravit tabulku interwiki a protokol všech akcí s ní provedených.

Toto rozšíření pracuje s proměnnou $wgInterwikiCache . Změny provedené v tabulce interwiki mohou ovlivnit chování transkluze i interwiki odkazů .

Seznam Special:Interwiki je identický se seznamem API api.php?action=query&meta =siteinfo&siprop=interwikimap, až na to, že pole iw_api není k dispozici.

Instalace

Toto rozšíření je součástí MediaWiki 1.21 a vyšší. Zbývající konfigurační pokyny je stále nutné dodržovat.

Byla sloučena do jádra MediaWiki 1.44 . Pro tuto a novější verze MediaWiki není nutná žádná instalace.

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Interwiki 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/Interwiki
  

• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'Interwiki' );
  // Udělit skupině (např. skupině "sysop") oprávnění k úpravě dat interwiki
  $wgGroupPermissions['sysop']['interwiki'] = true;
  

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

• Konfigurace, která je součástí MediaWiki, neuděluje oprávnění žádné skupině uživatelů. Konfiguraci si tedy budete muset přidat sami, jinak nikdo nebude moci interwiki upravovat.
• Chcete-li povolit vyloučení z jiných webů, je nutné povolit $wgEnableScaryTranscluding .
• Chcete-li zakázat přidávání prefixů přes rozhraní Special:Interwiki, nastavte $wgInterwikiViewOnly na true.

Položka tohoto rozšíření v seznamu speciálních stránek neodpovídá názvu rozšíření. Položka v seznamu je definována položkou zprávy interwiki definovanou pro danou lokalitu v SpecialInterwiki.i18n.php. Jeho hodnota je Zobrazit a upravovat interwiki.

Konfigurace

Mezijazykové odkazy

Chcete-li nastavit mezijazyčné odkazy pomocí tohoto rozšíření, ujistěte se, že $wgInterwikiMagic je nastaveno na true a $wgHideInterlanguageLinks je nastaveno na false (ve výchozím nastavení jsou takto nastaveny, obvykle je není třeba měnit). Hodnota $wgInterwikiViewOnly musí být také nastavena na false (což je ve výchozím nastavení). Pak přejděte na Special:Interwiki jako uživatel s možností upravovat interwiki. To je řízeno oprávněním interwiki a ve výchozím nastavení žádná skupina uživatelů toto oprávnění nemá, takže je třeba jej přidat do skupiny uživatelů, např.

$wgGroupPermissions['sysop']['interwiki'] = true;

Jakmile se dostanete na prefix Special:Interwiki, můžete kliknout buď na odkaz Přidat prefix interwiki nebo jazyka v horní části tabulky, nebo na odkazy Editovat či Smazat v řádku tabulky existujícího prefixu interwiki.

Volbou přidání nebo úpravy prefixu interwiki se dostanete na samostatnou stránku s formulářem s různými poli k vyplnění. Hlavní pole jsou name, což je prefix, který by se použil pro odkazy, a URL, kam vložíte celý vzor URL. Například nastavení name=foowiki a URL=http://fr.foowiki.tld/wiki/$1 by způsobilo, že [[foowiki:Blah]] by odkazovalo na http://fr.foowiki.tld/wiki/Blah.

Jsou zde také dvě zaškrtávací políčka označená Přesměrovat a Transkluze. Úplné vysvětlení bitů forward (iw_local) a transclude (iw_trans) naleznete v bodě Příručka:Databázová tabulka interwiki .

Stručně:

• Povolení přeposílání (local=true) se obvykle provádí mezi všemi jazyky a projekty ve stejné skupině, protože umožňuje použití odkazu na kterýkoli z jazyků jako brány k ostatním. Například anglická Wikipedie nastavuje bit local na true pro všechny Wikipedie v jiných jazycích a pro projekty jako commons:, wikinews: nebo wikivoyage:. Uživatel na wiki mimo Wikipedii, kde předpona wikipedia: meziwiki ukazuje na en.wikipedia.org, by mohl vytvořit odkaz podobný wikipedia:fr:Encyclopédie. Tento odkaz zpočátku vede na fr:Encyclopédie na anglické Wikipedii. Server en.wikipedia okamžitě rozpozná odkaz fr: jako interwiki odkaz local, takže odpoví přesměrováním na Wikipedii, kde fr.wikipedia.org/wiki/Encyclopédie zobrazí požadovanou stránku Wikipedie ve francouzském jazyce [[Encyclopédie]] a je to tady.
• Povolení transkluze se provádí jen zřídka, protože to umožňuje článku na jedné wiki používat šablony z jiné wiki. Tomu se říká 'strašidelná transkluze', protože to způsobí problémy, pokud druhá wiki neočekávaně změní šablonu. Několik wiki farem toto používá k vytvoření jedné 'centrální wiki' s různými šablonami, které jsou zpřístupněny ostatním wikinám ve stejné farmě. Pokud to nepotřebujete, tak to nepovolujte.

Globální interwikiny

Od verze 3 Interwiki podporuje definování globální/centrální databáze a stahování definovaných interwikin z ní i z lokální tabulky. Funguje to v podstatě jako sloučení tabulek s definicemi lokálních interwiki, které mají přednost před centrálními. Jazykové odkazy se nečerpají z centrální tabulky. Ty jsou nastaveny pouze jako lokální, protože centrální tabulka pravděpodobně obsluhuje více než jeden projekt (každý z nich má své vlastní jazyky).

Centrální tabulka je interwiki tabulka centrální wiki. To znamená, že co se týče centrální wiki, jedná se v podstatě jen o normální neglobální nastavení. S centrální (globální) tabulkou proto nejsou spojena žádná zvláštní práva, i když je pravděpodobné, že budete chtít být pečlivější v tom, jak přiřadíte práva na úpravy 'interwiki' na této wiki.

• Toto rozhodnutí bylo zjištěno na základě současných možných případů použití (hub ShoutWiki, centrální wiki Uncyclomedia a Meta-Wiki), kde centrální wiki stejně nebude mít nic navíc.
• To se může v budoucnu změnit, ale cokoli inteligentnějšího bude vyžadovat aktualizace schématu.
• Toto pravděpodobně nefunguje s prefixy tabulek kvůli způsobu přístupu k tabulce.

Chcete-li nastavit centrální tabulku interwiki, jednoduše zadejte název databáze wiki, kterou chcete použít:

// Povolit stahování globálních interwiki z centrální databáze
$wgInterwikiCentralDB = 'mw_central';

Nahraďte 'mw_central' názvem databáze.

Pro ty, kteří používají prefixy tabulek, je zde alternativní řešení pro tabulky "pool_example_wiki".

$wgSharedDB = 'example_wiki'; # $wgDBname pro databázi wiki obsahující hlavní interwiki tabulku
$wgSharedPrefix = 'pool_'; # $wgDBprefix pro databázi. Pokud není zadán, výchozí hodnota je prefix aktuální wiki.
$wgSharedTables = ['interwiki'];

URL adresy relativní k protokolu

Můžete použít protocol-relative URL (PRURL), aby uživatelé přistupující k vaší wiki přes HTTP nebo HTTPS mohli použít stejný protokol pro přístup k odkazům interwiki. Chcete-li použít PURL, nejprve se ujistěte, že cílový server podporuje HTTPS. Pokud ano, jednoduše odstraňte část URL s hodnotou https: v tabulce odkazů. Například změna

https://en.wikipedia.org/wiki/$1

na:

//en.wikipedia.org/wiki/$1