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

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


wiki:interwiki

Ссылки InterWiki

Первоначальная идея InterWiki заключалась в том, чтобы иметь одну большую распределенную Wiki по всему Интернету. Сегодня это более простой способ ссылаться из одной wiki в другую, используя для этого некоторый простой синтаксис ссылок.

В DokuWiki это делается путем добавления к pagenames сокращенного варианта, разделенного символом >.

Примеры (некоторые иконки не отображаются,т.к. в данной версии докувики отключены):

Shortcut Example Description
[[amazon>Wikis]] Вики Ссылка на партнерскую программу Amazon. (также доступны домены .de и .uk)
[[callto>0123456789]] 0123456789 Нажмите на ссылку, чтобы открыть приложение для телефона.
[[doku>interwiki]] interwiki ссылки на вики DokuWiki
[[go>pie]] пирог Пусть повезет с первым попаданием в Google
[[google>Wiki]] Wiki ссылки на поиск Google
[[paypal>id_here]] id_here ссылки на PayPal
[[phpfn>random]] random ссылки на функцию в руководстве по PHP
[[rfc>9311]] 9311 ссылки на https://www.rfc-editor.org/rfc/rfc9311
[[skype>echo123]] echo123 Ссылки, которые открывают Skype, готовые к звонку Тестовый звонок Skype (echo123)
[[tel>123-456-7890]] 123-456-7890 Откройте приложение телефона, чтобы позвонить. Более общее, чем callto.
[[this>feed.php]] feed.php Ссылки на URL вашей вики. Пример ссылок на локальны XML feed. [[this>]] — это особый случай и единственная интервики-ссылка, которую нельзя настроить через какой-либо файл конфигурации.
[[user>username]] username Ссылки по умолчанию на :user:username, на dokuwiki.org изменены на профили пользователей форума.
[[man>cp]] cp ссылки на http://man.cx/
[[wp>InterWiki]] InterWiki ссылки на англоязычную Википедию
[[wpfr>InterWiki]] InterWiki ссылки на французскую Википедию. Также доступны: wpde, wpes, wpjp, wppl, wpru, wpmeta.

Вот пример того, как получить доступ к произвольному файлу в каталоге данных/медиа DokuWiki, нажав на изображение. Это полезно для видео и файлов PDF.

[[this>lib/exe/test_video.mp4?400x&:wiki:dokuwiki-128.png|{{image.png?300}}]]

Также доступна замена внешних изображений на Interwiki.

{{ phpfn>images/php.gif?96}}

Настройка сочетаний клавиш InterWiki

