parent nodes: WikidPadReferences

Wp Options

Contents:
Wp Options
Options: Application settings
General
User Interface
File Launcher
Security
Main tree
Html preview
Html export
Html header
Auto save
Editor
Editor colors
Editor clipboard catcher
Mouse
Time view
Searching
Structure graphs
Advanced
Plugins

Back

Options: Application settings

This page lists all the possible application settings; they can be found in the main menu as: Wiki / Options. [1].

Top
[1] The page has been assembled using page inserts; it's contents can only be seen in preview.

General

Low resource usage
Try to reduce usage of Windows resources. Only interesting for Windows 9x/ME.

Single process per user
If you open a new WikidPad instance while another is already running, the new window is handled by the same process as the first one. This option has only an effect after restarting WikidPad. It is off by default.

Advantages:
Disadvantages:
App-bound hotkey
Here you can define a hotkey to show or hide WikidPad (they may only work on Windows). Hotkeys work system-wide, not only if WikidPad is active.

In the text field you can enter a hotkey in the same way as the menu shortcuts are. Unlike menu shortcuts, you can also use "win" as modifier (like "alt" or "ctrl"), but the hotkey must have at least one of "ctrl" or "alt" modifiers to work.

The checkbox before the text field allows to temporarily deactivate the hotkey without deleting the field content.

There is also an option to set a second hotkey which is bound to the current wiki instead of the app. See OptionsDialog#Wiki-bound# hotkey below in "Current wiki" options.
Sort order
Sets the alphabetical sort algorithm for the nodes in the Main tree and for the PageListDialog.
The possible choices are:
Rename links when renaming wiki word
This option controls whether Wikidpad will or will not rename all references to a renamed page. The possible setting are:
New window on wiki URL
When double clicking on a wiki: URL, a new instance of the application is started, otherwise, the current instance loads the new wiki.

Store relative pathes to wikis
Pathes to the recently opened wikis are stored as relative pathes if this is checked. Useful e.g. if you have WikidPad and your wikis on an USB-stick.

Default open/new dir.
Directory to start when using "Wiki"->"New" or "Wiki"->"Open" in the menu. If empty, WikidPad chooses a default.

Top

User Interface

Minimize to Tray
Minimized to system tray instead of the normal taskbar.

Minimize on close button
Pressing the close button on the main frame (the little "X") does not close but minimize WikidPad. In conjunction with "Minimize to Tray" it minmizes to the try area.

If you really want to close, use menu "Wiki"->"Exit" then or the context menu when right-clicking on the tray icon (if "Minimize to Tray" is active).

Statusbar time format
Set the time format the statusbar should use to show modification and creation date of the current wiki page. The format can also be set by clicking on the small "..." button which starts the same dialog as used for setting the date format for the editor.

UI language
Choose the preferred language of the user interface.
This setting only takes effect after restarting WikidPad.
Recent wikis list length
Set the number of wikis to show in menu "Wiki"->"Recent"
Auto-show log window
Automatically show log window if new error messages arrive. Can be overruled by the wiki level option "Auto-show log window"

Auto-hide log window
Automatically hide log window if no more error messages are present.
Structure window pos.
Where (relative to main window) should the window be positioned? "Hidden" deactivates it.
KNOWN BUG: After changing the position of the window, restarting WikidPad is necessary. See WorkSpaceGeneral for details.

Structure window depth
Up to (and including) which heading level should headings be displayed? "1" Means only top-level heading (one plus sign), "15" means all headings.

Auto-hide structure window
After double-clicking an entry in the window it is collapsed (hidden) automatically if this setting is checked.

Top

File Launcher

Path to file launcher
The path to the script or program that takes the path or URL of a file and runs the application associated with this file. For Linux this would be the "xdg-open" script; it might in some cases have to be installed first.

