numberlinks.conf

Начало

• Блог
• Интеграция разметки
• Модуль вики
• Начало
• Файлы конфигурации
  • Escape-последовательности
  • element_tokens.conf
  • entities.conf
  • extra.php
  • interwiki.conf
  • nowrap.conf
  • numberlinks.conf
  • strings.conf
  • style_aliases.conf
  • terms.conf
  • Файлы конфигурации
  • Формат файлов %%conf%%
  • кeplace.conf
  • ыmilies.conf
• Форматтеры

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

См. также файл настройки цифрови́ки — interwiki.conf. Jnkbxbt цифрови́ки от интервики в том, что они ссылаются по числу (например, номер сообщения на форуме или ID пользователя), а не просто по строковому запросу. ¶

1. Имя цифрови́ки в нижнем регистре, можно использовать любые символы Юникода;
2. Полный адрес. Если он не содержит {PATH}, то число будет автоматически добавлено в конец адреса. Указывается относительно форматируемой страницы, поэтому если интервики, не ссылающаяся на внешний ресурс, используется в нескольких разных папках вам, возможно, нужно указать абсолютный путь (начинающийся с "/"). Может содержать 2 строки замены (регистро-зависимы):

   {PATH}

   собственно само число после :# либо : в ссылке;

3. Корневой адрес (необязательный) — используется при задании ссылок без строки запроса, например: ((форум:#)) или ((форум:)) — в этом случае адрес будет звят не из второй колонки, а из этой.
   • если не определён, устанавливается как Полный адрес без части после последнего слэша, например: http://uverse.i-forge.net/wiki/search корневой адрес будет определён как http://uverse.i-forge.net/wiki/

Обратите внимание, что как разделитель для цифровики можно использовать и :, и :# — используйте тот, что кажется более понятным (второй вид, например, намекает читателю на некий «порядковый номер»). ¶

Например, для вики-ссылки ((CodeNet:#7307)) или ((CodeNet:7307)) (одно и то же): ¶

имя цифрови́ки

«codenet»;

{PATH}

«7307».

Можно использовать одинаковые именя и для интервикии, и для цифрови́ки — тогда для цифровых запросов ([[w:123]]) будет использоваться запись в numberlinks.conf, а для нецифровых ([[w:абв]]) — в interwiki.conf.
См. пример ниже. ¶

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

Пример файла¶

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

codenet             http://forum.codenet.ru/showthread.php?t=
user                /profile.php?{PATH}

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

1. CodeNet — ((Codenet:#1253)) → URL http://forum.codenet.ru/showthread.php?t=1253
3. некую локальную страницу на сайте — ((user:#4444)) → URL /.../profile.php?4444

Использование одинакового имени¶

Допустим, что сайт имеет одновременно и вики-раздел с документацией, и форум. Тогда следующие 2 записи (по одной в файле) сделают возможным ссылку по одному интервики-имени: ¶

# В interwiki.conf:
oursite             /wiki/{PATH}
# В numberlinks.conf:
outsite             /forum/viewtopic.php?id=

Тогда эти два адреса будут развёрнуты каждый по-своему: ¶

((OurSite:48912))

/forum/viewtopic.php?id=48912

((OurSite:Авторы))

/wiki/Авторы

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

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

Например: ¶

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

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

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