======Ссылки InterWiki======= Первоначальная идея InterWiki заключалась в том, чтобы иметь одну большую распределенную [[wp>Wiki]] по всему Интернету. Сегодня это более простой способ ссылаться из одной wiki в другую, используя для этого некоторый простой синтаксис ссылок. В [[wiki:DokuWiki]] это делается путем добавления к [[wiki:pagenames]] сокращенного варианта, разделенного символом **''>''**. Примеры (некоторые иконки не отображаются,т.к. в данной версии докувики отключены): ^ Shortcut ^ Example ^ Description ^ | ''%%[[amazon>Wikis]]%%'' | [[amazon>Вики]] | Ссылка на партнерскую программу Amazon. (также доступны домены .de и .uk) | | ''%%[[callto>0123456789]]%%'' | [[callto>0123456789]] | Нажмите на ссылку, чтобы открыть приложение для телефона. | | ''%%[[doku>interwiki]]%%'' | [[doku>interwiki]] | ссылки на вики DokuWiki | | ''%%[[go>pie]]%%'' | [[go>пирог]] | Пусть повезет с первым попаданием в Google | | ''%%[[google>Wiki]]%%'' | [[google>Wiki]] | ссылки на поиск Google | | ''%%[[paypal>id_here]]%%'' | [[paypal>id_here]] | ссылки на PayPal | | ''%%[[phpfn>random]]%%'' | [[phpfn>random]] | ссылки на функцию в руководстве по PHP | | ''%%[[rfc>9311]]%%'' | [[rfc>9311]] | ссылки на https://www.rfc-editor.org/rfc/rfc9311 | | ''%%[[skype>echo123]]%%'' | [[skype>echo123]] | Ссылки, которые открывают Skype, готовые к звонку Тестовый звонок Skype (echo123) | | ''%%[[tel>123-456-7890]]%%'' | [[tel>123-456-7890]] | Откройте приложение телефона, чтобы позвонить. Более общее, чем callto. | | ''%%[[this>feed.php]]%%'' | [[this>feed.php]] | Ссылки на URL вашей вики. Пример ссылок на локальны [[wiki:syndication|XML feed]]. ''%%[[this>]]%%'' — это особый случай и единственная интервики-ссылка, которую **нельзя настроить** через какой-либо файл конфигурации. | | ''%%[[user>username]]%%'' | [[user>username]] | Ссылки по умолчанию на ''%%:user:username%%'', на dokuwiki.org изменены на профили пользователей форума. | | ''%%[[man>cp]]%%'' | [[man>cp]] | ссылки на http://man.cx/ | | ''%%[[wp>InterWiki]]%%'' | [[wp>InterWiki]] | ссылки на англоязычную Википедию | | ''%%[[wpfr>InterWiki]]%%'' | [[wpfr>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}} {{ phpfn>images/php.gif?96}} ===== Настройка сочетаний клавиш InterWiki ===== Сочетания клавиш InterWiki определены в двух файлах: * Включенные по умолчанию ссылки находятся в''[[https://github.com/dokuwiki/dokuwiki/blob/master/conf/interwiki.conf|/interwiki.conf]]'' файле. (подробнее можно узнать в [[https://usemod.org/intermap.txt]]). . Изменения этого файла перезаписываются при обновлении вики. * Локальные изменения в ''/interwiki.local.conf'' файле. Это файл для добавления собственных интервики-ссылок. Это предотвратит перезапись ссылок при обновлении. Кроме того, вместо ''*.conf'' непосредственного редактирования файлов вы можете установить и использовать [[wiki:plugin:confmanager|{{https://raw.githubusercontent.com/cosmocode/confmanager/master/admin.svg?16}}]][[wiki:plugin:confmanager|Configuration File Manager|названия страницы]]. Сокращение interwiki должно быть написано строчными буквами и соответствовать правилам [[wiki:pagename]]. Формат файла конфигурации интервики следующий: Измените существующие интервики-ссылки, повторно используя сочетание клавиш: wp https://fr.wikipedia.org/wiki/{NAME} Или отключить, не упоминая ссылку wpmeta paypal # or use a comment to explain why it is disabled Ярлык — это тот, который вы сможете использовать в ссылке позже. В URL вы можете использовать некоторые заполнители, чтобы быть более гибкими в ссылках. Если заполнитель не указан, то [[phpfn>rawurlencode|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 параметров полезны при создании интервики-ссылок на кэш-системы. Чтобы изменения конфигурации вступили в силу на страницах, [[wiki:devel:caching|необходимо очистить кэш ]]. ==== Примеры ==== Например, кэшированные ссылки со старой, более не работающей [[wp>Coral Content Distribution Network]] можно использовать с помощью ''coral'' ярлыка, определенного с помощью пары заполнителей: coral http://{HOST}.{PORT}.nyud.net:8090{PATH}?{QUERY} Например, [[https://wiki.ubuntu.com/|вики Ubuntu]] использует пространства имен и имена страниц, подобные этим ''LaptopTestingTeam/ToshibaPortegeM700'', и без использования ''{NAME}'' в качестве заполнителя в файле interwiki.local.conf вы получите ошибку «Не найдено» на их вики, поскольку она будет интерпретировать косую черту как ''%2F''; поэтому вы можете добавить эту строку в свой interwiki.local.conf: ubuntu https://wiki.ubuntu.com/{NAME} и теперь создайте ссылку на него следующим образом: [[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu on Toshiba Portege M700 Tablet]] Если имя вики уже будет включать закодированные символы (например, ''%26'' для &), используйте ''{PATH}'' в определении interwiki.local.conf. ==== Интер(н)вики-ссылки ==== Чтобы сослаться на определенные пространства имен в вашей собственной вики:((Примечание: ссылка всегда будет отображаться так, как будто страница уже существует. Никакого 'preprove'.)) :ns:..: Например: 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 и называться по названию сочетания клавиш. * ''/lib/images/interwiki''\\ Каталог для размещения файлов изображений. Вам также следует очистить [[wiki:caching|кэшированные]] изображения PNG и GIF, а также файлы CSS , если у вас установлено изображение по умолчанию вместо загруженного вами. rm -rf /data/cache/*/*.{gif,png,css} На самом деле может быть достаточно сделать кэширование CSS недействительным , повторно сохранив его в менеджере конфигураций («повторное сохранение» означает нажатие кнопки сохранения в менеджере конфигураций без внесения каких-либо изменений в параметры конфигурации). Если вы хотите отключить все или некоторые значки ссылок, см. раздел [[wiki:tips:disabling link icons|Отключение значков ссылок]]. ===== Использование знака номера/решетки (#), а не в качестве комментария ===== Поскольку решетка ( ) зарезервирована для обозначения строки комментария, ее ''#'' необходимо экранировать обратной косой чертой (''\#''). Например, если вы используете имя вашей интервики в фрагментной части вашего URL-адреса , вам необходимо экранировать его. Пример: * Конфигурация postconf http://www.postfix.org/postconf.5.html\#{NAME} * Использование [[postconf>smtpd_tls_received_header]] ===== Смотрите также ===== * [[wiki:tips:interwiki_shortcuts|Дополнительные ярлыки InterWiki]] * Вы можете установить и использовать [[wiki:plugin:confmanager|{{https://raw.githubusercontent.com/cosmocode/confmanager/master/admin.svg?16}}]][[wiki:plugin:confmanager|менеджер файлов конфигурации]] для редактирования через интерфейс администратора вики. * [[wiki:config|Configuring DokuWiki]] * [[https://www.dokuwiki.org/interwiki|Ссылка на оригинальную статью]]