|Last updated: 8/20/2002; 9:22:37 AM|
Marketing 101. Consulting 101. PHP Consulting. Random geeky stuff. I Blog Therefore I Am.Scotts Radio :: Missing Sections
Troubleshooting Your Radio Installation
Radio is a very sophisticated product and, although it usually installs correctly, there sometimes can be problems. Those problems are discussed below.
The most common problem people have after installing Radio is that their machine already has a web server installed. Radio has its own web server built in that, by default, wants to use port 80, the standard port for web servers. If your machine has a web server already that runs on port 80 then you will see this dialog box shown in Figure 3-5 when you start Radio.
<?xml:namespace prefix = v />
Figure 3-4. Dialog seen when web server already installed.
Radio needs a port. This can be any number from 1 to 65,535 but these are common choices:
The advantage to running Radio on port 80 is that it lets you access your weblog on your own machine without having to specify the port as part of the URL. Here are examples both ways:
http://127.0.0.1/ (port 80)
Getting Rid of Formatting
This technique only applies to using the WYSIWYG Editor under Windows using Internet Explorer. If you copy and paste text from another application such as Internet Explorer, Microsoft Word or PowerPoint, the WYSIWYG Editor pastes the text with the same formatting as the original.
To paste text without the formatting, use Notepad as a temporary buffer. Since Notepad doesn’t support formatting, pasting the copied text into Notepad and then copying it out of Notepad has the effect of retaining the text but losing the formatting. This will work with any ASCII editor, not just Notepad.
At the time of this writing, deleting categories is not easy in Radio and there are real issues with where your content goes when this occurs. The best approach is to think out the categories you need, in advance, and then create them. Rather than delete categories, you can always create new categories and assign existing posts to them by editing the post and changing the category.
Radio Tips and Tricks
Every software product has a few (or sometimes more than a few) “gotchas”those little things that trip you up from time to time. Here are some tips on Radio gotchas and how to address them. Please note that Radio is regularly updated and these problems may not exist in your copy of Radio.
This document could not have been written without the wonderful assistance gotten from the whole Radio community. My thanks go out to the following people who contributed to this document. They arent listed in any particular order so please dont read anything into this.
q Guy K. Haas
q Frank Steele
q Andy Fragen
q Steve Zellers
q Greg Kucharo
q Mike Cohen
q Rowan Brewer
q Paolo Valdemarin
q Mark Yeager
q Chris Janton
q Andrew Sylvester
q Roger Turner (who did such a fantastic job that I have to thank him again and again and again).
q Lawrence Lee
q Jake Savin
q Dave Winer
q Robert Barksdale
q Russ Lipton
q Eszter Hargittai
q Robert Occhialini
q K. Dadamo
q Philip Wolff
q David Davies
q Buzzy Bruggeman
q Justin Klubnik
q Mike Krus
q Eric Albert
q Jeff Cheney
q Kjartan Mannes
q Simone Bettini
If I have left anyone out, please let me know and Ill be happy to add you to the list.
Gotchas Affecting Both Mac and PC
Ctrl-A, Ctrl-C Is Your Friend
When you write anything in Radio you are working inside a web browserthe Radio Desktop Website concept. Web browsers aren’t like a word processor. Even though you can format content and add pictures and such, don’t think that Radio is a word processor. Here’s the difference: Web browsers lose data all the time. We have all seen thisfill out a web form, submit it and, for some unknown reason, your form isn’t posted. Normally this is more annoying than serious. In Radio it can be a disaster. Here’s an example. You’re writing a long post or story and you go to publish it. If that publish action isn’t 100% perfect, you can lose everything you wrote. This may not seem like a big deal, at least until it happens to you. My recommendation is that before you ever publish anything in Radio you press two keystrokes: Ctrl-A (select all) and then Ctrl-C (copy). This copies everything you just wrote to the clipboard. If you have any problems publishing your work then you can always create a new post or story, paste it in and try again. This is a bit difficult but needs to be a habit that you train yourself to do consistently.
NOTE: This is more needed on Radio for Windows due to the use of the Internet Explorer rich editing control. This control DOES NOT retain information on back tracks so if you have problem posting, you can’t backtrack to it. On a Mac (or if you aren’t using the rich editing control) this isn’t a problem.
NOTE: I refer to this as a “Condom” against losing data.
Practice safe blogging; Use Your Condom!!!.
When Radio Won’t Post
Periodically you may find that no matter what you do, Radio simply will not publish your work. Nothing happens when you click the Post to Weblog or Publish & Post buttons. This generally indicates that Radio has crashed even though it may appear to still be running (i.e. the Radio icon still shows up in the Windows system tray). Please note that one thing that can cause this on the Mac is a DSL or cable modem connection that goes down for only an instant and then comes back up. As Radio is a very network centric application, this apparently affects it seriously enough to need this option. Restarting the computer lets Radio run again but it will lose any unsaved data.
Here’s how to troubleshoot this and correct it on a PC running Windows NT, 2000 or XP.
Right click the Radio icon in the Windows system tray and select Exit and Shut Down Radio.
Re-Launch Radio and try publishing again. If this fails, proceed to step 3.
Press Ctrl-Alt-Dell and select Task Manager from the list of options. Task Manager lets you see what programs are running and shut one down when it has crashed. The Windows task manager is shown in Figure 3-xx.
Figure 3-xx. Task Manager
Click on the Processes Tab. Radio is considered a process not an application.
Click on the leftmost column, Image Name, to sort the list of processes by name.
Scroll down until you see Radio.exe.
Right click it and choose End Process from the menu. This will close Radio. You should now be able to re-launch Radio and publish without any problems.
Here’s how to troubleshoot this and correct it on Macintosh running OS X.
From the Apple menu, choose the Force Quit command or press Command-Option-ESC. This displays the Force Quit dialog box.
Select the Radio application and choose Force Quit.
Confirm that you want to close Radio. You should now be able to relaunch Radio and publish without any problems.
The same Force Quit approach is used to close Radio in OS 9. You do need to bring the Radio application to the foreground before doing this. Please note that using Force Quit in OS 9 can be risky, as it can cause overall system instability and Radio will often automatically quit when you try launch it again. In this situation then you need to restart your Macintosh.
Be Careful with Links
Even thought Radio works within a web browser it does a very good job of pretending that it is a desktop software application. It’s quite easy to click on a link in the Radio command bar and lose content in the editing window. Please see the section above on Ctrl-A, Ctrl-C for why this occurs.
Refresh After Changes
As Radio is used from a web browser, it suffers from the same issues as a browserthe need to occassionally refresh after changes. For example, after you change a Radio Prefs setting such as your Theme, you generally need to refresh your browser to see the new theme. You should be a bit careful with refresh, however, if you have text in the editing window when you click refresh since this can cause Radio to lose the content in your editing window.
Learn to Source Edit
In any product that creates HTML there seems to be the need to change the HTML manually due to some problem, often a browser specific problem. Please keep in mind that Radio supports full HTML editing with the Source Edit option. While this does require knowing at least basic HTML, this is often the only way to solve formatting glitches. This is discussed in the section on Source Editing in the “Turn Up the Volume” section.
Although you can technically use File URLs such as file:/// with Radio, it is not advised. Weblogs built with Radio are designed to be published out to the network where these urls will simply not work (File URLs specifically reference files on your local hard drive, not files on the network).
Netscape, Mozilla and File Urls
If you are using File URLS, such as, these will not work correctly with either Mozilla or Netscape under OS9 or OSX. You need to user local urls in the format [http://localhost/](http://localhost/)[http://localhost/](http://localhost/) or [http://127.0.0.1/](http://127.0.0.1/)[http://127.0.0.1/](http://127.0.0.1/).
When you download Radio, it automatically assigns you a unique user number, a “usernum”. If your blog is hosted at Radio.weblogs.com, your url is [http://radio.weblogs.com/usernum/](http://radio.weblogs.com/usernum/)[http://radio.weblogs.com/usernum/](http://radio.weblogs.com/usernum/). This seems logical enough except that on the screen which tells you your usernum, Prefs -> User Identity, it omits the preceding 0. For example, my usernum is 103807 but my url is [http://radio.weblogs.com/0103807/](http://radio.weblogs.com/0103807/)[http://radio.weblogs.com/0103807/](http://radio.weblogs.com/0103807/).
There’s Always a Way
This is advice more than a “gotcha”. Radio is a rich, deep, sophisticated product that has a tremendous amount of technology underneath the hood. With macros, the UserTalk scripting language, the underlying network engine and the diverse community of talented individuals that use Radio, there is always a way around any of these gotchas. It may take a bit of head scratching and perhaps consulting someone else but they are pretty much all addressable.
PC-Specific Radio Gotchas
Covered below are PC specific gotchas that affect Radio.
Configuring Internet Explorer
The default configuration for Internet Explorer for Windows will almost certainly cause you to lose work in Radio. By default Internet Explorer does what is called “Reusing Browser Windows”. This means that if you are writing a post in Radio, stop to check email and then click on a link within a message, Internet Explorer can “reuse” an existing browser window. And that existing window could be a Radio window where you are writing a post. When this happens your post isn’t saved at allremember when authoring in Radio, it’s really just a web form. To prevent this you can set an Internet Explorer option that forces IE to open new windows for new links.
Set this option with these steps.
Go into Internet Explorer.
Select Tools -> Internet Options -> Advanced and then turn off the setting for “Reuse windows for launching shortcuts”. Figure 3-xx shows the Internet Options option.
Figure 3-xx. Internet Options
Click Ok to close the Internet Options dialog.
Internet Explorer will now open all shortcuts in new windows.
Using Non-IE Browsers
On the PC Radio is designed to use the current browser to which your computer defaults. Unfortunately, even if you modify Radio’s internal settings in the .root file, for the path and executable to the browser, it fails to use them regularly and still uses Internet Explorer.
Changing Between Publishing Destinations
If you change your publishing destination from radio.weblogs.com to FTP and then back to radio.weblogs.com, certain internal Radio links will not work such as the Home link to the right of your editing window (under the Cloud Links section). These links seem to “get stuck” on the FTP location rather than recognizing the new destination for your blog. A fix for this is available here:
Macintosh Specific Radio Gotchas
Covered below are Macintosh specific gotchas that affect Radio.
Don’t Move the Radio Folder
This gotcha is Macintosh specific and affects both OS 9 and OS X. Traditionally Macintosh users have been accustomed to have been accustomed to moving folders with programs in them after they have run the program. Do not do this with Radio. Running Radio for the first time sets up file paths within its internal user table that are needed later. If you move the Radio folder you will have a very difficult to troubleshoot problem. Should this happen to you, a script to fix your Radio installation is available from:
No WYSIWYG Editing
Microsoft, in Internet Explorer for the PC, makes available a feature called WYSIWYG editing which lets a developer embed a “what you see is what you get” editor in your web application i.e. one that shows bold facing as bold, displays pictures and so on. This feature is not available in IE for the Mac at all. Despite this, UserLand displays the option for Mac users when it is nonfunctional. When you see the WYSYIWG radio button simply ignore it after you have set it to Source View.
Browser Performance Under OS 9
Using Internet Explorer and Radio under OS 9 or the Classic environment of OS X can give slow performance. The problem here is actually not Radio but errors in Internet Explorer itself where it fails to properly release CPU cycles to other Macintosh applications. This has been corrected in the new Internet Explorer for OS X. If you are on OS 9 an option may be to switch to a non-Microsoft browser but please see the next section first. For more on this, please see:
Using Non-IE Browsers
If you are using Radio with a non Internet Explorer browser such as Opera, iCab or OmniWeb then you may experience some level of problems such as Radio asking you tell it where Internet Explorer is located. To minimize these problems, use the steps below. Unfortunately, even with these options changed, you may still have some problems with non-IE browsers.
1. Set your non-IE browser as the default browser on the Web Tab of your Internet control panel.
2. Close your Internet control panel and retry using Radio.
If you are using Netscape or Mozilla please see next topic.
No Control Over Browser Window
When you open the Radio application on Mac OS X, it loads then spends a minute checking with Userland’s servers and then instantly loads the Desktop Web Site (i.e. the 127.0.0.1 Local Home Page) into the uppermost Internet Explorer browser window; no matter what you have open or might be doing in that window. This can cause Radio to take over a browser window that you might need. If you use either Internet Explorer or Mozilla this can be addressed with the Preferences command.
To correct this in Internet Explorer for OS X use these steps.
Select the Internet Explorer Preferences command.
Select the Web Browser options.
Select Interface Extras.
Under the section titled “When another app asks IE to go to a page”, check off the “Open a new browser window” option.
Close the Preferences command.
To correct this in Mozilla for OS X use these steps.
Select the Mozilla Preferences command.
Select the Advanced options.
Select Scripts & Windows.
Check off the boxes “Open unrequested windows” and “Open a link in a new window”.
Close the Preferences command.
Allocate Additional RAM on OS9
If you are running OS 9, not OS X, you should allocate additional RAM memory to Radio. If you don’t you will see definite performance problems. Other strange errors could also occur such as problems accessing the Radio menu system. Depending on your OS 9 settings, you may need to check this after upgrading to a new version of Radio to make sure that the setting wasn’t lost.
More on Publishing Problems
If you find Radio is not publishing new postings when running OS X, and the step described above that describes how to close Radio completely does not help, then you may find that Radio publishes your work on the next day. This sounds a bit strange and it is, but it seems to be the case.
Incorrect URLs when Switching Upstreaming Locations
Given that OS X includes both web (Apache) and FTP servers, many Mac webloggers are initially choosing to FTP to their local servers. This allows easy experimentation out of the public eye. It also allows you to check your work offline since your FTP and web servers are local rather than off at the UserLand servers. However, if you then swap back to the UserLand servers, there is a serious problem where Radio puts the local address (127.0.0.1) in the directory structure for images rather than the UserLand address. The only real way to fix this is to use a UserTalk script. UserTalk is Radio’s scripting language which is covered in Chapter 7. Please see the section on UserTalk before trying to use this as it can be confusing. Please note that a newer version of this script might be available from the link below.
Open the Full Radio application by choosing Open Radio from the Radio icon in the Dock.
Choose Tools -> Developers -> Quick Script
Enter the script below:
user.scheduler.prefs.runThreads = false;
local (usernum = string.padWithZeros (user.radio.prefs.usernum, 7));
local (homeUrl = “[http://radio.weblogs.com/](http://radio.weblogs.com/)http://radio.weblogs.com/” + usernum + “/”);
user.radio.settings.files.upstream.url = homeUrl;
local (adrPing = @radio.thread.agents.pingCloud);
system.temp.timers.[adrPing] = date (0);
user.scheduler.prefs.runThreads = true;
Click Run to fix your links.
Choose Radio->Publish->Entire Website to publish the fixed links to your weblog.
A copy of this script can be downloaded from:
At the core of Radio is an integral Outliner. While not strictly related to blogging, outlining is a nifty feature of Radio Userland that is worth trying. An outline is just thata document structured into nested levels. An outline being edited is shown below.
Why use outlines? The simple structure provided by an outline often helps you gather and organize your thoughts. Outlines form a convenient basis for ToDo lists, documentation, even source code.
Radio manipulates outlines in an XML format called OPML (Outline Processor Markup Language). It can also export them to HTML and plain text, so you can use the outliner to create Radio posts and stories. Radio lets you create and edit outlines, as well as subscribe to them as you would subscribe to an RSS feed of someones blog.
Using Radio’s Outliner
Up to now, we have focused on using Radio through its web browser interface. Using Instant Outlining requires that you use the full Radio product, not the web browser interface. This is a whole different side to Radio, the application that runs on your desktop.
The first step in using Instant Outlining is to bring up the Radio application.
Right click on the Radio icon in the control panel area on your Windows System Tray (Macintosh users launch it from the Dock).
From the Radio menu that pops up, choose the Open Radio command. This brings up the Radio application window (see Figure 7-xx).
To get to the Outliner, you need to select it from the Radio menu with Radio -> Outliner -> My Outline. You now see the Outline Editor shown in Figure 7-XXX.
Figure 7-xx. Radio Application
When the Outliner is open, you can treat it as a word processor and simply start typing. The Outline menu has options for changing the structure and your view of that structure. For example, you can collapse an entry (paragraph) so that you cant see its children, or expand it again to get more detail.
Here are some of the most important keystrokes.
Create a new level in the outline.
Move an outline entry in a level.
Move an outline entry out a level.
Cut the current entry, and its children, to the clipboard. You do not have to have a block marked to use this. Use Ctrl-X to delete an outline entry (if you don’t paste it back in, it gets deleted)
Paste an outline entry.
Move the current entry up the list of visible entries.
Move the current entry down the list of visible entries.
Move the current entry right (make it more nested).
Move the current entry left (make it less nested).
Promote the current entry (move up one level in the outline).
Demote the current entry (move down one level in the outline).
Add a hyperlink to the current outline element.
Radios File menu has “Save as HTML” and “Save as Plain Text” options that let you export your outline in those formats.
Re-installing Radio on Windows
NOTE: Since writing this, I’ve reinstalled Radio on Windows 3 or 4 times. Sometimes I was successful. Sometimes I wasn’t. I do not take any responsibility if these instructions do not work or your blog disappears from the Internet temporarily (as mine did one time).
You probably will never need to re-install Radio on Windows but it does happen (Mac re-installation is much more rare). You may have an unsolvable bug or need to recover from a machine crash. Given that Radio doesn’t store its data in My Documents, re-installation can be complex.
Here is the full process for backing up Radio before re-installing it, as well as the information to write down before you delete your existing installation. This process saves everything, even things that you might not need until you are sure that your new copy of Radio is re-installed.
Make note of your user number by looking at the “User Identity” option under the Prefs screen. Radio can always send this to you again but it’s best to have it.
Shut down Radio by right clicking the Radio icon in the Windows System Tray (bottom right by default) and choosing Shut Down Radio. This is important because Radio normally runs in the background and regularly updates files that you might be in the process of backing up.
Copy all of program filesradio userland to backupdir (a new directory where you want to store the backed up files).
Run Radio Uninstall from the Windows Start -> Programs -> UserLand menu.
Install your new copy of Radio.
Enter your usernum and password into the 2nd section of the configuration web page. If you can’t remember them then you can use this web page to ask UserLand to mail them to you.
DO NOT START RADIO YET.
DO NOT CREATE ANY WEBLOG ENTRIES YET!
Shut down Radio as in Step #2.
Copy all of the following files from backupdir to newdir where newdir is the new directory where you installed Radio.
Radio UserLandData Files
Radio UserLandBackups (yes this is redundant but it’s safer)
Copy everything in backupdirwww to newdirwww.
Start Radio with Windows Start -> Programs -> UserLand -> Radio UserLand.
All of your previous blog entries should be available right from the main Radio home page.
|Copyright 2002 © The FuzzyStuff|