====== Интервики ======

Это короткие ссылки на другие вики-сайты. Например, вот ссылка на страницу Википедии о вики: [[wp>Wiki]].

Изначальная идея интервики заключалась в том, чтобы создать одну большую вики, распределённую по всему интернету. На сегодняшний день, используя довольно простой синтаксис, вы можете легко сослаться из одной вики на другую.

В «[[dokuwiki|ДокуВики]]» это делается путём добавления к [[pagenames|имени страницы]] короткого префикса, отделённого символом правой угловой скобки: **''>''**.

Примеры:
  [[wp>Wiki]]               ссылается на Википедию,
  [[meatball>TourBusStop]]  ссылается на статью TourBusStop в вики MeatBall,
  [[google>Wiki]]           ссылается на поиск в Гугле,
  [[doku>ru:interwiki]]     ссылается на эту статью.
  
[[wp>Wiki]] ссылается на Википедию, [[meatball>TourBusStop]] ссылается на статью TourBusStop в вики MeatBall, [[google>Wiki]] ссылается на поиск в Гугле, [[doku>ru:interwiki]] ссылается на эту статью. 

Существует один специальный префикс **«''this''».** Он всегда ссылается на директорию веб-сервера, в которой инсталлирована данная «ДокуВики» . Вы можете использовать это для того, чтобы создать относительный URL. Например, вот эта ссылка --- [[this>feed.php]] --- всегда указывает на локальный [[syndication|XML feed]]:

  [[this>feed.php]]

**Дополнительная информацией по интервики:**

  * [[wp>InterWiki]] в «Википедии»
  * [[meatball>InterWiki]] на «MeatBall»
  * [[wiki>InterWiki]] на «c2.com Wiki»

===== Конфигурирование префиксов интервики =====

Префиксы интервики определяются в файле ''conf/interwiki.conf''. По умолчанию этот файл содержит все префиксы, предложенные на «[[http://usemod.com/intermap.txt|UseMod]]». Вы можете добавить свои собственные интервики-ссылки, создав файл ''conf/interwiki.local.conf'' и поместив в него свои ссылки (поместив их в файл, отличный от ''conf/interwiki.conf'', вы избежите их переписывания при [[ru:install:upgrade|обновлении]]).

Никто не мешает вносить правки непосредственно в ''conf/interwiki.conf'', однако это приведет к тому, что ваши изменения будут потеряны при обновлении «ДокуВики».

Вместо стандартной иконки вы можете использовать другие графические файлы, положив их в директорию ''lib/images/interwiki''. Размер картинки должен быть 16x16 пикселей, название файла должно соответствовать короткому префиксу, а формат должен быть PNG или GIF.
Вам понадобиться очистить [[caching|кэш]], если в статьях всё ещё отображается стандартная иконка.

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

Короткие префиксы интервики должны быть в нижнем регистре и соответствовать правилам [[pagename|именования статей]].

Формат файла конфигураций интервики имеет следующий вид:

<code>
<shortcut>      <url to wiki>
</code>

//<shortcut>// — короткий префикс, который вы сможете использовать в ссылках. В URL можно использовать подстановки((placeholders)) для большей гибкости. Если никаких подстановок не указано, [[phpfn>rawurlencode|URL-encoded]] имя вики будет добавлено к URL. Доступны следующие подстановки:

^ Подстановка ^ на что заменяется...  ^
| {URL}       | URL-encoded имя вики |
| {NAME}      | имя вики без какого-либо кодирования (часть, которая добавляется к URL в ''interwiki.local.conf'') |
| {SCHEME}    | часть URL «схема»((т. е. http, ftp и т. п.)), если URL задан как имя вики |
| {HOST}      | часть URL «имя сервера», если URL задан как имя вики |
| {PORT}      | часть URL «номер порта», если URL задан как имя вики |
| {PATH}      | часть URL «путь», если URL задан как имя вики |
| {QUERY}     | часть URL «запрос», если URL задан как имя вики | 

Последние пять параметров полезны при создании интервики-ссылок на кэшируемые системы. Состав URL: %%scheme://ho.st:port/p/a/t/h?qu&er=y%%

В качестве примера смотрите префикс ''coral'' в файле  ''interwiki.conf'', поставляемом в дистрибутиве.

====== Ссылки ======

https://www.dokuwiki.org/start?id=interwiki

https://www.dokuwiki.org/start?id=ru:interwiki


{{tag>dokuwiki}}