Интервики

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

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

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

Примеры:

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

Wiki ссылается на Википедию, TourBusStop ссылается на статью TourBusStop в вики MeatBall, Wiki ссылается на поиск в Гугле, ru:interwiki ссылается на эту статью.

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

[[this>feed.php]]

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

InterWiki в «Википедии»
InterWiki на «MeatBall»
InterWiki на «c2.com Wiki»

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

Префиксы интервики определяются в файле conf/interwiki.conf. По умолчанию этот файл содержит все префиксы, предложенные на «UseMod». Вы можете добавить свои собственные интервики-ссылки, создав файл conf/interwiki.local.conf и поместив в него свои ссылки (поместив их в файл, отличный от conf/interwiki.conf, вы избежите их переписывания при обновлении).

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

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

rm -rf <path-to-dokuwiki>/data/cache/*

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

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

<shortcut>      <url to wiki>

<shortcut> — короткий префикс, который вы сможете использовать в ссылках. В URL можно использовать подстановки¹⁾ для большей гибкости. Если никаких подстановок не указано, URL-encoded имя вики будет добавлено к URL. Доступны следующие подстановки:

Подстановка	на что заменяется…
{URL}	URL-encoded имя вики
{NAME}	имя вики без какого-либо кодирования (часть, которая добавляется к URL в `interwiki.local.conf`)
{SCHEME}	часть URL «схема»²⁾, если 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, поставляемом в дистрибутиве.

¹⁾

placeholders

²⁾

т. е. http, ftp и т. п.