2.2  The Settings Tab

You use the Settings tab of the Bookmarkshelf window to configure its behavior.

Like the Bookmarks Content, these behavioral settings are part of the Bookmarkshelf’s data, and respond to Undo, Redo, etc.

The Settings tab is organized into six sub-tabs, each of which is described in this page.

       Topics on this Page

2.2.1  General Tab

Tag Delimiter

A Tag Delimiter is the character that you type when you are typing in tags to signal the end of one tag and the beginning of another tag.  Note that the Tag Delimiter can therefore not be used within a tag.  The setting in this pane is the setting for this document, but note that there is also a “default default” Tag Delimiter set in the Preferences window.

By default, visit bookmarks with:

Here, you set the browser that is used when you command BookMacster to Visit a bookmark.  Note that this is a default setting which can be overridden in the Inspector for any individual bookmark.

Ignore duplicates in different top-level Hard Folders

This control is one way in which you can allow certain duplicate bookmarks to exist without being reported as such.

New Bookmark Landing

This control sets the landing for new bookmarks created by the created by the BookMacsterize bookmarklet.

Comments

At the bottom, this is a text field into which you can type whatever notes might help you in working with this Bookmarkshelf.

2.2.2  Sorting Tab

In the Sorting tab, you configure how sorting should be done, whenever sorting is done.  This tab is not for configuring when sorting is done, nor for initiating a sort manually.  (The latter is done simply by clicking in the menu DocumentSort All).

2.2.3  Structure Tab

In the Structure tab, you define the Structure of your Bookmarkshelf, which is the presence of various Hard Folders, and what is allowed at Root.

If you are using BookMacster independently of your web browsers, as in Usage Style 3, you may set Structure arbitrarily to your liking.  Since you’re never going to see a Bookmarks Bar, Bookmarks Menu, etc. it would make sense to

and then you can skip reading the rest of this section!

However, if you intend to access bookmarks from within your web browser Clients, doing regular Import and Export operations (Usage Style 1 or Usage Style 2), you’ll want to structure your Bookmarkshelf to minimize the amount of remapping which must be done to make the items in your Clients fit into the Bookmarkshelf, and vice versa.

If your Bookmarkshelf supports only one Client (Usage Style 1), it’s also pretty easy.  Just set the Structure to exactly match that of your Client.  As a matter of fact, when you create a New Bookmarkshelf with only a single Client, BookMacster does this for you automatically.

But if you’re supporting multiple different Clients (Usage Style 2), your Structure must be a compromise between the structures of your different Clients.  There are two logical solutions to the problem.  The first solution is to structure the Bookmarkshelf so that it can directly map any item that any Import Client can throw at it.  The second, potentially more restrictive solution, would be to require that the Bookmarkshelf be structured so that anything that the Bookmarkshelf can throw out can be directly mapped, where thrown, by all Export Clients.  When you create a New Bookmarkshelf with multiple Clients, BookMacster executes the first logical solution for you automatically, according to this algorithm.

2.2.4  Open/Save Tab

Note that the settings in this tab are not kept in the .bkmslf document.  Instead, they are Local Settings.

Open after BookMacster launches

Open this document after BookMacster launches is probably what you want if you intend to keep all of your bookmarks content in a single Bookmarkshelf.

Auto Import

If this box is checked, the document will Import from its Import Clients immediately upon opening.  This is useful if you would like to keep the document in sync with its Import Clients, without having to remember to Import whenever you open it, for those who prefer Usage Style 1 or Usage Style 2.

Sort

You can set a Bookmarkshelf to perform a Sort operation immediately upon opening.

Find Duplicates

You can set a Bookmarkshelf to perform a Find Duplicates operation immediately upon opening.

Auto Export

If this box is checked, the document will display a sheet prior to saving or closing if there are unexported changes, giving you a default option to Export to the active Export Clients first.  This is useful if you would like to keep the Export Clients in sync with the document, without having to remember to Export.  This is useful if you would like to keep the document in sync with its Export Clients, without having to remember to Export whenever you save it, for those who prefer Usage Style 1 or Usage Style 2.

