Radio Userland

Radio post index script updated

The publisher of the All That Jazz weblog called my attention to a problem with my Radio post index script: It only worked if weblog entry permalinks ended with html. I've updated the script to look for the #renderedFileExtension directive, using it to define the file extension when present, so PHP pages and other formats can be supported. ... (read more)

Add navigator links to a Radio category

Radio UserLand tip: When using a category to publish a separate weblog, create a #navigatorLinks.xml file in that category's subfolder in www\categories (or copy the one in the www folder). By editing that file directly with a text editor, you can give the category its own navigator links. Jenny Levine has written a tutorial on editing navigator links that shows what this file should contain. ... (read more)

Radio UserLand Kick Start on backups

A new chapter of Radio UserLand Kick Start can be previewed on Workbench: Chapter 9, Backing Up Data. Though the standard disclaimers apply -- this is a pre-publication draft -- I spent a lot of time trying out Radio's backup procedures, sometimes by necessity when an experiment went awry. At this point, I've destroyed and rebuilt my 850-entry, 1,100-page weblog around a dozen times. ... (read more)

Weblog survives Radio reinstallation

I did a clean install of Radio UserLand last night to correct some nagging database problems I couldn't resolve, such as nightly scheduled tasks that stopped running and flaky retrieval of news aggregator items. It took about a half hour to update Radio.root completely, register my serial number again, and set my software preferences and theme back up. Afterward, I shut down Radio, copied my old weblogData.root file over the new one in the Data Files folder, then ran the application. Everything ... (read more)

Rendering PHP Files with Radio UserLand

A Workbench visitor asks: How can I use Radio to render .php files instead of .html files when upstreaming? The file extension is determined by the #renderedFileExtension directive. By default, files are rendered with the .html extension. To set the extension to .php for an entire folder and its subfolders, edit the #prefs.txt file in that folder and add this line: #renderedFileExtension "php" Here's an example: the xmas.txt file and the xmas.php page it produces. To set the extension only for ... (read more)

Orlando Vacationer weblog launched

I'm using Radio UserLand's categories feature to publish a new weblog at a separate domain. Orlando Vacationer is a weblog devoted to "Disney discounts, park perks, and tourist tips" for the Mouse-infested city that I visit with my family around 8-10 times a year. The domain is new and may not have propagated to all parts of the Internet yet, so if it can't be reached, try its category address. I'm going to write an article on Workbench about using Radio to publish a category that looks like an ... (read more)

Writing UserTalk scripts without a handler

UserTalk programming tip (via Brent Simmons): If a script has no parameters, it doesn't need a handler method (a method defined with the on keyword that is executed when the script is called). When a script lacks a handler, the top-level lines of the script will be executed when the script is called with no parameters. The following two versions of a workspace.displayTime script are functionally identical: on displayTime() { dialog.alert( clock.now() ) } dialog.alert( clock.now() ) ... (read more)

Error compromises my book

I'm reviewing the manuscript for Radio UserLand Kick Start. The error in this sentence is one of my favorite gaffes in six years of writing computer books: The first step in becoming a Radio UserLand developer is to explore Radio.root, the object database that compromises most of the program's core functionality. The word I was looking for: comprises. I'm almost sad the typo won't see print. ... (read more)

Radio database is gettin' busy

I'm working on a UserTalk script that restores Radio weblogs from their HTML Web pages. It's not ready for prime time -- I have to run it locally and tweak the code on a per-weblog basis -- but at some point I am hoping to release it for general use. One problem I'm running into is a "busy database" issue with the new database where weblog data is being stored. If the script halts with an error during execution, I can't access that database again without restarting Radio. Is there any way in ... (read more)

Adding dates to Radio page titles

Radio UserLand tip: To add a date to the title of each daily archive page, add the following UserTalk code inside the title tag of the home page template (#homeTemplate.txt): <%local (d); if radio.weblog.file.getArchiveFileDate (radioResponder.fileBeingRendered, @d) {": " + string.dateString (d)} else {""}%> This code will be replaced with the date in the form "Monday, June 30, 2003" (example). ... (read more)