Table of Contents

Settings File Location

OutWiker keeps all settings in the outwiker.ini file. It may be located in the several places in depending on operating system and running mode (a portable or normal mode).

The portable mode enabled if outwiker.ini file exists in the same folder as executable file outwiker.exe. In the portable mode OutWiker looks all settings, plug-ins and page styles in the same folder solely. In this case the program may be secure executed from the flash drive on the foreign computer.

If OutWiker executed in the normal mode, under Windows 7 and above the outwiker.ini file is locating at the C:\Users\USERNAME\AppData\Roaming\outwiker or analogous user's profile folder. In the same place will be locating folders for the plug-ins, user's styles and icons.

Under Linux settings file location is able to depend on the XDG_CONFIG_HOME environment variable. If the XDG_CONFIG_HOME environment variable is not set, outwiker.ini file will be located from ~/.config/outwiker/outwiker.ini.

Later in this section will be described the preferences. The dialog for the change preferences is called by Edit - Preferences... menu item.


Interface - General

The first flags destined for the change behavior a program icon in the tray (the region near the system clock under Windows).

If Minimize to tray flag is set, when the "Minimize" button of the main window will be clicked, the main window will be hidden on the taskbar, but program icon will be showed in the tray panel. Such behavior is convenient if OutWiker is launching most of the time.

The Start iconized flag indicates what OutWiker must hide main window by starting. Such behavior is convenient if OutWiker was added to system autorun.

The Always show tray icon flag indicated what the tray icon must by showed always and not only in the minimized state.

The Minimize on close window flag indicated what the program must not closed but minimize only. That to terminate OutWiker, it is necessary select File - Exit... menu item.

The Ask befor exit flag indicated what the program must ask the exit confirmation. So long as OutWiker saves the notes text sufficiently oft, and such confirmations in the others programs need to save the entered data, the purport of this behavior is no matter.

The Autosave interval input field sets time before saving of the current note operations. This value is set in seconds. If this value equal 0, autosaving will be disabled. Besides by timer the notes are saving by other events: by exit from program, switching between notes, switching between "Wiki", "Preview" and "HTML" tabs and other.

The Recent files history length input field sets so far as long must be list of the recent opened files in the File menu.

If the Automatically open the recent file flag have set, then after restart OutWiker the recent wiki will be opened automatically.

The Main window title format input field sets how should look title of the main window. In this field can use the macros:

The Date and time format input field sets how should look the creation and modification dates in different program parts, for example to the right in status bar. OutWiker uses date format from Python language, but it should't remember since to the right of the input field disposes button, that invokes popup menu with all macros from this format.

Some page types (wiki and HTML pages) can show content in the two modes - "Preview" and "Edit". The mode in which will be opened a page may be set with the "Default opening page mode" combo box.

The Language field sets the interface language. If this field was being set to "Auto", the language will be selected automatically depending on the operating system settings. If you can help to translate OutWiker interface to other language, you can use crowdin.com web service.

Interface - Preview

This section is responsible for the appearance HTML pages and wiki pages in preview mode. In this section can set default font size and style (by parameters group Font) as well as add custom CSS styles which will be added to all pages referred above types.

Interface - Tags Cloud

You can change colors which is using on the "Tags" panel:

As this panel you can change behavior OutWiker when you click with left or middle mouse buttons in the "Tags" panel. With click on a tag label you can find the pages marked corresponding tag, add or remove the tag for a current page.

Interface - Attachments

In this section you can select action when you make double click on the file name at the "Attachments" panel.

Possible actions are:

Interface - Hot Keys

In this section you can set or change hot keys to call the program functions. The top side of the window is list of all accessible actions. Below the list located the field with action description and filter to search concrete action ("Search" text field). Below the filter located field to set hot key for selected action.

Interface - Text Printout

This section allow to change parameters of the printing of the text pages as well as HTML pages in HTML mode and wiki pages in Wiki and HTML modes.

In this section you can change font size and style (the parameters group Font), using which will be printed text, also you can change page parameters. Dialog appearance may vary depending on operating system and printer drivers.

Editor - General

This section contains settings for the text editor used for input the notes. Here you can set a font size, style and color (with the Font parameters group) and background color (with the Font color parameters group). For example you can set inverted colors: black background and white text color.

Also in this section you can set colors of selected text and page margin. This elements showed on the follow picture:

On this panel you can enable or disable display of the line numbers (with a Show line numbers flag). The line numbers located on the left side of the text editor.

The Tab width parameter allow you to change size of the tab symbol.

Editor can respond on the Home / End keys two ways. When this keys are pressed the cursor will be moved to begin / end current line or current paragraph (in view of wrapping). This behavior you can select with Home / End keys moves the cursor to the beginning / end of... combo box.

Editor - Spell Checking

In the "Spell checking" section you can select dictionaries for spell checking during text entering.

The dictionaries for spell checking located in a spell folder inside program folder and in a spell folder in the settings folder. In Windows 7 / 8.x / 10 is C:\Users\USERNAME\AppData\Roaming\outwiker\spell, in Linux is ~/.config/outwiker/spell or other place depending on system settings.

In this section you can see and edit custom dictionary which contains the words added by user.

Editor - HTML Editor

This section contains settings for HTML code highlighting on the HTML page and on HTML tab for wiki page. Here you can change font colors and styles for HTML tags, their attributes, numbers, comments, strings in HTML format and invalid HTML elements.

The font name you can change in Editor - General section.

Editor - Wiki Editor

This section contains settings for some wiki code highlighting: links, headers, wiki commands (that is located between the brackets (: ... :) )

Font name and size you can change in Editor - General section.

User's Iconset

Since version OutWiker 1.9 you can set for pages not only predefined icons, but also you can load your own icons. The section User's iconset is intended for this action.

User's and standard icons divided by groups. From the software standpoint icons groups are usual folders inside icons folder. The icons folder located inside settings folder (see Settings file location section). User should not think about this since all actions with icons and groups can be accomplished by user interface this section.

On the left side located user's groups list. The icons can be located outside any group and direct in icons folder (it correspond to Not in groups). with buttons on the bottom the window you can create, remove and rename icons groups.

The icons list for selected group located on the right side of the window. With buttons on the bottom you can add and remove icons, as well as set a picture as a group cover (as well as icon, that will be showed on the left of group name).

Plug-ins

In this section you can view list of the installed plug-ins. If you select a plug-in in the list, information about it will be showing: name, version number, short description and (if exists) link to plug-in page.

In this section you can disable unnecessary currently plug-ins without removing its files.

Wiki Page

This section contains parameters which influences on wiki page appearance.

During the switching to Preview mode on the wiki page is created HTML code transparent for the user. Exactly this code will be showed in Preview mode. In most time user should not think about this code. However for some tasks (for example, if you use OutWiker for blogging) it might be as well to get "raw" HTML code. For this the HTML mode intended. Since this mode need not for everyone, tab of this mode is hidden default. To show this tab you must set Show HTML Code Tab flag.

By Thumbnail size parameter you can set default thumbnails size. The thumbnails is created with %thumb%Attach:filename%% wiki command.

Links on the wiki pages can be inserted in two formats:

When dialog for inserting the link used (dialog invoked by Wiki - Link menu item or corresponding button on toolbar), link must be created in both formats. The preferable format selected by Default link style parameter.

If you create new wiki page and leave its content empty (should not even be spaces), then after switching to Preview mode will be seeing something more useful than blank page. For example, default will be showed attachments list and child page list. This behavior can change with Template for empty page parameter.