How To Create Shortcuts

Radio is a tool for creating weblogs. Duh. But in its current version, Radio partly hides that power 'under the hood' of the processing engine - not to keep the power from us but so we don't feel we have to become an expert mechanic when we would rather just turn the ignition and drive.

The Shortcuts feature (accessible from the Radio Menu at the top of any local weblog page) allows you to create names or labels that are associated with longer names, texts, links, images (or just about anything you want). Then, when you enter the label into a weblog or a story, Radio will automatically substitute the associated content for the label.

To Create A Shortcut

1. Go to the Shortcuts page by clicking on the Shortcuts selection from your Radio Command Menu.

2. Enter a Name and a Value for something that you would like to use as a shortcut.

In the screen above, I have entered the name 'Back Up' and a phrase that I want to associate with that name. Notice that Radio gives us the same text entry area that we use to create weblog posts or stories. You could - if you wish - embed an entire post or story as a shortcut.

I have created a link here that will take my readers to a topic on backing up Radio files. (My reason is that I periodically suggest a backup, so why not save myself some keystrokes as well as having to construct a link over and over again to the same topic?)

3. When you are satisfied with your shortcut, select the 'New Shortcut' button under the text entry area. That's it. Done.

Browsing, Editing and Deleting Current Shortcuts

You can inspect and manage your shortcuts on the same page in Radio. The screen below shows my current shortcuts immediately after I entered the 'Back Up' shortcut.

To delete a Shortcut, click on one or more of the checkboxes to the left of a shortcut. Then, select 'Delete'. You won't be asked to confirm your choice so make sure you want to delete a Shortcut before you do so.

To edit a Shortcut, just click the edit button to the right of the Shortcut of interest. This will reload the Shortcut into the text entry area just as it was when you first created it. Just repeat the steps I gave you above for creating a Shortcut and reselect 'New Shortcut' when you are done editing.

Setting Shortcut Preferences

Did you notice that my current Shortcut list displays several titles of stories that I have written and then a link to that story? Take a look at 'How To Buy Radio' and its link to the right.

By default when you first install the product, Radio will create Shortcuts automatically for every story and every weblog post that contains a title.

You can specify your own preferences for managing Shortcuts:

1. Select the Preferences link from your Radio Menu. Then click the 'Shortcuts' option within the Weblog section of the Preferences page. (Your Weblog section may look somewhat different as Userland adds or removes preferences).

2. At first install, Radio checks all three of the boxes shown below:

Since I am not using an earlier version of shortcuts, I unchecked the third box as per Userland's recommendation. You will probably want to do the same. Userland provided this feature as a default courtesy to earlier customers to ensure backward compatability for their work.

Micro-Tip: When You Don't Want Your Shortcut to .... Shortcut

Remember the way that you call for the subsitution of a Shortcut in your application by enclosing it in double quotes like so?

"Back Up"

Whoa! Wait a minute! When I enclosed the word 'Back Up' in double quotes (not single quotes as here), Radio saw that as a signal to substitute the associated text I had assigned to that shortcut. But what if I want to display the shortcut text just as text, not for substitution?

The way to do this is to enclose the Shortcut as follows: \"Back Up\" 

So, by entering the word 'Back Up' with the slash-quotes, the final result is ...

"Back Up"

(Alternatively, just enclose a Shortcut in single quotes or no quotes at all .... so, 'Back Up'.