Collapse AllExpand All

2. Preference keys

KeyTypeDefaultCorresponding Option
activeInputMethodClientbooleanfalseUse integrated input method support
addOpenLinesbooleantrueAdd open lines
addonInstallDiruser|system|bestbestInstall add-ons in the user's preferences directory
addonSourceservers|directory|bothserversDownload add-ons from these servers
addonServerslist of URLs separated by newline characters ('\n')See Download add-ons from these servers.When addonSource=servers, this key specifies the list of ``servers''. See Download add-ons from these servers.
addonDirthe filename of an existing directorynoneWhen addonSource=directory, this key specifies the local directory. See Search add-ons in this directory.
allowAdvancedXIncludebooleanfalseAllow advanced use of XInclude
appendSuggestionModenone, auto or manualmanualAppend mode
autoCheckForUpdatesbooleantrueCheck for Updates
autoCheckForUpdates.intervalpositive integer86400 (24 hours)Specifies the minimal amount of time, in seconds, between two automated checks. See Check for Updates.
autoCheckForUpdates.afterinteger between 10 and 14400120 (2 minutes)Specifies the amount of time, in seconds, after which the automated check is started. See Check for Updates.
autoDiffSupportbooleanfalseAutomatically activate change detection
autoSaveInterval-1000000-1000000 (number of operations; negative means disabled)-300Max. modifications before saving
autoSaveTimeout10-86400 (number of seconds)30Idle time (seconds) before saving
autoSelectAttributenever, placeholder or requiredplaceholderAutomatically select an attribute
autoSpellCheckenumeration (never, always, seeConfig)seeConfigActivate if this is specified in the configuration file
button2PastesSystemSelectionbooleanfalseClicking with middle button pastes system selection
charsSavedAsEntityRefsspecification as in Always save these characters as entity referencesempty stringAlways save these characters as entity references
copyDocumentTemplatebooleanfalseImmediately save newly created document
defaultBackground3 0-255 integers separated by spaces (specify red, green, blue)255 255 255Default background
defaultFontIsSerifbooleanfalseDefault font family
defaultFontSize8-24 (pt)12Default font size
defaultForeground3 0-255 integers separated by spaces (specify red, green, blue)0 0 0Default text color
documentCacheinteger between 0 and 5000. Specify 0 to disable the cache.100Document cache
dontIndentUnconstrainedDocsbooleanfalseDo not indent unconstrained documents
encodingany encoding supported by Java™ or "ORIGINAL_ENCODING"UTF-8Encoding
ensureSaveFileHasExtensionbooleantrueEnsure that a save filename has an extension
selectedFeatureslist of feature names (OpenFolder, IncludeTool, etc), separated by newline charactersAll features except DeveloperTools and DocumentCacheTool.Section 5.11.1, “Features Options”
filterDuplicateIDsbooleantrueFilter duplicate ID errors found in modular documents
fontSize8-24 (pt) or -1 (means: system's default)-1Font size
ftpProxyHosthost name or host addressnoneFTP proxy
ftpProxyPortinteger80(FTP proxy) Port
guessIgnorableWhitespacebooleantrueWhen no DTD or schema, guess ignorable white space
headerBegin [footerBegin]textempty [%F]Begin
headerColor [footerColor]3 0-255 integers separated by spaces (specify red, green, blue)128 128 128 [128 128 128]Color
headerEnd [footerEnd]textempty [%P]End
headerMiddle [footerMiddle]textempty [empty]Middle
helperApplications.entriesstringsee File typesFile types

The format of this string is:

entries --> ( entry ('\n' entry)* )?

entry --> mime_types ':' extensions ':' 
          magic_strings ':' 
          xml_name_patterns ':' 
          command

mime_types --> ( mime_type (',' mime_type)* )?
extensions --> ( extension (',' extension)* )?
magic_strings --> ( magic_string (',' magic_string)* )?
xml_name_patterns --> ( xml_name_pattern (',' xml_name_pattern)* )?

In any of the above fields, 
character ':' must be escaped using "\072"
and character ',' must be escaped using "\054".

magic_string --> HEXADECIMAL_NUMBER

xml_name_pattern --> ( '{' namespace_URI? '}' )? local_part
One of local_part or namespace_URI 
may be equal to "*".
helperApplications.defaultViewerstringsee Default viewerDefault viewer
httpProxyHosthost name or host addressnoneHTTP proxy
httpProxyPortinteger80(HTTP proxy) Port
httpsProxyHosthost name or host addressnoneHTTPS proxy
httpsProxyPortinteger443(HTTPS proxy) Port
indentinteger (negative means not indented)2Indentation
ignoreStyleSheetPIbooleanfalseIgnore <?xml-stylesheet?>
infoAboutReadOnlyInclusionsbooleantrueInform about non-editable document parts
imageViewportModeimage, thumbnail or boximageDisplay images
localelanguage (e.g. fr) or language_COUNTRY (e.g. fr_CA) or - (means default)-Locale
lockLocalDocumentsbooleanfalseLock documents stored on the local filesystem
lockModeshared, exclusive or noneexclusivePreferred lock mode
lockOwnerstringempty string which implies user_name@host_nameIdentifier as a lock owner
lockTimeoutinteger (number of seconds)86400 (that is, 24 hours)

After specified number of seconds, a lock is to be automatically removed by the server (typically WebDAV) hosting the locked document.

A negative or null value may be used to create locks which should never expire.

Note that there is no need to create permanent locks as XXE automatically “refreshes” the lock each time the locked document is being saved.

One notable exception is Subversion, which when used through WebDAV, does not support locks having a finite lifetime.

This user preference cannot be specified using the GUI of XXE. You need to use the -putpref command-line option for that.

lookAndFeelClassNameJava™ class name of a PLAF or - (means default)-Style
makeBackupFilesbooleantrueBefore saving, make a backup copy of the file
maxLineLengthpositive integer78Max. line length
maxUndo1-10020Max. undo actions
monospaceFontFamilyfont family nameMonospacedMonospaced font family
nonProxyHostslist of host names, host addresses and domain names (e.g. .acme.com) separated by spaces"localhost 127.0.0.1"No proxy for
onlyShowSuggestionsbooleanfalseIn the choice list, only show suggestions
onUpdateDocumentSetone or more of transclude, redraw, validate separated by commasvalidateSection 5.2.1, “Document Set options”
overrideConfigurationbooleanfalseOverride settings specified in config. files
proxySettingsnone|system|applicationsystemUse system settings
quickStartCachebooleantrueQuick Start cache
reopenLastOpenedFilebooleanfalseAutomatically reopen last opened document
saveCharsAsEntityRefsbooleantrueSave characters outside encoding as entity references
schemaCacheinteger between 0 and 100. Specify 0 to disable the cache.10Schema cache
screenResolutionWhenPrinting50-100 (Dot Per Inch)100Screen resolution
sansSerifFontFamilyfont family nameSansSerifSansSerif font family
serifFontFamilyfont family nameSerifSerif font family
showBothViewsbooleanfalseShow both tree and styled views
showValidityPaneOnSavebooleanfalseAutomatically show Validity tool
singleInstancebooleanfalseUse a unique instance of XMLmind XML Editor
singleInstancePort1-6553549987Port
socksPasswordencoded stringthe empty string(SOCKS) Password
socksProxyAuthenticationbooleanfalseAuthenticate SOCKS user
socksProxyHosthost name or host addressnoneSOCKS proxy
socksProxyPortinteger1080(SOCKS proxy) Port
socksUserstringthe login name of the user(SOCKS) User name
spreadsheetAutoRecalcbooleantrueOpen spreadsheets in auto-update mode
spreadsheetMaxIterations2-200020Maximum number of iterations allowed for calculations in spreadsheet
treeViewAtRightbooleanfalsePlace tree view at right
treeViewFontsAndColors(without a space after ';') "markupFont; textFont; verbatimTextFont; backgroundColor; readOnlyColor; markupColor; elementNameColor; attributeNameColor; attributeValueColor; textColor; commentColor; piColor; textBorderColor; commentBorderColor; piBorderColor"(without a space after ';') "SansSerif-Bold; SansSerif; Monospaced; ffffff; e0f0f0; 808080; 8b008b; 008b8b; 00008b; 000000; 8b1c62; 006400; f0f0f0; ffe0e0; e0ffe0"Fonts and colors
treeViewFontSize8-24 (pt)12Base font size
treeViewShowAttributebooleantrueShow attributes
treeViewShowCommentbooleantrueShow characters in comment nodes
treeViewShowPIbooleantrueShow characters in processing-instruction nodes
treeViewShowTextbooleantrueShow characters in text nodes
treeViewPercent10-9033Tree view width
underlineHeader [overlineFooter]booleantrueUnderline [Overline]
updateInclusionsOnSavebooleantrueAutomatically update references in modular documents
useHelperDocumentTypebooleantrueWhen no DTD or schema, simulate a DTD
useNativeFileChooserbooleantrue on the Mac, false on the other platformsUse the native file chooser in preference to the multi-platform file chooser
useURLChooserbooleanfalseUse the URL Chooser
verticalSplitbooleanfalseSplit Windows Vertically
warnAboutAdvancedXIncludebooleanfalseWarn about advanced use of XInclude
warnAboutCorruptedEditSessionbooleantrue

When the change detection has been activated for a given document and this document is modified outside XXE, the <?xxe-serial-numbers> processing-instruction which allows to use the Compare tool to compare two revisions of this document, becomes out of sync with the contents of the document. When this is the case, a warning dialog box is displayed informing the user that the <?xxe-serial-numbers> processing-instruction had to be recreated from scratch.

When this preference key is set to false, the warning dialog box (which may “frighten” the user) is not displayed.

This user preference cannot be specified using the GUI of XXE. You need to use the -putpref command-line option for that.

wrapLongWordsbooleanfalseWrap words wider than available space