Options Dialog

This dialog lets you choose miscellaneous global settings.

How to Open This Dialog

Select File > Options.

General Tab

Auto-Reload Documents

Select this check box if you want Contributor to reload documents automatically.

Auto-Save Documents

Select this check box if you want Contributor to periodically auto-save any open files. You can specify the number of minutes that should elapse between each auto-save.

Close others when opening new document

You can have multiple files of all types open in the interface at the same. By default, when you open a new file, other documents that are already open remain open. However, you can change this behavior so that files already open in the interface are automatically closed when you open a new document.

You can use any of the following options:

  • Close others This option automatically closes all other open documents.
  • Close others with no changes This option automatically closes all other open documents that do not have unsaved changes. If you have files open where changes have been made but not saved, those files will remain open until you save and close them.
  • Close others with same extension This option automatically closes all other open documents that share the same file extension.
  • Close others with same extension and no changes This option is the same as the previous option, except that files with unsaved changes will not automatically be closed. Those files remain open until you save and close them.

Reset "Show Once" Dialogs

There are some dialogs in Contributor that open just once to give you a message or warning when something changes or you switch modes. These dialogs have a check box labeled "Show this dialog." If you deselect that check box, you will not see the dialog again. However, you can use this reset feature to display that dialog (and all other "Show Once" dialogs) again the next time.

Automatically resize low DPI images

Starting with Contributor 6, images with a very low DPI are rendered more accurately in the XML Editor (WYSIWYG) and PDF output, usually resulting in slightly larger and more blurry images (as is consistent with their lower DPI). Therefore, if you upgrade from an older version to Contributor 6 or higher, you might notice images that looked a certain size before now look larger and more blurry (because their true DPI is being rendered more precisely). The best solution, and a long-term one, is to replace your lower-DPI images with higher-DPI images to be used in print output. But you also have the option to revert back to previous version behavior. If you select this option, the newer, more precise resizing from newer versions of the software is used. If you do not select this option, the behavior of older versions is used.

Prefer Local Help

By default, Contributor's online and dynamic Help system points to files hosted externally. This allows for live updates to the Help.

Because the Help system is hosted online, you may not be able to access it if you are behind a firewall or if you have a slow connection. In that case, you can use a local version of the Help. Contributor will even switch to the local Help automatically if it detects that you cannot connect to the external Help system.

Select this option if you want to use the local Help manually.

Note The local Help system is only updated when the application is updated. If you want to be sure that you have the most current version of the Help, disable the local Help.

Interface Tab

Menu Style

You can select an option to display the interface with ribbons or with the classic tool strip. See Switching Between Ribbons and the Tool Strip.

Theme

You can click the Active Theme field and select a color scheme for the interface.

XML Editor Tab

Options

  • Enable Drag and Drop Text Place a check mark in this check box to enable the drag-and-drop feature. When enabled, you can highlight and drag text to move it within topics.
  • Show web images Select this check box to show or hide web-linked images in the XML Editor. If you have many image tags that link to websites, slow website response times may slow down your work. Therefore, you might want to disable the rendering of such images in the XML Editor.
  • Insert Empty Alt Text Select this check box to automatically add an empty alt tag to images when you insert them into a topic or snippet (unless you specifically add an alt tag to an image).
  • Replace straight quotes with smart quotes Select this check box to use single and double curly smart quotes instead of straight quotes when you type in the XML Editor. This option is disabled by default. See Using Smart Quotes.
  • Show style previews in UI When you attempt to apply a style to content using the Style drop-down in the Home ribbon, the Styles window pane, or the floating Style Picker, previews of the various styles are shown by default. This gives you an idea of how each style looks before you apply it to the content.

    If you prefer not to see style previews in these areas of the user interface, remove the check mark from this option.

    With this option disabled, all of the styles will be presented as plain text when you select them.

Text Rendering

  • Enable ClearType Font Smoothing Displays text in a "ClearType" font, which appears to "smooth out" the words and make them easier to read. ClearType is a software technology developed by Microsoft that improves the readability of text on existing LCDs (Liquid Crystal Displays), such as laptop screens, Pocket PC screens, and flat panel monitors. With ClearType font technology, the words on your computer screen look almost as sharp and clear as those printed on a piece of paper. ClearType works by accessing the individual vertical color stripe elements in every pixel of an LCD screen. Before ClearType, the smallest level of detail that a computer could display was a single pixel, but with ClearType running on an LCD monitor, we can now display features of text as small as a fraction of a pixel in width. The extra resolution increases the sharpness of the tiny details in text display, making it much easier to read over long durations.
  • Enable GDI+ Text Renderer Toggles between Microsoft Windows Graphics Device Interface (GDI) and GDI+ in terms of how content is rendered on your monitor. What is the difference between GDI and GDI+? The bottom line is that GDI+ improves the quality of the rendering somewhat, but it can be slower than GDI. For more information about GDI+, see:

    Copy
    http://msdn.microsoft.com/en-us/library/ms533797.aspx

