DokuWiki

It's better when it's simple

Инструменты пользователя

Инструменты сайта


ru:interwiki

Интервики

Это короткие ссылки на другие вики-сайты. Например, вот ссылка на страницу Википедии о вики: 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 можно использовать подстановки1) для большей гибкости. Если никаких подстановок не указано, URL-encoded имя вики будет добавлено к URL. Доступны следующие подстановки:

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

1)
placeholders
2)
т. е. http, ftp и т. п.
ru/interwiki.txt · Последнее изменение: 2016-06-05 21:07 — 109.110.43.14

Если не указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki