Some people want to edit more than one WordPress blog with Fargo. To make that possible, Fargo now has an outline-level setting for the URL of the associated WordPress blog.

To change the setting, choose Outline Settings from the File menu. Click on the Overrides tab. Enter a new value for the WordPress blog URL.

Here's a screen shot showing an outline with a different WordPress blog URL.

When you save a post from the outline, if this option is set, the post will be saved to the indicated WordPress site.

Note: There's no ability to override the username or password. This information has to be stored in the OPML file, and it's not cool to store passwords in such an easy-to-share format.

04/20/14; 10:10:12 AM

Fixed a bug where an old version of the Settings dialog in the System menu would appear.

This was caused by an error in mapping domains. It's a long story, but it's fixed now. However, it suggests there may be other similar problems in Fargo that we should be watching out for.

If you see any dialogs or user interface elements that appear to be dated, please report them here or on the Fargo2 list.

04/18/14; 09:59:51 AM

There's one new feature in this release, the ability to download an entire WordPress site into a Fargo outline.


  1. There's no user interface for the feature.

  2. There are limits to what it can do.

  3. I don't know how well it will perform on WordPress sites other than the ones I tested with.

How to

  1. Make sure that you've configured Fargo to talk to the WordPress site you want to use, in the Blog panel of the Settings dialog in the System menu, at the right edge of the menu bar (the menu under your Dropbox name).

  2. In any outline, type this: getMyWordPressOpml () on a line by itself. Press Cmd-/ to run it.

  3. After a while you'll see a dialog that says that it has downloaded your site into the wordpress folder. This is a sub-folder of your Fargo folder. Screen shot.

  4. In the file system, move or copy the file into your Fargo folder.

  5. Choose Open in the File menu.

  6. Choose the outline you just moved. With any luck the outline will open.

What you can do with this outline

If you want to make an editing change to any of the posts, do it as you would with any WordPress post you created in Fargo. 1. Make the change. 2. Put the cursor on the title headline. 3. Click the WordPress icon in the left margin. 4. Wait for confirmation. The Eye icon should take you to the changed version of the post.

Deleting or moving the posts has no effect on the website. You can organize the posts any way you like.

The great thing about this feature is that you can easily edit the contents of an entire blog using the outline interface to find your posts. You have the full organizational power of the outline to arrange your blog to make editing as easy as you want it.

What's next

I want to release the source code for the server, where all the work in conversion is done. The ability to export an entire WordPress blog in a single file is a new thing for WordPress, as far as I know. It's something I want to share widely, because everyone needs this ability, and I don't want to host the service for everyone in the world.

The server is written in JavaScript and runs in node.js.

Update: The server software has been released.

Report on the Fargo2 list

Please report success or failure on the Fargo2 list.

If there are problems, remember to provide all the information someone would need to help you.

04/17/14; 10:05:18 AM

A couple of minor changes related to watched outlines.

  1. If the user is hooked into my Fargo Publisher server,, and has one or more watched outlines open, we use a new server just for checking for changes instead of using the main server. Just want to lighten the load on the main server, to keep it nicely responsive.

  2. If you aren't actively using Fargo, we don't check watched outlines. The rule is if you haven't typed anything in 5 minutes, we don't check. If you want it resume checking just type something.

Watched outlines are central to using Fargo in a workgroup.

How to update

If you're running Fargo in a tab in the background, it would be helpful to me if you would reload the tab to get the newest version running. This will lighten the load on my server if everyone does it, because the new version has an important optimization. Thanks!

04/04/14; 01:23:45 PM

All the changes in 1.52 are in the stream template, and a little addition to Fargo's CMS to support the new stuff. And all the changes are fairly technical.


Maps are the big 1.52 feature. Here's a narrative.

You can use maps in the backgrounds for days by attaching attributes to the headline for the day. This feature will get separate documentation.

How to install

Reload and verify the version under the dinosaur is 1.52.

What's changed in the stream template

New fonts. Ubuntu and Vollkorn. Per the recommendation on this page. Ubuntu is an old favorite

Thanks for Ken Smith's suggestion to include the italic and bold versions where available.

Fixed a bug where if you went to a permalink without subs (example), it would flip the wedges on all items that did have subs. A jQuery newbie mistake.

The title of each page now has the site name in square brackets. The home page is given the name "home," it would otherwise be the empty string.

Updated the fargoTemplates repository on GitHub.

What's new in the CMS

There's now a connection between the attributes on the day page in the outline and the <div> representing the day in the rendered HTML. This is how the data is transmitted from Fargo to the page for the new map feature.

For example -- here's the attributes on the main headline for yesterday's Scripting News. You can see it completely specifies the map that's displayed behind the day's content on the site.

To see how that's reflected in the HTML data structure you can open it in a debugger, or peruse this screen shot. The correlation is pretty clear. All the unusual attributes are present. We don't bother with the atts that every headline in Fargo has -- created, name and text. Anything the user has added, however, is transmitted, and of course available to the JavaScript code running in the page. This is how we make the linkup with Google Maps as the page is loading.

It took a while to figure out how to do this mapping, but this is exactly why the data-xxx feature is in HTML, what's interesting is how nicely it maps onto the structures we're already maintaining in the CMS. The worlds match up nicely.

03/24/14; 12:58:52 PM

A good question on the smallpicture-web list.

How can I use a Google Web Font in my Fargo website?

There are probably a few ways to do it, but imho the easiest is to add the font includes and new style declarations in a <%customStylesScripts%> glossary entry. This is included in every template, after all the other styles and scripts, in the head section. So you can override anything, in theory, by putting it in that glossary entry.

Here's an example site that illustrates.

Here's the OPML source for the site.

03/23/14; 10:15:57 PM
  1. It's better not to put links in headlines with subs. It makes clicking on the headline have two meanings, and this can be confusing. If I find I want to add notes under something that's already linked, I add a new headline, and moved headline with the link under it.

  2. If you want something to be in the feed, you have to use the + icon to create it. Some people are apparently creating new items by pressing Return. I do it myself, without thinking. Those items will not be in the feed.

03/21/14; 04:55:16 PM

For now, if you want to create a noteblog, follow the instructions on the Testing 1.51 page.

I'll merge those instructions in with the regular Fargo Docs, shortly.

Updated the templates repository on GitHub. v0.42.

Update: The Fargo Docs site now has a Noteblogging howto page.

03/21/14; 11:38:49 AM

These instructions have been replaced by a page on the Fargo Docs site.

03/18/14; 11:58:02 PM

The default outline template got a couple of updates.

  1. The slogan at the bottom is now hidden. It's still there, and if you want to bring it back, add this bit of CSS in a #style directive: .spSlogan {display: inline;}

  2. You can now put a background image on an outline page. Add a backgroundImage attribute to the title headline. Its value is the URL of an image. It should be pretty big. This page uses the outline template and has an image.

I updated the GitHub repository with the latest versions.

The #style directive

If you haven't checked it out yet, it's really sweet.

Basically you can add CSS styles at any level -- in your cmsPrefs.opml file, or on an individual page. It's one of the coolest new CMS features in Fargo 2.

See the page on the Fargo Docs website.

03/18/14; 05:52:18 PM

Last built: Mon, Apr 21, 2014 at 10:08 AM

By Dave Winer, Monday, April 21, 2014 at 10:08 AM.