UverseWiki

interwiki.conf

Этот файл задаёт список интервики-сокращений для ссылок. Он имеет стандартный формат в 2 колонки, разделённых пробелами. Файл должен быть сохранён в UTF-8.

См. также файл настройки цифрови́ки — numberlinks.conf.

  1. Имя интервики в нижнем регистре, можно использовать любые символы Юникода;
  2. Полный адрес. Если он не содержит ни {RUL}, ни {PATH}, то в конец будет автоматически добавлен {URL}. Указывается относительно форматируемой страницы, поэтому если интервики, не ссылающаяся на внешний ресурс, используется в нескольких разных папках вам, возможно, нужно указать абсолютный путь (начинающийся с "/"). Может содержать 3 строки замены (регистрозависимы):
    {PATH}
    будет без преобразования заменено на то, что идёт после двоеточия;
    {URL}
    обозначает URL-кодированую строку (типа %2B);
  3. Корневой адрес (необязательный) — используется при задании ссылок без строки запроса, например: ((гугл:)) — в этом случае адрес будет звят не из второй колонки, а из этой.
    • если не определён, устанавливается как Полный адрес без части после последнего слэша, например: http://uverse.i-forge.net/wiki/search корневой адрес будет определён как http://uverse.i-forge.net/wiki/

Например, для вики-ссылки ((ВП:Земля (планета) == Вики)):

имя интервики
«вп»;
{PATH}
«Земля (планета)»;
{URL}
%D0%97%D0%B5%D0%BC%D0%BB%D1%8F%20(%D0%BF%D0%BB%D0%B0%D0%BD%D0%B5%D1%82%D0%B0).

По умолчанию ни одного интервики-сокращения не определено. Этот файл в дистрибутиве.

Формат файла почти полностью совпадает с форматом conf/interwiki.conf движка DokuWiki, поэтому вы можете использовать определённый там список интервики оттуда, если замените {NAME} на {PATH}.
Его также можно взять из папки Extras/Sample configs или из configs/ SVN.

Пример файла

; Комментарий.

wikipedia           http://en.wikipedia.org/w/index.php?title=Special:Search&search={PATH}
гугл                http://www.google.ru/search?q=
класс               /Classes/{PATH}

Это сделает доступным:

  1. Википедию — ((wikipedia:Earth)) → URL http://en.wikipedia.org/w/index.php?title=Special:Search&search=Earth
  2. Google — ((Гугл:tsukuru)) → URL http://www.google.ru/search?q=tsukuru
  3. Некий локальный раздел на сайте — ((класс:UWikiDocument)) → URL /.../Classes/UWikiDocument

Escape-последовательности

Во всех компонентах интервики и цифровики (имя, полный и корневой адреса) можно использовать escape-последовательности и таким образом, например, добавлять пробелы к именам, а к адресами без их URL-кодирования.

Например:

некая\x20группа     /группа\x20документов/{PATH}

Тогда ссылка вида ((некая группа: страница==)) будет отображена как ссылка на локальный документ по адресу /группа документов/страница с заголовком «страница».

Рекомендуется не использовать URL-кодирование в ссылках на локальные документы — это не даёт возможности проверить существование адресованных страниц. Например, если бы выше путь интервики был указан как /группа%20документов/{PATH}, то путь ссылки бы выглядел как /группа%20документов/страница — и если нет папки с названием группа%20документов, то документ будет считаться несуществующим.