❗ Вебсайт в стадии бета-тестирования. Возможны ошибки.

Настройка интервики

Расположение файла

Файл XDG_DATA_HOME/zim/urls.list хранит ссылки интервики. Значение переменной XDG_DATA_HOME определяет начало пути поиска в локальной файловой системе. Это позволяет переносить все файлы блокнота из одного каталога в другой. Перенос изменит значение XDG_DATA_HOME, но остальные относительные пути останутся прежними.

Правила оформления

Рассмотрим правила оформления:

  • файла urls.list;
  • интервики в тексте;
  • переменных в интервики.

Оформление файла urls.list

После установки приложения Zim файл urls.list уже содержит список наиболее часто используемых вики. Файл возможно отредактировать в соответствии с собственными предпочтениями — удалить ненужные строки и добавить собственные.

При добавлении записей в файл urls.list следует соблюдать следующие правила:

  • Размещать только одну ссылку в строке.
  • В каждой строке:
    • указать ключ (идентификатор интервики);
    • поставить пробел или табуляцию;
    • указать фактический адрес URL.

Примеры оформления строк интервики файла urls.list:

# Англоязычная «Википедия» 
wp        https://en.wikipedia.org/wiki/
# Русскоязычная «Википедия» 
wpru      https://ru.wikipedia.org/wiki/
# Проектная документация «Википедии» 
wpmeta    https://meta.wikipedia.org/wiki/
# Сайт IETF со стандартами RFC
rfc       https://www.ietf.org/standards/rfcs/
# Сайт с руководствами (man) к инструментарию GNU
man       https://man.cx/
# Поисковый сервис Google
google    https://www.google.com/search?q=
go        https://www.google.com/search?q=

Кроме ссылок на другие блокноты и сайты интернета в список интервики можно добавить ссылки на часто открываемые каталоги или вызываемые файлы. Начало ссылки выглядит как: file://

Например:

# Часто вызываемый каталог
doc	file://home/user/documents/
# Часто открываемый файл
mf	file://home/user/documents/myfile.md

Оформление интервики в тексте

На страницах блокнота Zim интервики оформляются следующим образом:

  • указать ключ (идентификатор интервики)
  • поставить знак вопроса (?);
  • добавить URL идентификатор страницы.

Пример интервики на страницу «Вики» русскоязычной «Википедии»: wpru?Вики.

Данная интервики аналогична ссылке: https://ru.wikipedia.org/wiki/Вики.

Переменные в интервики

При задании ссылки интервики допустимо использовать переменные:

  • {NAME} для указания идентификатора;
  • {URL} для указания адреса URL.

В случае, если переменная {NAME} содержит ссылку на заголовок страницы, следует указывать адрес URL с якорем «#» внутри переменной.

Для добавления в список ссылки на другой блокнот Zim используется следующая схема адреса URL: zim+file://

Подобная ссылка служит триггером для запуска очередного экземпляра блокнота, содержащего указанный файл.