Home » Groups TextSoap

Cleaner Groups

Groups

A group is a collection of cleaners. Groups provide a way to gather and organize cleaners for a specific task or project. There are two types of groups: built-in and custom. Built-in groups cannot be edited by you, but custom groups can.

Within a group, you specify which cleaners are included and their order. The cleaners in a group can be any of the built-in cleaners or any custom cleaners you have created.

TextSoap includes a number of built-in groups:

- Library - A list of all the cleaners available in TextSoap.
- :Standard - A list of the more commonly used cleaners plus custom cleaners.
- :Basics - A list of the more commonly used cleaners.
- :Email - A list of cleaners useful in dealing with emails.
- :Typographical - A list of cleaners for handling typographically related text processing, such as Ellipsis, Em Dash or En Dash conversions.
- :Case Conversions - A list of cleaners related to change text case.
- :Text Quoting - A list of cleaners to help when quoting various text.
- :Remove Extraneous - A list of common cleaners used when removing extra characters.
- :Paragraph Rulers - A list of cleaners related to change paragragh ruler settings.
- :Markdown - A list of cleaners related to Markdown formatting.
- :HTML - A list of cleaners to work with raw HTML text. It includes cleaners that tag text with a variety of pre-defined HTML tags.
- :Plist - A list of cleaners to work with a PLIST, an XML format used by Mac developers.
- :Custom - A list of cleaners created by end-users.

Accessing the Group Editor

There are several ways you can get to the Group Editor Panel.

Via menu: Window > Customize Groups.

Via toolbar: Click on the "Edit Groups" button.

Editing Cleaners in a Group

The editor is separated into three panes. The leftmost pane is a list of groups. The center pane defines the selected group. The rightmost pane is the palette of cleaners available to add to your current group.

Select the group you want to work with using the leftmost pane.

To add a cleaner to a group, click on the name of the cleaner in the palette area. This palette area works just like the cleaner list in other areas of the app. You can type in a partial name or select any built-in group to filter the list of cleaners.

To remove a cleaner, select it, then click on the "-" button below the group items. (You can also double click the item to remove it).

To insert a label or spacer, select the cleaner you want to insert it before, then click on either "+ Label" or "+ Separator". The label or separator is inserted at the current position, pushing down any other items in that group. To edit the label, double-click it and rename it.

To colorize an item select it in the list, then click on the color button and use the color picker to select the color you want for the item.

To reorder items, select them, then click and drag them to their new location.