adding an index
To create a new index for Surftrail, I do three steps:
1. I create a new Attribute.
In the prototype for the blog posts, I make it visible. I have chosen (a tip from Adrian) to make one boolean attribute for each index. Of course, I could have had just one "keywords" attribute, but then I would have to remember the exact spelling of all keywords. This way, I just tick off the appropriate keywords for each note.
2. I create a new agent. It's located inside the "overviews" note, so it will automatically get assigned the "overview prototype," setting the export template and layout. The name of the new agent will be the title of the overview page.
The agent collects all the notes in which "KeyTinderbox" is "true." (Finer point: It also has an action: it sets an attribute called "related" to "true." If a blog post is included in an index, "related" is "true," otherwise it is "false." When exporting blog posts to HTML, the headline "Related overviews" is only inserted if the post is listed in an index and "related" is true.)
3. In my export template, I add a macro line.
^do(index,KeyTinderbox,Tinderbox)^
This will create a link to the overview if necessary. The macro reads:
^if(^exists($1))
<li>^linkTo($2) Overview</li>
^endif