Содержание
Ссылки 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]]
Смотрите также
- Вы можете установить и использовать
менеджер файлов конфигурации для редактирования через интерфейс администратора вики.