On Windows and Linux, data files with a particular suffix can be associated with a particular application, so that the data file (e.g. "index.html") can be "executed" by starting the application with the file as parameter. On Windows this is a functionality of the OS itself while on Linux it is a functionality of the graphical environment like KDE or Gnome. To use this function there, a helper (normally the "xdg-open" script) must be called which detects the appropriate application and starts it.

When (double)clicking a URL in WikidPad on Linux, the script is called with a file path (for "file:"/"rel:" URLs) or the URL itself as parameter.

Top

Security

Process auto-generated areas
Experimental feature, use not recommended!

Process insertion scripts
Control if insertions with key "eval" are allowed be evaluated as Python expressions or not, see also Scripts.

Script security
Set the security level for script execution, see also Scripts. The possible options are:
Top

Main tree

Tree auto-follow
The tree tries to always select the wiki word currently shown in the editor or HTML-view.

Tree update after save
After each (automatic or manual) save, the tree icons and shown children are updated. This may need some time and may create some flicker going from top to bottom through the tree.

Hide Undefined WikiWords in Tree
If a page contains wiki word links to non-existing pages, these are not shown as children in the tree.

No cycles in tree
If two or more pages reference each other (e.g. NodeA -> NodeB -> NodeA) these cycles are not shown. Precisely: if a child of a word is already an ancestor (parent, grandparent, ...) of this word, it is not shown.

Tree auto-hide
After selecting an item in tree, the tree is hidden automatically. It can be brought back, by pressing Ctrl-T

Background color
Specify background color of tree.

Position main tree
Controls where to place the main tree (to the left, right, top or bottom)

Position view tree
You can also have a second tree which has the "Views" node as root. You can place it relative to the main tree (above, below, left or right) or choose "hidden" if you don't want it.

Top

Html preview

Font name for html preview
Enter the desired font name for the HTML preview. Clicking on the "..." button shows a list of available fonts.

Show pics as links in preview
If this option is checked, links to image URLs (those ending with .png, .gif or .jpg) are shown like other links in the preview. If it is unchecked, the images (if available) are shown.

Props. to yes/no include in preview
A regular expression for the properties to be shown in HTML preview or not. See ThePreview.

Preview renderer
Under Windows you can choose the renderer for the HTML preview. See ThePreview and HtmlFormatting.

Top

Html export

Start browser after export
Starts the current web browser after exporting to XML.

Shows pics as links in export
If this option is checked, links to image URLs (those ending with .png, .gif or .jpg) are shown like other links in the export. If it is unchecked, the images (if available) are shown.

Table of contents
Choose if you want a table of contents in tree form, list form or not at all.
For a single HTML page, the TOC is at the beginning of the page, for a set of HTML pages, it is a separate "index.html" file. Using "As tree" is recommended when exporting the whole or nearly the whole wiki, "As list" is better for small subsets of a wiki as the tree option gives unexpected results here.

Title of toc
Set the title of the table of contents according to your language. The default is "Table of Contents". For German it could be e.g. "Inhaltsverzeichnis".

Single page separator lines
Set the number of separator lines to separate wiki pages in a single HTML page on export.

Top

Html header

Link color

Active link color

Visited link color

Text color

Background color

Background image

Doctype
Sets the DOCTYPE to use in the header of an HTML file. You should only modify it if you understand what it is doing.

Top

Auto save

Autosave active
Save current page content to disk (if modified) after a few seconds of inactivity.

There are two delays which both must be exceeded before a save operation is triggered (if Autosave is active).

Delay after key pressed
How long to wait after the last keypress in the editor (default: 3 seconds). Recommended value: 1 to 5 seconds.

Delay after page dirty
How long to wait after the page was initially modified (dirty) after last save (default: 15 seconds). Recommended value: 15 to 180 seconds.

Top

Editor

Sync. highlighting limit
Limit of page size in bytes when to switch from synchronous highlighting (calculated after each keypress) to asynchronous highlighting (calculated in the background and shown when ready). Recommended value: 3000 to 5000 bytes

Highlight start delay
For async. highlighting how long to wait after key press (in seconds) before starting the highlighting work in background. Recommended value: 0.2 to 0.5 seconds

