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 switched on 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 will be locating in 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. Is possible this flag will be removed in the next versions.
The Autosave interval input field sets how often a current note will have saved. 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 {page} and {file} what will be replaced to title of the current page and title of the notes tree accordingly.
The Main window title format input field sets how should look the creation and modification dates in different program parts, for example to the right in statusbar. 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.
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 want to translate 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 - 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 can change font size and style (the parameters group Font), using which will be printed text, also 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, which uses for input the notes. Here can set font size, style and color (the parameters group Font) and background color (the parameters group Font color). For example you can set inverted colors: black background and white text color.
Here can enable or disable the display of line numbers (by Show line numbers flag). The line numbers located on the left of the main input field.
The Tab width parameter allow 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 can select with Home / End keys moves the cursor to the beginning / end of... parameter.
Editor - HTML Editor
This section contains settings for HTML code highliting on the HTML page and on HTML tab for wiki page. Here can change font colors and styles for HTML tags, their attributes, numbers, comments, strings in HTML format and invalid HTML elements.
The font name 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 can change in Editor - General section.
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 to the user. Exactly this code will be showed in Preview mode. In most time user needn’t 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. That show this tab need set Show HTML Code Tab flag.
By Thumbnail size parameter can set default thumbnails size. Thumbnails is created by %thumb%Attach:filename%% wiki tag.
Links on the wiki pages can be in two formats:
- [[Link -> Comment]]
- [[Comment | Link]]
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.
User's iconset
Since version OutWiker 1.9 you can set for pages not only predefined icons, but you can load own icons. For this intended the section User's iconset.
User's and standard icons divide 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 needn’t think about this since all actions with icons and groups can be accomplished by user interface this section.
On the left located user's groups list. Icons can be located outside any group, direct in icons folder, than correspond to Not in groups item. By buttons in the bottom can create, remove and rename icons groups.
In the right located icons list for selected group. By buttons in the bottom can add and remove icons, as well as set icons as group cover (as well as icon, that will be showed on the left of group name).
Plugins
In this section can view list installed (succesfully laoded) plug-ins. After plug-in selection will be showed information about: name, version number, short description and, if exists, link to plug-in page.
In this section can disable unnecessary currently plug-ins without removing its files.
Hotkeys
In this section can change or set hotkeys for calling program actions. In the left located list of the all actions. In the right located controls to set hotkey and more detailed description for this action. In the right bottom showed action which uses current hotkey by this time, that to see possible conflicts.