⋮ Obsah

InterWiki odkazy

https://www.dokuwiki.org/interwiki

FIXME Hodně ořezaný překlad - zkontrolovat!

Původní myšlenka InterWiki byla vytvořit jednu velkou distribuovanou Wiki napříč celým Internetem. Dnes se používá spíše jako jednoduchý způsob, jak odkazovat z jedné wiki na druhou pomocí zkrácené syntaxe odkazu.

V DokuWiki se to provádí tak, že se před název stránky přidá zkratka oddělená znakem >.

Příklady

Zkratka Příklad Popis
[[amazon>Wikis]] Wikis Partnerský odkaz na Amazon (.de a .uk jsou také dostupné)
[[callto>0123456789]] 0123456789 Odkaz pro otevření telefonní aplikace
[[doku>interwiki]] interwiki Odkaz na wiki DokuWiki
[[go>pie]] pie „I'm feeling lucky“ odkaz na Google
[[google>Wiki]] Wiki Odkaz na vyhledávání Google
[[paypal>id_here]] id_here Odkaz na PayPal
[[phpfn>random]] random Odkaz na funkci v PHP manuálu
[[rfc>9311]] 9311 Odkaz na https://www.rfc-editor.org/rfc/rfc9311
[[skype>echo123]] echo123 Otevře Skype pro volání testovacího kontaktu
[[tel>123-456-7890]] 123-456-7890 Otevře telefonní aplikaci (obecnější než callto)
[[this>feed.php]] feed.php Odkaz na URL vaší wiki (např. XML feed) – this> je speciální případ a nelze ho konfigurovat
[[user>username]] username Výchozí odkaz na :user:username; na dokuwiki.org směřuje na profil ve fóru
[[man>cp]] cp Odkaz na http://man.cx/
[[wp>InterWiki]] InterWiki Odkaz na anglickou Wikipedii
[[wpfr>InterWiki]] InterWiki Odkaz na francouzskou Wikipedii. Dostupné také: wpde, wpes, wpjp, wppl, wpru, wpmeta

Příklad odkazu na soubor

Přístup k libovolnému souboru v data/media pomocí obrázku: 

[[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]

Interwiki substituce pro externí obrázky je také možná: 

{{ phpfn>images/php.gif?96 }}

Nastavení InterWiki zkratek

InterWiki zkratky jsou definovány ve dvou souborech:

Alternativně můžete použít Správce konfiguračních souborů.

Zkratky musí být malými písmeny a odpovídat pravidlům pro názvy stránek.

Formát souboru:

conf/interwiki.local.conf
<zkratka>   <url na wiki>

Úprava existující zkratky:

conf/interwiki.local.conf
wp           https://fr.wikipedia.org/wiki/{NAME}

Deaktivace zkratky:

conf/interwiki.local.conf
wpmeta
paypal   # poznámka, proč je zkratka vypnuta

Dostupné zástupné znaky:

Zástupný znak Nahrazen za
{URL} URL-enkódovaný název stránky
{NAME} Původní název stránky (enkódovaný dle potřeby)
{SCHEME} Protokol (např. https)
{HOST} Doména
{PORT} Port
{PATH} Cesta
{QUERY} Parametry URL

Pro aplikaci změn je nutné vymazat cache.

Příklady

Zkratka pro nefunkční Coral CDN:

conf/interwiki.local.conf
coral http://{HOST}.{PORT}.nyud.net:8090{PATH}?{QUERY}

Zkratka pro Ubuntu wiki:

conf/interwiki.local.conf
ubuntu   https://wiki.ubuntu.com/{NAME}

Použití: 

[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu na Toshiba Portege M700]]

Pokud název stránky obsahuje již enkódované znaky (např. %26), použijte {PATH}.

Interní wiki odkazy

Odkazování na konkrétní jmenné prostory ve vlastní wiki:

conf/interwiki.local.conf
<zkratka>      <dokuwiki_root>:ns:..:

Např.:

conf/interwiki.local.conf
enlib     doku.php?id=:en:lib:

Použití: would address pages in the namespace :en:lib:pagename if using the link syntax [[enlib>pagename]].

Ikony pro InterWiki odkazy

Ikony by měly mít velikost 16×16 px, být ve formátu PNG nebo GIF a pojmenovány podle zkratky.

Vymažte cache PNG/GIF obrázků a CSS souborů, pokud se zobrazuje výchozí ikona. 

rm -rf <dokuwiki_data>/data/cache/*/*.{gif,png,css}

Někdy stačí jen znovu uložit konfiguraci bez změn.

Pro vypnutí ikon odkazů viz tips:disabling link icons.

Použití znaku # (hash) jinak než jako komentář

Protože # označuje komentář, je nutné ho escapovat pomocí zpětného lomítka \#.

Např.:

conf/interwiki.local.conf
postconf  http://www.postfix.org/postconf.5.html\#{NAME}

Použití: 

[[postconf>smtpd_tls_received_header]]

Viz také