Сочетания клавиш InterWiki определены в двух файлах:

  • Включенные по умолчанию ссылки находятся в<dokuwiki_conf>/interwiki.conf файле. (подробнее можно узнать в https://usemod.org/intermap.txt). . Изменения этого файла перезаписываются при обновлении вики.
  • Локальные изменения в <dokuwiki_conf>/interwiki.local.conf файле.

Это файл для добавления собственных интервики-ссылок. Это предотвратит перезапись ссылок при обновлении.

Кроме того, вместо *.conf непосредственного редактирования файлов вы можете установить и использовать Configuration File Manager|названия страницы.

Сокращение interwiki должно быть написано строчными буквами и соответствовать правилам pagename.

Формат файла конфигурации интервики следующий:

conf/interwiki.local.conf
<shortcut>   <url to wiki>

Измените существующие интервики-ссылки, повторно используя сочетание клавиш:

conf/interwiki.local.conf
wp           https://fr.wikipedia.org/wiki/{NAME}

Или отключить, не упоминая ссылку

conf/interwiki.local.conf
wpmeta
paypal   # or use a comment to explain why it is disabled

Ярлык — это тот, который вы сможете использовать в ссылке позже. В URL вы можете использовать некоторые заполнители, чтобы быть более гибкими в ссылках. Если заполнитель не указан, то URL-encoded wikiname будет добавлено к URL . Доступны следующие заполнители:

Заполнитель Заменено на
{URL} URL -кодированное вики-имя (часть, которая добавляется к URL в interwiki.local.conf)
{NAME} Это заменяется на wikiname, как указано в документе. Выполняется только обязательное кодирование, urlencoding, если ссылка является внешним URL , или кодирование как wikiname, если это внутренняя ссылка (начинается с двоеточия)
{SCHEME} часть схемы, если URL был указан как wikiname
{HOST} часть хоста, если URL был указан как wikiname
{PORT} часть порта, если URL был указан как wikiname
{PATH} часть пути, если URL был указан как wikiname
{QUERY} часть запроса, если URL был указан как wikiname

Последние 5 параметров полезны при создании интервики-ссылок на кэш-системы.

Чтобы изменения конфигурации вступили в силу на страницах, необходимо очистить кэш .

Примеры

Например, кэшированные ссылки со старой, более не работающей Coral Content Distribution Network можно использовать с помощью coral ярлыка, определенного с помощью пары заполнителей:

conf/interwiki.local.conf
coral http://{HOST}.{PORT}.nyud.net:8090{PATH}?{QUERY}

Например, вики Ubuntu использует пространства имен и имена страниц, подобные этим LaptopTestingTeam/ToshibaPortegeM700, и без использования {NAME} в качестве заполнителя в файле interwiki.local.conf вы получите ошибку «Не найдено» на их вики, поскольку она будет интерпретировать косую черту как %2F; поэтому вы можете добавить эту строку в свой interwiki.local.conf:

conf/interwiki.local.conf
ubuntu   https://wiki.ubuntu.com/{NAME}

и теперь создайте ссылку на него следующим образом:

[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu on Toshiba Portege M700 Tablet]]

Если имя вики уже будет включать закодированные символы (например, %26 для &), используйте {PATH} в определении interwiki.local.conf.

Интер(н)вики-ссылки

Чтобы сослаться на определенные пространства имен в вашей собственной вики:23)

conf/interwiki.local.conf
<shortcut>      <dokuwiki_root>:ns:..:

Например:

conf/interwiki.local.conf
enlib     doku.php?id=:en:lib:

would address pages in the namespace :en:lib:pagename if using the link syntax [[enlib>pagename]].

Настройка значков сочетаний клавиш InterWiki

Значки Interwiki должны иметь размер 16×16 пикселей, быть в формате PNG или GIF и называться по названию сочетания клавиш.

  • <dokuwiki_root>/lib/images/interwiki
    Каталог для размещения файлов изображений.

Вам также следует очистить кэшированные изображения PNG и GIF, а также файлы CSS , если у вас установлено изображение по умолчанию вместо загруженного вами.

rm -rf <dokuwiki_data>/data/cache/*/*.{gif,png,css}

На самом деле может быть достаточно сделать кэширование CSS недействительным , повторно сохранив его в менеджере конфигураций («повторное сохранение» означает нажатие кнопки сохранения в менеджере конфигураций без внесения каких-либо изменений в параметры конфигурации).

Если вы хотите отключить все или некоторые значки ссылок, см. раздел Отключение значков ссылок.

Использование знака номера/решетки (#), а не в качестве комментария

Поскольку решетка ( ) зарезервирована для обозначения строки комментария, ее # необходимо экранировать обратной косой чертой (\#).

Например, если вы используете имя вашей интервики в фрагментной части вашего URL-адреса , вам необходимо экранировать его.

Пример:

  • Конфигурация
conf/interwiki.local.conf
postconf  http://www.postfix.org/postconf.5.html\#{NAME}
  • Использование
[[postconf>smtpd_tls_received_header]]

Смотрите также

23)
Примечание: ссылка всегда будет отображаться так, как будто страница уже существует. Никакого 'preprove'.
Только авторизованные участники могут оставлять комментарии.
wiki/interwiki.txt · Последнее изменение: 2025/02/02 11:42 — vladpolskiy