====== Config ======

After you close the application for the first time a config file gets written containing global settings. There are separate config files for zim in read-write and zim in readonly mode. Both files can be found at ''$XDG_CONFIG_HOME/zim/'', where ''$XDG_CONFIG_HOME'' defaults to ''$HOME/.config/''

Documented below are setting you might want to set manually, other settings are updated automatically from the gui.

===== Config =====

=== default_root (undefined) ===
This option can set a directory to use as repository root when none was given at the command line. If set you can call ''zim'' without arguments.

=== default_home (Home) ===
Default home page. This is used for the "home" button and keybinding.

=== browser (undefined) ===
This option can configure a command to use when an external link was clicked. If undefined the ''$BROWSER'' environment variable is used. If the command contains a ''%s'' it is replaced with the url, else the url is appended.

Note that the browser is used for all external link regardless of protocol.

=== file_browser (undefined) ===
This option can configure a command to use when an "file://" link was clicked. If the command contains a ''%s'' it is replaced with the filename, else the filename is appended.

=== use_tray_icon (0) ===
This option enables the "hide to tray" feature. Needs the Gtk2::TrayIcon module.

=== use_gtkspell (0) ===
This option enables spell checking. Needs the Gtk2::Spell module.

=== use_calendar (0) ===
This option enables the calendar widget.

=== date_string (%A %d/%m/%Y) ===
String that gets inserted on "Insert date" (Ctrl-D). See [[:man:strftime|strftime(3)]] for format options.

=== hist_max (20) ===
Maximum number of items on any of the history stacks.

=== undo_max (50) ===
Maximum number of steps in the undo stack.

=== recent_show (7) ===
Number of items shown in the "recent pages" list.

=== follow_new_link (1) ===
If set new links created with the ^L keybinding are immediatly
followed.