Defaults

  • Paste Text Select the default behavior when pasting text from another program.
    • Paragraphs Paste the text as regular paragraphs.
    • Paragraph Block Paste the text as paragraph blocks, such as <div>, <blockquote>, or <fieldset>. For more information about these types of styles, see Creating Tag Groups.
    • Inline Text Paste the text as inline text, so that it takes on the style of the location where it is being pasted. If you have copied multiple lines of text from the source document and use this option, the text will be pasted in one line, not multiple lines.
    • Table Paste the text into a new table.
    • List Paste the text as a new bulleted list.
  • Link Select the default behavior when creating a link by dragging a file into the XML Editor—Cross-References (which are dynamically generated based on commands) or Hyperlinks (which are based on specific text you provide in the XML Editor).
  • List Select the default behavior when creating a new numbered or bulleted list. You can include <p> tags within each <li> tag (Paragraph), or you can just have <li> tags (Simple) but add <p> tags later manually for list items where you want them.
  • Definition List Select the default behavior when creating a new definition list. You can include <p> tags within each <dt> and <dd> tag (Paragraph), or you can just have <dd> and <dt> tags (Simple) but add <p> tags later manually for list items where you want them.
  • Cut Table Columns Select the default behavior when cutting columns in a table. You can choose to cut the entire Columns (including the contents) or just the Cell Contents.
  • Cut Table Rows Select the default behavior when cutting rows in a table. You can choose to cut the entire Rows (including the contents) or just the Cell Contents.
  • Merge Table Select the default behavior when creating or pasting a new table above or below and existing one. You can choose to keep the tables separate (Don't Merge Tables), or to merge the tables. Merge Table Up means the new merged table will use the style of the table on top. Merge Table Down means the new merged table will use the style of the table on bottom.
  • Merge List Select the default behavior when creating or pasting a new list above or below and existing one. You can choose to keep the lists separate (Don't Merge Lists), or to Merge Lists into a single list.
  • Paste Cells Into Tables Select the default behavior when pasting table cells that you have copied or cut.
    • Cells Paste the copied cells, replacing the cells nearest to where you have placed your cursor.
    • Table Paste the copied cells as a separate table. It will be placed within the cell where you have placed your cursor.
    • (Above) Paste the copied cells above the cell where you have placed your cursor.
    • (Below) Paste the copied cells below the cell where you have placed your cursor.
    • (Left) Paste the copied cells to the left of the cell where you have placed your cursor.
    • (Right) Paste the copied cells to the right of the cell where you have placed your cursor.
  • Table to Text Select the default behavior when converting a table to text.
    • Convert to Paragraphs Convert the content in each table cell into separate paragraphs.
    • Separate with Commas Convert the content in each table cell into text separated by commas.
    • Separate with Text Convert the content in each table cell into text separated by a text string that you specify (e.g., a semicolon).

Spelling Tab

Select Global Dictionary Location

A global dictionary is a file that contains words and can be used for spell checking by any Contributor file you open on your computer.

By default, a new global dictionary is stored in your AppData folder, like all of your built-in dictionaries.

However, you can select Use custom location to choose a different location for your global dictionary. For example, you might be working with a team of writers and want to make sure you are all using the same spellings for certain terms. By choosing a network directory, your entire team can use the same global dictionary. After selecting this option, click The browse ellipsis button opens to more options. to choose the location. See Choosing the Location for Global Dictionaries.

Installed Dictionaries

This section displays information about the dictionaries that are installed and therefore available to your files. You can import additional dictionaries if you want.

  • Language This column lists the names of all languages with dictionaries that are installed on your computer. Dictionaries are stored in your AppData Windows folder.
  • Code Displays the code for each language.
  • Spell Green dots indicate which dictionaries support spell checking.
  • Hyphen Green dots indicate which dictionaries support hyphenators. A hyphenator is used to automatically hyphenate words in an editor based on particular word patterns, as outlined in the dictionary file. (Hyphenators are important only for certain languages.) For more information about hyphenation patterns in different languages, see:http://www.tug.org/TUGboat/tb27-1/tb86nemeth.pdf
  • Thesaurus Green dots indicate which dictionaries contain a thesaurus. See Thesaurus.
  • Description This column provides a short description of each dictionary.
  • Import Dictionaries You can download more dictionaries from OpenOffice.org. After you download a new dictionary, you can install it by clicking this button. See Importing Dictionaries.

Spelling Options

You can use these fields to ignore any of the following when spell checking files:

  • Ignore repeated words
  • Ignore mixed case words
  • Ignore uppercase words
  • Ignore URLs
  • Ignore email addresses
  • Ignore words with numbers
  • Ignored styles If there are certain styles or classes in your stylesheet that you want to ignore when spell checking, you can enter them in this grid. For example, you might have styles containing code text that you do not want to be affected by a spell check.

  • Ignored conditions If there are certain chunks of content that are conditioned and you want to ignore them when spell checking, you can enter them in this grid (type the condition tag set, followed by a period and then the name of the condition). For example, you might have a condition that you use for content that is not yet ready for release. Content with this condition might have your notes and characters that you don't feel the need to spell check.

Language Tab

Hide languages with no spell check support

This filters the list of languages to show only those that are supported with the spell check feature.

Language

You can select a language.

Keyboard Shortcuts Tab

Command Scope

Select whether the custom shortcut will be available throughout the interface (Global) or just in the XML Editor. The options available on the tab change depending on your selection. See Changing Hot Keys.

Note If you set one shortcut with XML Editor selected and another with Global selected, the XML Editor shortcut has precedence.

Option/Shortcut

Select the option whose hot keys you want to change. You can click the Option or Shortcut column headings to sort the columns alphabetically. This can help you more easily find a command or see which shortcut keys are free to use.

Key Assignment

Select the hot key that you want to assign to the option.

Other commands using shortcut

If you create a shortcut that is already being used, this field displays the conflicting command.

Modifier Key Assignment

You can select the Control Key, Shift Key, and/or Alt Key check boxes if you want to use a combination for the shortcut. For example, if you select D from the list to the right and add check marks to the Shift Key and Alt Key boxes, the new shortcut for the option will be SHIFT+ALT+D.

Unlisted Commands

You can assign a hot key to a command that does not appear in the grid above by clicking Unlisted Commands. In the Other Commands dialog, select a command, then click OK. The unlisted command appears in the grid.

Reset to Factory Defaults

This returns the tab to the factory default keyboard shortcuts.

Index & Concepts Tab

Auto-complete Index and Concept entries

As you enter index keywords in the Index window pane, the application recognizes if you have created a similar index keyword. The similar keywords appear in a list just below the entry field. You can quickly select one of the keywords from the list instead of typing the entire word manually. This option turns this feature on and off.

Mode Warnings for Index and Concept Entries

If you turn on the Index Entry Mode or Concept Entry Mode and then close the application, you will receive a warning message the next time you open the application. The message lets you know that the mode is still on. You can disable the warning messages from that dialog. This option lets you turn those warning messages on again:

  • Check mode and display this dialog when first topic opened You can avoid seeing the Mode Warning dialog in the future by not selecting this option. However, this does not mean the mode will automatically be turned off for you. It simply means that you will not be warned.
  • Auto-switch to normal selection mode on launch Select this option if you always want the application to disable the mode automatically when you open the program in the future. You can always turn the mode on again manually.
  • Continue in mode The "Index Entry Mode" or "Concept Entry Mode" will continue to be enabled after this dialog is closed. You can turn off the mode manually by right-clicking in the topic and selecting the mode.

Review Tab

User Name

When you first install and launch Contributor, your login user name is captured and stored in the Options dialog (File > Options). You can change the user name (for Contributor purposes) in this field. See Changing Your User Name and Initials.

Initials

The first two letters of the user name are also stored as your initials. This information is employed whenever you use the track changes and annotations features. For example, if you insert an annotation in a topic, your initials are displayed at the beginning of the comment so that other users know where the annotation came from. You can change your initials in this field. See Changing Your User Name and Initials.

Tracked Change Display

You can change the way tracked changes are displayed in the interface. See Changing the Display of Tracked Changes.

  • Display all changes in balloons If you select this option, all changes—text and formatting—will be shown in balloons in the sidebar.

  • Display only format changes in balloons If you select this option, changes that include content only (or content plus formatting) will be shown inline. But changes that contain formatting modifications only will be shown in balloons in the sidebar.

  • Display all non-format changes inline If you select this option, all text changes will be shown inline. Balloons are not used.

  • Change Bar Select whether or not you want to turn on change bars. If you turn on change bars, a bar appears on the left side of the line where a change has been made.

User Colors

The tracked changes and annotations for each user can be shown in a separate color. You also have the option of choosing a specific color for all users. See Changing the User Color for Reviews.

  • Use a different color for each user Select this option if you want Contributor to automatically assign a different color for each user.

  • Use the following color for all users Select this option if you want all changes, regardless of the user, to display in the same color. After you choose this option, click the down arrow below to select a color.

Plugins Tab

Name

Displays the name of the plugin, based on the DLL file you have created and added to the Contributor installation folder in Windows. See Plug-In API.

Description

Displays a description of the plugin.

Version

Displays the version number of the plugin.

Enable/Disable

Click Enable to install the plugin, then restart Contributor. Click Disable to uninstall the plugin.