Day: May 21, 2003

I’m still amazed some days at just how much can be accomplished in Conversant. The basic tools are provided, and you can mix and match them to do some awesome things.

For example, check out my demo of a system I’ve been working on to make it easier to navigate and reference certain kinds of documents (specifically, in my case, e-texts, though it could be used for pretty much everything).

This was inspired by (and much of it stolen from) Steve Ivy’s efforts with a speech by Colin Powell back in February. Each paragraph there has a named anchor, and at the end of the paragraph is a link to that anchor so that it is easy for anyone to reference a specific paragraph. Ivy also uses a bit of Javascript written by Seth Dillingham so that if you are viewing an anchored paragraph, that paragraph is highlighted. Very cool.

What I wanted to do was that, but I wanted a way to turn the anchor links at the end of the paragraphs on or off. I like having the links for reference, but they distract from the text if I’m just reading for content or want to print.

And so, on the Preface to Frederick Douglass’ “My Bondage, My Freedom” you’ll see a link in the right-hand column that reads “Show Permalinks.” Click it, and you’ll be shown a version of the page like Ivy’s, with the link at the bottom. Of course now the link in the right-hand column reads “Hide Permalinks.” Click it, and you see the version of the page without the visible links (though the named anchors are still in the page). This is done via Cookie’s, so if you prefer, you can always see one or the other or switch on the fly as you need. (Note: this probably won’t work in IE at the moment, but will after I do a quick updated later — use Mozilla or some browser other than IE to get the full effect).

Have it your way!

So here’s a brief look at what’s going on behind the scenes:

1. First, the page checks to see whether or not you’ve got this specific cookie set to true. If so, you are served the version with the permalinks visible. Otherwise, the web server passes along the clean version.

2. Second, the system checks to see whether or not I’ve designated this particular article as an E-text or not. If I have, it shows the Show/Hide link on the right. This way I can distribute this feature throughout all of my E-text pages while only having to use a single small snippet of HTML.

3. When you click on the Show/Hide link, you are directed to a page which simply sets a cookie and then redirects you back to whatever page sent you there. Again, this way two HTML snippets handle requests from an unlimited number of pages.

4. And, I am also using Seth’s hilighting Javascript. This also uses a conditional macro, so the page checks to see if this is an E-text page. If it is, it inserts the Javascript in the header area, otherwise it goes on to other things.

And it does all of this blindingly fast. Yes, this is running on a pretty fast machine after the recent upgrade, but consider that depending on the user, just loading the Preface there easily involves more than a dozen conditional macros that look for one state or another to decide how to proceed.

I think I’m going to sit back and let all of this power go to my head!