|
Home
FAQ
Mail
Directory
|
|
|
|
How to use Radio with Manila
Telling Manila about Radio 
Before doing anything else, you must tell your Manila site that you're using Radio. This will enable the Edit With Radio button. It works just like the Edit This Page button except instead of editing in the Web browser (convenient) you edit in Radio (expressive, powerful).
The first step is to construct a url.
Start with the url of your site, for example:
http://me.weblogs.com/
And add "prefs/radio" to the end of the url:
http://me.weblogs.com/prefs/radio
Which takes you to a page that asks two questions.
Are you a Radio UserLand user? Click yes.
Which port is Radio listening on? Enter 5335. (Unless you have Radio running on a different port. If you don't know, enter 5335.)
Click the Submit button.
A new feature appears
Now that Manila knows you're using an outliner, it will display the Edit With Radio button in various places. For example, when the button is displayed under an Edit This Page button, that means that you can edit the page in the Radio outliner as well as in the browser. Click the icon and the document opens in Radio.
As you edit, save changes with the Save command in the File menu. When you open the document it is checked out. When you close its window, it's checked back in. Access works just like the Edit This Page button -- if you're allowed to edit a document in the browser, you can also edit it in the outliner.
In general, when the icon appears adjacent to a feature that allows you to edit text in the browser, clicking on the icon will open the text in Radio. For light editing jobs, browser-based editing is the right way to go. For deeper writing jobs, it pays to have a focused writing tool, and that's when it makes sense to use Radio.
Writing stories with Radio
It's easy to use Radio to create and edit stories on a Manila site. Here's how to do it.
1. Click on Stories in the Editors Only menu.
2. At the end of the list, below the Create a New Story link, click on the Edit With Radio button.
3. A web page asks for the name of your story. Enter a name and click on Create.
4. An empty document opens in Radio. Edit, save your changes, refresh the story list, you'll see your story. Click on the link to see how it looks on the Web.
To edit the story, view it in the browser and click on the Edit With Radio button.
Editing a Manila weblog with Radio
Here's the procedure for flipping the home page at the start of a day.
1. Go to the home page of your site. Click on the Flip Home Page button and confirm that you want to do it.
2. The browser will display an empty document for today's weblog entries. Instead of clicking on Edit This Page, click on the Edit With Radio button. An empty document opens in Radio.
3. Enter a sentence and choose the Save command from the File menu. Switch over to the browser and refresh. You should see the phrase you entered.
4. Repeat this process through the day. Any time you want to add an item to your weblog, enter it into the outline and save. Refresh your browser view to see what your readers are seeing.
You can edit an outline in the browser
Let's say you created a Manila story using Radio. It's stored on the server in two forms -- as an outline and as HTML text derived from the outline. If you edit the story in the browser, you get the OPML text. The changes are reflected in both the HTML text and in the outline. The next time you edit it in Radio, you get the changes.
Rules
When you save a Radio outline to a Manila server, it's "rendered" according to rules that may appear in the outline. If no rules appear the text is assumed to be pure HTML, no formatting is applied. In practice, most Manila-bound outlines use Rules; writing in pure HTML can be inconvenient and low-level.
Example
Rules about rules
You can include a <rules> section anywhere you like. It applies relative to the level at which it is included.
Each <rules> section contains one or more <rule>s. Each rule can have an optional "level" and/or "to" attribute that defines the scope of the rule. If the level attribute is not specified, it defaults to 1. If the to attribute is not specified it defaults to infinity (ie the rule applies to all subordinate text).
Each <rule> can have as many value tags as you like, chosen from this set: textStyle, textColor, textSize, textFace, outlineSpacing, leftIndent, labeling and internalLink. They are explained in the next section.
Legal rules
| | If the value contains "bold" the text is displayed in boldface; if the value contains "italic", the text is displayed in italic.
|
| | Possible values: Any string that makes sense as the color attribute of an HTML <font> tag.
|
| | Possible values: smallest, smaller, medium, larger, largest.
|
| | For each of these, except medium, we generate a font tag, with size set to "-2", "-1" or "+1" or "+2"
|
| | Generate a font tag with the indicated text face.
|
| | Possible values: 1, 1.5 or 2.
|
| | Adds either 1, 2, or 3 <br> tags after each headline.
|
| | The number of pixels to indent for each level.
|
| | MORE has a labeling feature: you could choose between Leader characters, Harvard, Numeric, Legal, Bullets, and None. Numeric has been implemeted here, so far.
|
| | Each headline renderered under this rule gets a left-arrow to the right of its headline, which is a name tag pointing to the permanent link for the headline.
|
| | The value of the element is the URL for the page in the archives.
|
| | For an example of its use, see Scripting News; here's a recent archive. Click on the blue arrows to see what they do.
|
| | And a screen shot of the rules section of the outline for that day.
|
See Also
If you have trouble, see the Manila Editing Checklist.
Also see the pages about directory and slides editing.
Adding frequently used rules to the Bookmarks menu as boilertext.
|
