Xtreeme SiteXpert Help - Suffix Builder

Contents / Site map Creation Process / Layout Wizard / Suffix Builder (for Descriptions)

Suffix Builder (for Descriptions)

Fig 1. Suffix Builder window

Suffix Builder for Descriptions is tightly connected to Layout Wizard. Each time Layout Wizard finds an item to be included in the layout tree (an HTML page, for instance), it sends this item to Suffix Builder for processing. Suffix Builder consists of a set of rules that define when and how each item should be processed. Each rule has two parts:

text suffix (prefix or postfix) that determines WHEN the rule should be activated. If the item being processed starts or ends with this text, then the rule will be activated. If this text is empty, the rule wil be activated for every item. For example, if this text is: 'key' (prefix), then the rule will be activated for all of the following items: 'keyboard', 'key', 'Key Item'. It won't be, however, activated for: 'house key' or 'the key' since 'key' is not the first part of text. Please note that this text is not case sensitive.

text suffix (prefix or postfix) that determines HOW the rule should be applied to the item. If an item matches the rule, this suffix will be inserted before or after the original item text. So, if this suffix is set to 'This is my ' (as prefix), then after processing by Suffix Builder, above items will be added to the layout tree in the following form: 'This is my keyboard', 'This is my key', and 'This is my Key Item'.

Although adding suffixes can be useful, Suffix Builder is usually most helpful for REMOVING sufixes. Very often titles of pages on many websites include name of the company or web site, eg:

Xtreeme GmbH - Products
Xtreeme GmbH - Services
Xtreeme GmbH - Customer Support

To avoid manual modification of such items, all you need to do is add the following rule to Suffix Builder:

Apply the rule when text starts with: 'Xtreeme GmbH - '
Add the following prefix to item text: '<15'

The text '<15' is one of the special suffixes. It means that instead of adding a suffix, the first 15 characters should be removed from item's text. You may use one of the following special suffixes:

'<N' - remove first/last N letters from item text
'>' - clear item text
'#' - don't include this item in layout tree

It's important to realize that many rules can be applied to a single item. So, for example if you want to change all items named 'Index Page' to 'My Index', first add a rule that clears item text, and then a rule that adds 'My Index'. Of course, both rules must be applied only to items starting with 'Index Page'.

The last special suffix ('#') is very useful when navigation mode is used. Sometimes there might be broken links and Layout Wizard tries to find these URLs. Usually an error status (404) is returned. Still, some web sites have custom pages notifying of an invalid URL. Normally Layout Wizard thinks these are regular pages and includes them in the layout. With Suffix Builder you can tell Layout Wizard not to insert pages with certain descriptions into the layout tree. For example a rule applied when text starts with 'Sorry, this page', and adding the '#' suffix will fix this problem. Such page will never appear in the layout tree.

Please note that order of rules in the rule list can make a huge difference since rules are applied in the specified order. Use the up and down arrows to change the order.