Это старая версия документа!
Интервики
Это короткие ссылки на другие вики-сайты. Например, вот ссылка на страницу Википедии о Wiki: Wiki.
Изначальная идея Интервики заключалась в том, чтобы создать один большой Wiki распределенный по всей сети. На сегодняшний день, используя довольно простой синтаксис, вы можете легко сослаться из одного wiki на другой. research paper
В DokuWiki это делается путём добавления к ссылке pagenames короткого префикса отделенного символом >
.
Примеры:
[[wp>Wiki]] ссылается на Википедию, [[Meatball>TourBusStop]] ссылается на статью TourBusStop в вики MeatBall, [[google>Wiki]] ссылается на поиск в Google, [[doku>ru:interwiki]] ссылается на эту статью.
Wiki ссылается на Википедию, TourBusStop ссылается на статью TourBusStop в вики MeatBall, Wiki ссылается на поиск в Google, ru:interwiki ссылается на эту статью.
Существует один специальный префикс this
. Он всегда ссылается на директорию веб-сервера, в которой инсталлирован данный DokuWiki . Вы можете использовать это для того, чтобы создать относительный URL. Например, вот эта ссылка feed.php всегда указывает на локальный XML feed
[[this>feed.php]]
Дополнительная информацией по Интервики:
- InterWiki на Википедии
- InterWiki на MeatBall
- InterWiki на c2.com Wiki
Конфигурирование префиксов Интервики
Префиксы Интервики определяются в файле conf/interwiki.conf
. По умолчанию этот файл содержит все префиксы предложенные на http://usemod.com/intermap.txt. Вы можете добавить свои собственные interwiki-ссылки, создав файл conf/interwiki.local.conf
и поместив в него свои ссылки (поместив их в файл, отличный от conf/interwiki.conf
, вы избежите их переписывания при апгрейде).
Никто не мешает вносить правки непосредственно в conf/interwiki.conf
, однако это приведет к тому, что ваши изменения будут потеряны при апгрейде DokuWiki.
Вместо стандартной иконки, вы можете использовать другие графические файлы, положив их в директорию lib/images/interwiki
. Размер картинки должен быть 16×16 пикселей, название файла должно соответствовать короткому префиксу, а формат должен быть PNG или GIF.
Вам понадобиться очистить кэш, если в статьях всё ещё отображается стандартная иконка.
rm -rf <path-to-dokuwiki>/data/cache/*
Короткие префиксы Интервики должны быть в нижнем регистре и соответствовать правилам именования статей
Формат файла конфигураций Интервики имеет следующий вид:
<shortcut> <url to wiki>
<shortcut> — короткий префикс, который вы сможете использовать в ссылках. В URL можно использовать подстановки 1) для большей гибкости. Если никаких подстановок не указано, URL-encoded имя wiki будет добавлено к URL. Доступны следующие подстановки:
Постановка | На что заменяется |
---|---|
{URL} | URL-encoded имя wiki |
{NAME} | имя wiki без какой-либо encoding (часть, которая добавляется к url в interwiki.local.conf) |
{SCHEME} | часть URL «схема» 2), если URL задан как имя wiki |
{HOST} | часть URL «имя сервера», если URL задан как имя wiki |
{PORT} | часть URL «номер порта» , если URL задан как имя wiki |
{PATH} | часть URL «путь», если URL задан как имя wiki |
{QUERY} | часть URL «query», если URL задан как имя wiki |
Последние 5 параметров полезны при создании интервики-ссылок на кэшируемые системы. В качестве примера смотри префикс coral
в файле interwiki.conf
, поставляемом в дистрибутиве.