Document Settings

Document Settings

Document settings control various features of a document and are saved within a document. When a new document is created, its initial settings are taken from the application preferences, so if documents typically use the same settings then the preferences can be changed so future documents will start out with the desired settings.

Settings are changed with the document settings dialog, which is popped up with the "Document Settings…" item on the application’s "Document" drop down menu. Click the options desired then hit "Apply" to change the settings within the document.

HTML Settings

The HTML settings control how special characters and paragraphs are handled when spinning the document. These options are useful when spun variations are meant to be incorporated in HTML. These settings apply not only to writing document variations to disk with "Whirl" and "Quick Whirl" but also to testing, which puts an example variation in the test pane.

The "Whirl" dialog has the capability to change its spinning behavior to be different than a document’s settings. It has an "Advanced" tab that has options initialized with the document’s settings. The options can be changed to alter how the document is spun. Changing the advanced tab’s options does not change the settings stored within the document.

The settings tab for HTML compatibility is shown below.

Document HTML settings dialog

HTML Character Codes

This section controls how characters with a special meaning in HTML are handled. Checking an option will cause that special character to be written as the HTML code used for displaying the character as content instead of interpreting the character as part of the HTML code. The following table shows the options, their special characters, and the HTML codes that will be generated during spinning.

AMP & &
QUOT " "
LT < &lt;
GT > &gt;

For example, consider this fragment of text:

The professor said, "5 < 8."

If the "QUOT" and "LT" options are enabled then the text would be spun as:

The professor said, &quot;5 &lt; 8.&quot;

Paragraph Style

There are two paragraph styles: plain text and HTML. Plain text paragraphs are separated by a blank line. HTML paragraphs are enclosed in HTML "P" tags. For example, consider two short paragraphs of one sentence each. Plain text style paragraphs would be spun like this:

The first paragraph.

The second paragraph.

HTML style paragraphs would be spun like this:

<p>The first paragraph.</p>
<p>The second paragraph.</p>


Keywords are used by the keyword density tool, which is popped up with the "Keyword Density…" item under the application’s "Tools" drop down menu. That tool calculates the percentage of words in a document that are targeted keywords. It works by spinning hundreds of document variations and finding an average percentage for each keyword. The keywords panel of the document settings dialog is displayed below.

Document keyword settings dialog

For simple use, each targeted keyword should be entered in a text field on the dialog. Keywords can be single words or multiple word phrases.

It is often desirable to count variations of a keyword. This allows spintax to be used for keywords. It also allows for both plural and singular forms as well as forms of the keyword that may not be interchangeable synonyms suitable for spintax. For this purpose, variants of keywords can be entered and the keyword density tool will count occurrences of all variants.

To enter a set of keyword variants, type the targeted keyword in a text field then click the "Variants" button. A dialog like the one below will be displayed. Type one variant per line in the text area.

Document keyword variants dialog

The example above shows a set of variants for the keyword "zombies". The density tool will calculate a density using the number of times "zombies", "walking dead", and "undead" appear in spun documents.