Synchronize editor by preview selection
This option provides a workaround to synchronize the scroll position in HTML preview with that in the editor.
If this option is checked, you can select some text in the preview and when switching back to the editor, the selected text will be searched by the editor and it's first occurrence highlited as selected.
Short hint delay
Set the number of milliseconds that have to pass before showing the short hint tooltip in the editor. A value of zero "0" deactivates the tooltip.
Auto-unbullets
When this option is active and enter is pressed on a line which contains only a bullet or a numbering without text, the bullet is removed.
Append closing bracket on auto-complete
When suggesting the completion for a bracketed wiki word, e.g. "[Not Came" you can decide if a closing bracket is suggested ("[Not Camel Case]") or not ("[Not Camel Case").
Filename prefix
A prefix to use for the filename. If this filename plus suffix exists already in "files" dir, an underscore and a sequence of 20 random letters or numbers is appended to create a unique filename. E.g. you want to store a PNG-file with prefix "foo" then WikidPad checks if "foo.png" is already in the "files" directory (if prefix is empty, this is not tried). If "foo.png" exists it tries something like "foo_2NIUXQ0OGVRDT1O3JNUN.png". If this exists already it tries again (up to 20 times) before giving up.

File typeQuality
Number to define quality of JPEG compression (0:worst, 75:default, 100:best)

Ask settings on each paste
If checked, each time you paste an image, a dialog box asks for the above settings to set them individually.

Top

Editor colors

Plain text color
Specify the color of plain text (like this one) in the editor by pressing the little "..." button to start the color dialog or by entering a numeric HTML color (e.g. "#000000" for black) in the text field. Leaving the field empty chooses the default color.

