Last update: 2/11/2012; 11:23:24 AM.

worldOutline.root

About the World Outline permalink

The World Outline is like the World Wide Web, except instead of a web of linked pages, it's an array of outlines that include other outlines. The outlines can live anywhere on the Internet. They are accessed over HTTP.

At UserLand, the company that pioneered blogging and RSS, we started working on this in the 1990s, and shipped it in a variety of forms. The OPML format was developed as the format for outlines. It plays the analogous role that HTML plays in the web.

The World Outline helped glue together the early podcasting communities in 2004.

In April 2011, we began a rewrite, step by step, to modernize it and make it better, and the result is worldOutline.root, a tool that runs in the OPML Editor environment.

This document explains how to install a World Outline server in the OPML Editor environment, and configure your desktop outliner to communicate with it.

Dave Winer
June 2011, New York

Requirements permalink

1. A fully-updated OPML Editor running as a server.

2. An Amazon S3 account for static storage of outlines.

3. A bucket in your S3 account.

4. A CNAME pointing to the server.

5. A fully-updated OPML Editor running on your desktop computer (or laptop).

How to install permalink

1. From the OPML Editor server, choose Tool Catalog from the Misc menu.

2. Click on the Install link on the same line as worldOutline.

3. Click OK to all confirmation prompts.

4. This web page should open in the browser.

Setup on the server permalink

1. Enter the Access Key ID and Secret Access Key for Amazon on this page.

2. Go to the OPML Editor prefs page on the server, look for the World Outline section, click on the first item to choose the editorial domain for your server. It should be a CNAME or domain name pointing the server that's running the OPML Editor and worldOutline.root.

3. On the next prefs page enter the name of an S3 bucket you want to use to store OPML documents created by users of your server. It can be a path to a bucket if you want to store them all in a section of a bucket you use for another application.

4. On this page enter a password for the Admin account.

5. Your server must have port 80 open. In the OPML Editor, you can open that port on this page. Be sure any firewall software you have installed has port 80 open.

When you press Submit, we check out the parameters. If they work, we say so.

Important: The links in this section point to the server. So you must be viewing the page in the browser on the server in order for them to work.

Setup on your desktop permalink

On your desktop machine, launch the OPML Editor if it's not already running, then open this page in a browser on your desktop machine.

1. Enter the domain name of your server, the same one you entered when configuring your server, as explained above.

2. Where it calls for the username, enter admin.

3. Enter the admin password you chose when setting up the server.

When you press Submit, we check out the parameters. If they work, we say so.

Editing your outline permalink

Now, finally -- the reason for all this setting-up!

In the OPML Editor on your desktop, choose Open Roots Page from the World Outline sub-menu of the Outliner menu. Click on the Edit icon in the same row as the outline you want to edit.

Screen shot.

You should see a blank outline.

Enter some text and click the Save button.

Then click View.

Here's what you might see.

Where to go from here permalink

If you have questions or comments you can post them here, or on the World Outline mail list.

Notes permalink

The format exchanged between the server and workstation is simple OPML and the protocol is XML-RPC, so it should be relatively easy for any OPML-based editor to hook in, as well as other servers to hook in behind the editor. But for now the only way to do this is with the OPML Editor on both ends.

The old howto is here.

blog comments powered by Disqus

Last udpate: 2/11/2012; 11:23:24 AM.