====== Preferences ======

This page documents the contents of the "Preferences" dialog. For docmentation of the config files look [[config|here]].

You can open the "Preferences" dialog using the "//Edit//->//Preferences//" menu item. There are several tabs within the preferences dialog:

==== General ====

The **User name** is the name of the person using the program. By default this will be your login name but you can set it to your real name and for example add your email address. This name can be used in templates, for example when you export content.

The **Date format** is a format string which is used as default format when a date is needed. See [[:man:3:strftime|strftime(3)]] for a description of the syntax used. 

The **Browser** is the command used to open external links like ''http://'' urls, the **File browser** is the command used to open files on the local system and the **Email client** is the command used to open ''mailto:'' uris and anything else that looks like an email address. The browser and email client commands should contain a ''%u'' which will be replaced with the url. The file browser command can either contain a ''%f'' to open files or a ''%d'' to open the directory of the files in question.

Note that the integration of "open with" items in the context menu for external files does not use the file manager directly. Also when a default application is set for a certain file type that application is executed directly. Only when there is no default application the file manager is called when you try to open a file.

( For users who use the Rox file manager: you can symlink the "''SendTo''" directory used by Rox in "''~/.local/share/zim/''" and the "SendTo..." menu will show up in the context menu below or instead of the usual "Open with" items. )

==== Interface ====

The Interface tab contains a number of settings which control the look and the behavior of the program interface.

**Use "Enter"** controls whether the "Enter" key can be used to follow links. The "Alt-Enter" key combination always follows links. **Use "Ctrl-Space"** controls whether the "Ctrl-Space" key combination is used to switch focus between the side pane and the page contents. The "Alt-Space" combination does the same. **Use "Backspace"** controls whether the "Backspace" is used to un-indent, just as the "Shift-Tab" combination.

**Tearoff menus** sets whether a "tearoff strip" is shown in the menubar menus. Using this tearoff strip the menu can be used as toolboxes.

When you set **Use custom font** you can choose an alternative font for the display of page contents. Unsetting this option will return the display to the defalut fonet. Note that the font choosen here is only a setting of the interface, the font it is not part of the page contents.

==== Editing ====

**Auto-link CamelCase**, **Auto-link files** and **Auto-format entities** are settings to toggle the [[autoformat]] behavior.

The A**uto-select words** option turns autoselection on. This means that for example when you press ''<ctrl>B'' in the middle of a word, the whole word is made bold.

==== Plugins ====

The plugins tab allows you to turn plugins on or off. You need to restart zim for these settings to take effect.

For a description of the standard plugins have a look [[plugins|here]].