Link color
Set the color of links (URLs and existing wiki words, e.g. http://nowhere) in the editor. See "Plain text color" above for details.

Attribute/script color
Set the color of attributes and scripts (e.g. ) in the editor. See "Plain text color" above for details.

Background color
(Works only partially). Specify the background color of the editor. See "Plain text color" above for details.

Selection fg. color
Specify the foreground color of selected text. See "Plain text color" above for details.

Selection bg. color
Specify the background color of selected text. See "Plain text color" above for details.

Margin color
Specify the color of the editor margin on the left (normally gray) which can also contain line numbers.

Text cursor color
Set the color of the text cursor (the small blinking vertical bar).

Top

Editor clipboard catcher

Prepend before clipboard snippet
Control what the Clipboard Catcher should prepend before each caught snippet. This option supports time formats (as these shown in "Set Date Format" dialog in "Editor" menu)

Append after clipboard snippet
Control what the Clipboard Catcher should append after each caught snippet. This option supports time formats (as these shown in "Set Date Format" dialog in "Editor" menu). The same escapes can be used as in the replace field of the "Find and Replace" dialog in regular expression mode.

Avoid doubled snippets
If the same text is pasted multiple times consecutively to the clipboard, it is pasted only the first time. Some applications execute a single paste command as multiple pastes to the clipboard which would lead to multiple inserts without this option.

User notification
Choose if you want to hear a sound when a clipboard snippet is inserted.

Sound file
Choose the sound file to play (if you have chosen to be notified by sound above). If the field is empty, a default sound is played.

Top

Mouse

Middle button without CTRL
Set the reaction of a middle button click on a wiki word in editor, internal preview, tree or wiki-wide search results if CTRL is not pressed while clicking. You can choose between opening the word in a new tab in foreground, in background or in the same (active) tab.

Middle button with CTRL
Same as before, but set reaction if CTRL is pressed while clicking the middle button.

Left double click in preview
When double clicking into preview (not on a link), this can either do nothing, switch the tab to editor or open a new tab with same page, but in editor mode.

Middle click on tab
This can either do nothing or close the tab.
Dropping files
Dropping files with SHIFT
Dropping files with CTRL
Control what should happen if you drag and drop files from explorer into the editor with no key pressed, with SHIFT pressed or with CTRL pressed.

Possible choices are:
Top

Time view

Time view pos.
Where (relative to main window) should the window be positioned? "Hidden" deactivates it.
KNOWN BUG: After changing the position of the window, restarting WikidPad is necessary. See WorkSpaceGeneral for details.

Date format
Set the time format the timeline should use to show the dates. The format is also used when interpreting a date entered by the user in the time view.
The format can also be set by clicking on the small "..." button which starts the same dialog as used for setting the date format for the editor.

Time view auto-hide
After selecting an item in time view, time view is hidden automatically.

Show word list on hovering
Should the list of related wiki words be shown when hovering over a date with mouse.

Show word list on select
Should the list of related wiki words be shown when selecting (clicking on) a date.

Show empty days
Should "empty" dates without relatzed wiki words be shown in the timeline.
This option can also be set in the context menu of the timeline.

Show dates ascending
Control if the dates in timeline should be sorted ascending or descending.
This option can also be set in the context menu of the timeline.

Top

Searching

Context characters: before and after
Chooses the number of characters to show before and after a found match as context in wiki-wide search. For an "anded" regex, the beginning of the page is shown with so many characters as the sum of the "before" and "after" values. Using context may slow down the searching a bit.

Count Occurrences
Counts how many matches a page contains and shows this number in parentheses after each page name in wiki-wide search results. This option slows down searching.
Delay before auto-close
Controls how many seconds of inactivity before the incremental search is closed automatically. 0 means "wait forever".

Top

Structure graphs

Node font name
Node font size
The name and size of the font to use for the node label

Node border color
The color of the small border line surrounding each node

Node background color
The color of the node background.
Remark: If the wiki page described by a node has a "[color: color name]" attribute then that color attribute overrules this option setting.

Edge color
The color of the edges connecting the nodes.

Top

Advanced

Ignore wiki lock file
(Default: off) When checked, a wiki is opened without warning even if a lock file is already present.

Create wiki lock file
(Default: on) When not checked, no lock file is created when opening a wiki (and it isn't deleted when closing it). This setting does not affect the behavior of the wikis already opened.

Top

Plugins

Path to Gnuplot
The path to the Gnuplot executable.
Path to GraphViz
The path to the GraphViz directory of executables.

Name of dot executable
The name of the dot executable; default = dot.exe.

Name of neato executable
The name of the neato executable; default = neato.exe.

Name of twopi executable
The name of the twopi executable; default = twopi.exe.

Name of circo executable
The name of the circo executable; default = circo.exe.

Name of fdp executable
The name of the fdp executable; default = fdp.exe.
Path to MimeTex
The path to the MimeTex executable.
Path to Ploticus
The path to the Ploticus executable.

Top
previous: Back
parents:  WikidPadReferences
attributes: [tree_position: 2]
[help.status: done]

Inserts
WpOptionsGeneral
WpOptionsGeneralSort
WpOptionsGeneralRename
WpOptionsGeneralWikiControl
WpOptionsUserInterface
WpOptionsUserInterfaceWikiControl
WpOptionsUserInterfaceLogWindow
WpOptionsUserInterfaceStructWindow
WpOptionsFileLauncher
WpOptionsSecurity
WpOptionsTree
WpOptionsHtmlPreview
WpOptionsHtmlExport
WpOptionsHtmlHeader
WpOptionsAutoSave
WpOptionsEditor
WpOptionsEditorShortHint
WpOptionsEditorBullets
WpOptionsEditorAutoComplete
WpOptionsEditorImagePasting
WpOptionsEditorColors
WpOptionsEditorClipboardCatcher
WpOptionsMouse
WpOptionsMouseDropFiles
WpOptionsTimeView
WpOptionsSearchingFull
WpOptionsSearchingIncremental
WpOptionsStructureGraphs
WpOptionsAdvanced
WpOptionsPluginsGnuplot
WpOptionsPluginsGraphViz
WpOptionsPluginsMimeTex
WpOptionsPluginsPloticus