====== 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 [[wp>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 [[pagename|název stránky]] přidá zkratka oddělená znakem **''>''**.

===== Příklady =====

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

  * Výchozí odkazy: ''<dokuwiki_conf>/interwiki.conf'' — změny se přepíší při aktualizaci wiki.
  * Lokální úpravy: ''<dokuwiki_conf>/interwiki.local.conf'' — zde přidávejte vlastní odkazy, které zůstanou zachovány.

Alternativně můžete použít [[doku>plugin:confmanager|{{https://raw.githubusercontent.com/cosmocode/confmanager/master/admin.svg?16}}]][[doku>plugin:confmanager|Správce konfiguračních souborů]].

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

Formát souboru:

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

Úprava existující zkratky:

<code - conf/interwiki.local.conf>
wp           https://fr.wikipedia.org/wiki/{NAME}
</code>

Deaktivace zkratky:

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

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é [[doku>devel:caching|vymazat cache]].

===== Příklady =====

Zkratka pro nefunkční Coral CDN:

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

Zkratka pro Ubuntu wiki:

<code - conf/interwiki.local.conf>
ubuntu   https://wiki.ubuntu.com/{NAME}
</code>

Použití:

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

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:

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

Např.:

<code - conf/interwiki.local.conf>
enlib     doku.php?id=:en:lib:
</code>

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.

  * Umístění: ''<dokuwiki_root>/lib/images/interwiki''

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

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

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

Pro vypnutí ikon odkazů viz [[doku>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ř.:

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

Použití:

<code>
[[postconf>smtpd_tls_received_header]]
</code>

===== Viz také =====

  * [[doku>tips:interwiki_shortcuts|Další InterWiki zkratky]]
  * [[doku>plugin:confmanager|Správce konfiguračních souborů]]
  * [[config|Konfigurace DokuWiki]]