====== Интервики ======
Это короткие ссылки на другие вики-сайты. Например, вот ссылка на страницу Википедии о вики: [[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|кэш]], если в статьях всё ещё отображается стандартная иконка.
rm -rf /data/cache/*
Короткие префиксы интервики должны быть в нижнем регистре и соответствовать правилам [[pagename|именования статей]].
Формат файла конфигураций интервики имеет следующий вид:
//// — короткий префикс, который вы сможете использовать в ссылках. В 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'', поставляемом в дистрибутиве.