Advanced Spintax

Advanced Techniques: Spintax

The Empty Phrase

whirlDOC supports an "empty" phrase in spintax. When it is enabled for a phrase set, spintax can resolve to one of the set’s phrases or nothing. It is useful when adjectives are turned into spintax because adjectives can often be omitted without changing a sentence’s meaning. The following steps demonstrate how a word can be turned into spintax with an empty phrase so document variations can randomly leave the word out of the sentence.

Steps to enable the empty phrase

All third party tools might not accept empty phrases in spintax. If spintax will be retained in document variations so they can be fed into third party tools then the check the capabilities of the third party tools before using empty phrases.

Spintax and Articles

A common situation with spintax is the articles, like "a" and "an", not matching all of a spintax segment’s phrases. The following example demonstrates how a spintax segment is created and testing reveals it causes a grammar mistake. The phrase set for the spintax is then edited to include the proper article in front of each phrase. The article in the document before the spintax is then deleted.

Steps to handle articles with spintax

Complex Adding of Spintax

The introductory tutorial demonstrated new phrase sets being created by selecting document text then typing synonym phrases into the spintax panel. This section shows how phrases can be added by making additional text selections. It also demonstrates how "Find Phrases" may highlight text in the document that should not be converted to spintax. A highlight can be left clicked to remove the highlight. Right clicking will remove all highlights except the one that is clicked.

Steps for complex adding of spintax

Deleting Spintax

The "Delete Spintax" button at the bottom of the spintax panel converts marked spintax to plain text. The steps below show a spintax segment being left clicked to mark it. All other segments that use the same phrase set are marked as a result of clicking. Segments that should not be deleted are left clicked to remove their marks. Finally the remaining segment is converted to plain text.

Steps to delete spintax

This example shows the use of left clicking. Deleting is often easier when right clicking is used. While left clicking on a spintax segment will mark all segments that use the same phrase set, right clicking will mark only the segment clicked.

Using Document Folding

Clicking the icon of a document element will fold the element by contracting it so it is represented by just its first line. The folded section will be shown in light yellow. Content within the fold is protected from changes by most spintax tools, like "Delete Spintax", "Create Spintax", "Find Phrases", and "Magic Find". This protection is used in the following steps to make deletion of a single spintax segment easier. The example is mainly for demonstrative purposes because right clicking could be used to mark only the one spintax segment to be deleted.

Steps to delete spintax with folding

Using Auto Magic To Add Spintax

The "Auto Magic" function automatically adds spintax to an entire document by searching the "master," "user," and "document" thesauruses for text in the document. This is essentially like repeatedly using "Magic Find" and "Create Spintax" until no more text can be found to convert to spintax. The steps below demonstrate this.

Adding spintax with auto magic

Since "Auto Magic" operates without user intervention, there is no control over phrase sets used to convert text to spintax. If more than one phrase set is found for a phrase in the document then one is selected and it might be unsuitable, grammatically incorrect, or nonsensical for the sentence that will contain the spintax.

Step three above demonstrates this. The original text "fell" has been replaced with the spintax phrase set "{dipped|dove|dropped|fell|plunged}". These synonyms do not really match the original use of "fell". The sentences are still grammatically correct, but there are other cases where the result may be incorrect or nonsensical. For this reason "Auto Magic" is best used when the spun documents are meant to be read by software rather than humans. For example, documents that are not grammatically correct or somewhat nonsensical might be used for search engine optimization.