[ Prev ]
[ Index ]
[ Next ]
Config Files
preferences for documentation of the preferences dialog.
Paths
Freedesktop (Linux etc.)
Zim uses the scheme as laid down in the "XDG Base Directory Specification" as published by freedesktop.org. The default paths are:
XDG_CONFIG_HOME = HOME/.config/
XDG_DATA_HOME = HOME/.local/share/
XDG_DATA_DIRS = /usr/local/share/:/usr/share/
These can be overloaded with the coresponding environment variables.
When zim writes config files it always uses XDG_CONFIG_HOME
. Data files are read only and are searched for in XDG_DATA_HOME
and XDG_DATA_DIRS
. The installation defaults for config files are also installed in XDG_DATA_DIRS
, but these are copied on first use to XDG_CONFIG_HOME
.
Windows
On Windows the default paths are:
XDG_CONFIG_HOME = APPDATA/zim/config/
XDG_DATA_HOME =
APPDATA/zim/data/
Where APPDATA
is the default Windows path to store application data, typically a path like "USERPROFILE\Application Data
".
When there is no HOME
environment parameter defined on Windows either the USERPROFILE
parameter or HOMEDRIVE
+ HOMEPATH
are used. Make sure to define HOME
or USERPROFILE
including a drive letter.
Global Config Files
These config files determine various aspects of how zim behaves. They are global in the sense that they are not specific for one notebook.
Main config file
The default config file is XDG_CONFIG_HOME/zim/preferences.conf
.
The config file is written automatically when you close zim. So if you want to change it manually you need to close all instances of zim first.
There is a hidden option here called "autosave_timeout
" which gives the interval for autosaving in seconds, default is 10.
Interwiki URL list
The file XDG_DATA/zim/urls.list
gives a list of urls which are used for the interwiki function. All files in the XDG_DATA path are read when looking for an url, so you can use XDG_DATA_HOME to overload the installation defaults.
The format consist of one url per line, each line giving the key (which is the interwiki name), followed by whitespace, followed by the actual url. The url can conatin place holders "{NAME}
" or "{URL}", the first will be replaced by the name of the interwiki page, the second by this name in url encoding. If no placeholder is found in the url the url encoded name is appended to the url.
Note that if you want interwiki page to include url syntax like a "#" to link to anchors in the target page, you should write your URLs with "{NAME}
".
Date format list
The file XDG_DATA/zim/dates.list
gives a list of strftime formats, one on each line, to be used to populate the "Insert Date and Time" dialog. The first instance of this file that is found in the XDG_DATA path is used.
See this link for documentation of the strftime formatting.
GUI style config file
Zim has certain defaults on how to display styles. For example it displays links as blue text without underline. To change this style copy "/usr/share/zim/style.conf
" to "~/.config/zim/
" and edit it. Each style has it's own section which starts with the style name between square brackets and contains key value pairs for the various display properties.
NOTE: The display styles for the GUI are not used when exporting to HTML. If you want your HTML to show certain custom styles you should write a HTML template with a CSS stylesheet.
Example:
[TextView]
tabs = 40
font = Sans 10
[Tag bold]
weight = PANGO_WEIGHT_BOLD
[Tag italic]
style = italic
Known properties for TextView:
indent: integer - indenting step size in pixels
tabs: integer - tab size in pizels
linespacing: integer - line spacing in pixels
justify: JUSTIFY_LEFT
, JUSTIFY_FILL
, ...
font: string
Known style tags:
h1, h2, h3, h4, h5, h6: various headings
emphasis: emphasized or italic text
strong: strong or bold text
mark: highlighted or underlined text
strike: strike-through text
code: inline verbatim text
pre: verbatim text as paragraph
sub: subscript text
sup: superscript text
link: hyperlink text
indent: indented lines
bullet-list: lines in a bullet list
numbered-list: lines in a numbered list
unchecked-checkbox: lines with an open checkbox
checked-checkbox: lines with a "v-checked" checkbox
xchecked-checkbox: lines with a "x-checked" checkbox
Known properties for Tags:
family: monospace
, sans
, ...
foreground: grey
, blue
, #cccccc
, etc.
background: yellow
, #cccccc
, etc.
weight: PANGO_WEIGHT_BOLD
, ...
scale: integer
style: italic
, ...
underline: single
, ...
striketrough: true
, false
wrap_mode: "none"
, ...
indent: integer
linespacing: integer
GtkRC file
Gtk+ has it's own config file that allows you to customize how things look. This is the gtkrc file and it is typically saved as ~/.gtkrc-2.0
in the home directory. Some widgets have a name so you can set specific options for those widgets. Widgets that have a name in zim are:
The textview showing the page: zim-pageview
The treeview showing the page index: zim-pageindex
You can for example set the font used in the index by adding this to your gtkrc file:
style "zim-pageindex-style"
{
font_name = "Sans 8"
}
widget "*.zim-pageindex" style "zim-pageindex-style"
or this example to make the treeview a bit more compact:
style "gtkcompact"
{
GtkTreeView::vertical-separator=0
GtkTreeView::horizontal-separator=0
GtkTreeView::expander-size=6
GtkTreeView::fixed-height-mode=TRUE
GtkWidget::focus_padding=0
}
class "GtkWidget" style "gtkcompact"
To change the base colors of the pageview widget use something like:
style "mycolors"
{
base: "#ccc"
text: "#fff"
}
widget "*.zim-pageview" style "mycolors"
Check the internet for more examples.
Notebook config file
There is a notebook specific config files called "notebook.zim
" which should be in the notebook folder. This file contains a section "[Notebook]
" which contains the properties that can be set in the properties dialog.
There is one hidden property, called "end_of_line
" which determines the end-of-line convention for files written by zim within the scope of this notebook. The value can be either "dos
" or "unix
". For newly created notebooks this value is set depending on the platform on which zim is running. Main purpose of this property is to ensure that a notebook which is shared between e.g. linux and windows machines does not change the full file on every write. When desired the property can be changed manually, which will affect all pages edited after the change.
A second hidden option is "disable_trash
" which defaults to False
. If enabled this will cause zim to avoid using the system trash for this notebook, see the section about deleting in Pages.
Файлы конфигурации
============
На этой странице описаны различные используемые файлы конфигурации.
Также смотрите настройки для документирования диалога настроек.
пути
-----
### Freedesktop (Linux и т. Д.)
Zim использует схему, изложенную в «Спецификации XDG Base Directory», опубликованной freedesktop.org. Пути по умолчанию:
XDG_CONFIG_HOME = HOME / .config /
XDG_DATA_HOME = HOME / .local / share /
XDG_DATA_DIRS = / usr / local / share /: / usr / share /
Они могут быть перегружены соответствующими переменными среды.
Когда zim пишет файлы конфигурации, он всегда использует XDG_CONFIG_HOME. Файлы данных доступны только для чтения и ищутся в XDG_DATA_HOME и XDG_DATA_DIRS. Установочные значения по умолчанию для файлов конфигурации также устанавливаются в XDG_DATA_DIRS, но при первом использовании они копируются в XDG_CONFIG_HOME.
### Windows
В Windows пути по умолчанию:
XDG_CONFIG_HOME = APPDATA / zim / config /
XDG_DATA_HOME =
AppData / ZIM / данные /
Где APPDATA - это путь Windows по умолчанию для хранения данных приложения, обычно это путь типа «USERPROFILE \ Application Data».
Если в Windows не определен параметр среды HOME, используется либо параметр USERPROFILE, либо HOMEDRIVE + HOMEPATH. Обязательно укажите HOME или USERPROFILE, включая букву диска.
Глобальные файлы конфигурации
-------------------
Эти файлы конфигурации определяют различные аспекты поведения zim. Они носят глобальный характер в том смысле, что они не являются специфичными для одного ноутбука.
### Основной конфигурационный файл
Конфигурационный файл по умолчанию - XDG_CONFIG_HOME / zim / preferences.conf.
Файл конфигурации пишется автоматически при закрытии Zim. Поэтому, если вы хотите изменить его вручную, вам сначала нужно закрыть все экземпляры zim.
Здесь есть скрытая опция autosave_timeout, которая дает интервал для автосохранения в секундах, по умолчанию 10.
### Список URL Interwiki
Файл XDG_DATA / zim / urls.list содержит список URL, которые используются для функции interwiki. Все файлы в пути XDG_DATA читаются при поиске URL-адреса, поэтому вы можете использовать XDG_DATA_HOME, чтобы перегрузить установки по умолчанию.
Формат состоит из одного URL-адреса в каждой строке, в каждой строке указывается ключ (который является именем вики), за которым следует пробел, после которого следует фактический URL-адрес. URL может содержать заполнители "{NAME}" или "{URL}", первый из них будет заменен именем страницы вики, второй - этим именем в кодировке URL. Если в URL не найдено местозаполнителя, к нему добавляется закодированное имя URL.
Обратите внимание, что если вы хотите, чтобы на странице Interwiki содержался синтаксис url, например, "#", для ссылки на якоря на целевой странице, вы должны написать свои URL с помощью "{NAME}".
### Список формата даты
Файл XDG_DATA / zim / date.list содержит список форматов strftime, по одному в каждой строке, которые будут использоваться для заполнения диалогового окна «Вставка даты и времени». Первый экземпляр этого файла, который находится в пути XDG_DATA, используется.
Смотрите эту ссылку для документации по форматированию strftime.
### Файл конфигурации в стиле GUI
У Zim есть определенные настройки по умолчанию для отображения стилей. Например, он отображает ссылки в виде синего текста без подчеркивания. Чтобы изменить этот стиль, скопируйте «/usr/share/zim/style.conf» в «~ / .config / zim /» и отредактируйте его. Каждый стиль имеет свой собственный раздел, который начинается с имени стиля в квадратных скобках и содержит пары значений ключа для различных свойств отображения.
ПРИМЕЧАНИЕ. Стили отображения для графического интерфейса не используются при экспорте в HTML. Если вы хотите, чтобы ваш HTML отображал определенные пользовательские стили, вы должны написать шаблон HTML с таблицей стилей CSS.
Пример:
[TextView]
tabs = 40
font = Sans 10
[Тег жирный]
вес = PANGO_WEIGHT_BOLD
[Tag italic]
стиль = курсив
Известные свойства для TextView:
* indent: integer - размер шага отступа в пикселях
* tabs: integer - размер вкладки в пикселях
* linespacing: integer - межстрочный интервал в пикселях
* обосновать: JUSTIFY_LEFT, JUSTIFY_FILL, ...
* шрифт: строка
Известные теги стиля:
* h1, h2, h3, h4, h5, h6: различные заголовки
* выделение: выделенный текст или курсив
* сильный: сильный или жирный текст
* отметка: выделенный или подчеркнутый текст
* страйк: зачеркнутый текст
* код: встроенный дословный текст
* pre: дословный текст в виде абзаца
* sub: нижний текст
* sup: надстрочный текст
* ссылка: текст гиперссылки
* отступ: отступы
* bullet-list: строки в списке маркеров
* нумерованный список: строки в нумерованном списке
* unchecked-checkbox: строки с открытым флажком
* флажок проверен: строки с флажком «проверено v»
* xchecked-checkbox: строки с флажком «x-checked»
Известные свойства для тегов:
* семья: моноспейс, без ...
* передний план: серый, синий, #cccccc и т. д.
* фон: желтый, #cccccc и т. д.
* вес: PANGO_WEIGHT_BOLD, ...
* шкала: целое число
* стиль: курсив, ...
* подчеркивание: одиночный, ...
* зачеркивание: правда, ложь
* wrap_mode: "нет", ...
* отступ: целое число
* межстрочный интервал: целое число
### GtkRC file
Gtk + имеет свой собственный конфигурационный файл, который позволяет вам настроить внешний вид. Это файл gtkrc, который обычно сохраняется как ~ / .gtkrc-2.0 в домашнем каталоге. У некоторых виджетов есть имя, поэтому вы можете установить конкретные параметры для этих виджетов. Виджеты с именем в Zim:
* Текстовое представление, показывающее страницу: zim-pageview
* Древовидная структура, показывающая индекс страницы: zim-pageindex
Например, вы можете установить шрифт, используемый в индексе, добавив его в ваш файл gtkrc:
стиль "Зим-Пейдж-стиль"
{
font_name = "Sans 8"
}
виджет "* .zim-pageindex" в стиле "zim-pageindex-style"
или этот пример, чтобы сделать дерево более компактным:
стиль "gtkcompact"
{
GtkTreeView :: вертикальный сепаратор = 0
GtkTreeView :: горизонтально-разделитель = 0
GtkTreeView :: детандер-размер = 6
GtkTreeView :: фиксированной высоте режим = TRUE
GtkWidget :: focus_padding = 0
}
класс "GtkWidget" в стиле "gtkcompact"
Чтобы изменить базовые цвета виджета просмотра страницы, используйте что-то вроде:
стиль "миколорс"
{
база: "#ccc"
текст: "#fff"
}
виджет "* .zim-pageview" в стиле "mycolors"
Проверьте интернет для большего количества примеров.
Конфигурационный файл ноутбука
--------------------
Конфигурационные файлы для ноутбуков называются «notebook.zim», которые должны находиться в папке ноутбука. Этот файл содержит раздел «[Записная книжка]», в котором содержатся свойства, которые можно установить в диалоговом окне свойств.
Существует одно скрытое свойство, называемое end_of_line, которое определяет соглашение об окончании строки для файлов, написанных zim в рамках этой записной книжки. Значение может быть «dos» или «unix». Для вновь созданных ноутбуков это значение устанавливается в зависимости от платформы, на которой работает zim. Основная цель этого свойства состоит в том, чтобы гарантировать, что записная книжка, которая используется, например, Linux и Windows не изменяют полный файл при каждой записи. При желании свойство может быть изменено вручную, что повлияет на все страницы, отредактированные после изменения.
Второй скрытый параметр - «disable_trash», который по умолчанию равен False. Если этот параметр включен, zim не будет использовать системный мусор для этого ноутбука, см. Раздел об удалении на страницах.
Backlinks: Plugins:Distraction Free Editing FAQ Help Help:Default Applications Help:Links Help:Pages