Auto Export only occurs Save operations that are commanded manually.  Save As operations, Save As Move operations, Auto Saves by Mac OS X 10.7 or later, and Save commands executed by an Agent Worker or AppleScript command will not cause an Auto Export.  (Auto Export upon closing prevents unexported changes from not being exported without your approval in Mac OS X 10.7 or later.)

Overriding Settings

In troubleshooting situations, the actions required by the settings described above can be overridden by using one of BookMacster’s secret tricks.

2.2.5  Clients Tab

Note that the settings in this tab are not kept in the .bkmslf document.  Instead, they are Local Settings.

In the Clients tab, you set what will happen when you execute an Import or Export command.  Most importantly, you list the clients whose content will be imported from during an Import and exported to during an Export.

Client Popup

Next is a popup menu in which you select the desired Client.  Clients found on your Macintosh User Account are listed explicitly.  Otherwise, you can click one of the special menu items at the bottom:

After clicking one of these special items, appropriate dialogs will appear for navigation, account or application identification, and/or authentication as required.

Warning to power users: Do not use the Choose File advanced feature if you simply want to access the bookmarks of a locally-installed app.  Doing so will make browser-related triggers unavailable and bypass checking to see whether or not a browser is running when later executing an Import or Export.  To set, for example, your Safari bookmarks as a Client, for example, simply click “Safari” in the popup menu.

Import and Export Checkboxes

For normal syncing of bookmarks, leave both the Import and Export checkboxes switched ON.

If you don’t want bookmarks changes from the Client to be synced to BookMacster, other Clients, other Macs, etc. then switch off Import.  If you don’t want the Client to get bookmarks changes from BookMacster, other Clients, other Macs, etc. then switch off Export.  In either case, you’ll probably also want to change some of the Advanced Settings…

Advanced Client Settings

Mapping data such as bookmarks from the format used by one application (Client) into that of another always involves decisions and often compromises, which we call remapping.  BookMacster tries to handle these in the way you expect, and usually the default results are satisfactory.  But BookMacster provides many controls for those who want to more precisely set the behavior of Import and Export operations.  They are available in two contexts…

Per-Client Contexts

To the right of each Client listed in Settings ▸ Clients tabs is a small button with a gear icon.  Clicking this button displays a sheet of the Advanced Settings for that particular Client.  In the sheet, you’ll see sub-contexts Import, Export and Special in which the settings are applied.  The Special subsection is for settings which are only applicable to a certain Client type, and therefore will not be shown for all Clients.

Import Postprocessing Context

Besides making adjustments during an Import operation for each Client, a few adjustments, for example Delete Unmatched Items, cannot be performed until after all Clients have been imported.  You can set the parameters for these adjustments by clicking the larger button with a gear icon nearest the top of the Settings ▸ Clients tab.

Reordering Buttons

By clicking the up and down triangles at the far right, you can arrange the order of which Clients’ imports and exports.  This may make a difference when bookmarks content is imported.  For example, if two Clients each have a bookmark with the same URL, and are set to merge by URL, which of the two is actually imported is affected by which one is imported first.  (Note that BookMacster normalizes URLs.)  For Export operations, however, because exporting does not affect the Bookmarkshelf’s content, the order of Clients does not matter.

2.2.6  Agents Tab

The Agents tab is used to add, configure and delete Agents, with its Commands and Triggers, but in the Simple view, you don’t see them.  Checking boxes ON will create one or two Agents, pre-configured to do what most people want.

If you would like to see precisely what triggers the Agent you have created, and exactly what it does, and possibly change its behavior slightly, you may switch to the Advanced view.

By default, the Simple Agents subtab is displayed.  This tab allows you to configure BookMacster agents for sorting and syncing as most users want.  Users who desire more (or less) may configure Advanced Agents.

Note that the settings in this tab are not kept in the .bkmslf document.  Instead, they are Local Settings.