parent nodes: WikidPadReferences
Wp Options
Contents:
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
Application settings: 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:
You can safely open the same wiki in multiple windows (on the
same computer and by the same user only!)Less resources (esp. memory) are needed to run multiple windows
Disadvantages:
If one window is busy due to a search or database rebuild, all windows do not react.If one window crashes (in fact the process driving it) all windows crash.An IP-socket connection is needed for communication between
processes. The connection is invisible for other computers on
a network or the internet, but a personal firewall software
may alarm you nevertheless. Also, if multiple user use
WikidPad on the same computer at the same time, all must use
their own home directory as configuration directory (this is
the default).
• 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.
Application settings: General, sort order
• Sort order
Sets the alphabetical sort algorithm for the nodes in the Main tree and for the PageListDialog.
The possible choices are:Default: sorts according to default sort order determined by the operating system.
Upper case first: sorts ABCabc instead of AaBbCc.
C: The original WikidPad sort order: uppercase first, non-English characters in illogical order at the end
Application settings: General, rename link
• 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:yes: rename by defaultno: never renameask: ask if it should be done (this is the default setting)
Application settings: General, wiki control
• 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
Application settings: 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.
Application settings: User interface, wiki control
• Recent wikis list length
Set the number of wikis to show in menu "Wiki"->"Recent"
Application settings: User interface, log window
• 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.
Application settings: User interface, structure window
• 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
Application settings: File Launcher
This option page is only visible on non-Windows systems.
• 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
Application settings: 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:No scripts: Script execution is completely disabled. This is the default.No import_scripts: Scripts on the currently open page can be executed and expressions evaluated. Importing scripts from other pages with the import_scripts property doesn't work (see below how to do this).No global.import_scripts: Property "import_scripts" works, but "global.import_scripts" does notAllow everything
Top
Main tree
Application settings: 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.
KNOWN BUG: After changing the position of main or view tree, the trees do not react on clicks properly any longer. Restart WikidPad. See WorkSpaceGeneral for details.
Top
Html preview
Application settings: 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
Application settings: 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
Application settings: HTML header
These options have the same meaning and values as the global and local html attributes; see there for details.
The options set the application defaults and are overridden by the global and local attributes.
These settings will be inserted in the html pages as attributes of "<body>"-tag.
• 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
Application settings: Autosave
• 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
Application settings: Editor, general
• 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.
Application settings: Editor, short hint
• 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.
Application settings: Editor, bullets
• 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.
Application settings: Editor, auto complete
• 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").
Application settings: Editor, image pasting
• 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 typeNone: Don't store images at allPNG: Store in PNG format (losless compression)JPEG: Store in JPEG format (lossy compression)
• Quality
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
Application settings: 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
Application settings: Editor, clipboard catcher
This page is only visible on Windows.
• 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
Application settings: 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.
Application settings: Mouse, drag & drop files
• 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:NothingAbsolute URL: Insert absolute URL(s) to the file(s)Relative URL: URL(s) starting with "rel:"Relative into storage: Copy file(s) into file storage and create relative URL(s) to it
Top
Time view
Application settings: 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
Application settings: Searching, full search
• 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.
Application settings: Searching, incremental search
• Delay before auto-close
Controls how many seconds of inactivity before the incremental search is closed automatically. 0 means "wait forever".
Top
Structure graphs
Application settings: see StructureGraphs
Remarks:
• Options that are left empty use the "GraphViz" default settings.
• Colors are specified using standard 6 digit HTML color values.
• 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
Application settings: Advanced
Warning: These settings should only be changed when it is absolutely necessary!
• 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
Application settings: Plugins, Gnuplot
• Path to Gnuplot
The path to the Gnuplot executable.
Application settings: Plugins, GraphViz
• 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.
Application settings: Plugins, MimeTex
• Path to MimeTex
The path to the MimeTex executable.
Application settings: Plugins, Ploticus
• 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