We've had reports that the eye icon -- -- doesn't show up after someone goes through the outline naming process. So I'm doing a review of the code, and changing the sequence in which things are done to make the command more reliable.
New defensive driving techniques
If the user switches tabs while the outline is being named, we now apply the name to the correct outline.
If the server returns the name undefined, we put up an error dialog and the outline is not named. Previously we would go ahead and set the link to http://undefined/ with predictably bad results.
We get the public URL for the outline before displaying the dialog. So we know before-hand that it worked. It's possible this is where it's failing for people. Previously it was done as the first step after the user clicks on OK or presses Return.
We explicitly refresh the display of the icon chain after allocating the name.
What it means that the eye didn't show up
If you look in the OPML for an outline with a name, you'll see a <link> element in the head section of the document.
The link element points to the home page of the outline when viewed through the web.
If the outline's name is blue, the link is http://blue.smallpict.com/.
Simply, if the link element is there the eye icon will show up, and if it's not there, it's because there is no link element in the OPML file.
New version of Reader strips <rules> from outlines before displaying.
You may have to reload to get the new version.
To test choose View in Reader in the File menu with an outline that has rules.
Deployed the new docs site
The Fargo and Trex docs and worknotes have been Fargoized. This means they are no longer managed in the OPML Editor. Part of the growing-up process for our new JavaScript world. In most ways it's equal to the old way of doing things, and in other ways it's even better.
All the docs are on this site: docs.fargo.io.
The blog has moved there (you're reading it now) and the RSS feed. Redirects should be in place so that no URLs break. If you find breakage, please report it in a comment or an email to the smallpicture-web list.
The links to docs in Fargo itself have been changed to point to their new locations.
If you want to look at the site in Fargo, choose Open by name in the File menu and enter howto.
Two Trex issues
In doing this project I found two problems in Trex that I was unable at this time to fix. My Trex skills are not up to the level of my Fargo/Concord skills.
The archive type can't find your calendar structure unless it's at the top level of the outline. So I'm editing the Archive menu by hand.
Redirect nodetypes should be more powerful. If the walk goes through a redirect node, the page we redirect to should have the remaining path added to the end. This way one redirect node can work for an entire site. My workaround was to use a tool in the OPML Editor to do the redirect.
Observation: The reason Trex programming is so hard is that there is no ability to step through the code as it's running. If you're learning it, as I am, having the ability to watch it run makes a huge difference. Also makes it hard to fix problems. It's been many many years since I've not been able to step through code as it's running.
Cleaned-up after previous fix
In the last update, after closing the Edit Attributes dialog, we made sure that the visible display of comments agreed with the state of the isComment attribute. But we introduced a side-effect that caused an isComment attribute to be added that the user didn't add. While this didn't change the way the outline worked, it was annoying.
The fix was to only set the display of comments, not the attribute, if the attribute was undefined.
