Welcome, Guest. Please Login
Tinderbox
  News:
IMPORTANT MESSAGE! This forum has now been replaced by a new forum at http://forum.eastgate.com and no further posting or member registration is allowed. The forum is still accessible via read-only access for reference purposes. If you wish to discuss content here, please use the new forum. N.B. - posting in the new forum requires a fresh registration in the new forum (sorry - member data can't be ported).
  HomeHelpSearchLogin  
 
Pages: 1
Send Topic Print
aTbRef - 'similar notes' listing added (Read 3296 times)
Mark Anderson
YaBB Administrator
*
Offline

User - not staff!

Posts: 5689
Southsea, UK
aTbRef - 'similar notes' listing added
Mar 30th, 2012, 9:59am
 
Experimental refresh today. All content notes have, beneath their $Text output, a list of (up to) 10 possible similar notes - via ^similarTo^. It's gone surprisingly well, though unsurprisingly the time to export has gone up a fair bit as the app has to do the 'similarTo' query for each of 2,300+ HTML pages it is creating.

Anyway, I'm posting here in the hopes regular uses of aTbRef can give me some feedback - here or directly - on whether this addition helps at all.

So far, I've only found two glitches. The first is what appears to be an incomplete list (on a page I now can't find!) - likely an authoring mistake (user error). Secondly, some notes link to exporting pages that do utility tasks like making the zip of the TBX and thus don't create and HTML page. Not too many of the latter (and I doubt few others use that hack) and so perhaps bearable if the links actually help in discovering content.

Trying to increase hyperlinking (in a meaningful way) within the document butts up against TB not allowing links to included pages (i.e. links to HTML anchors). This means any link target must be a discrete exported note/page and thus pushes the author towards very short-form writing - small notes. TB has no problem with the latter but very short notes sometimes preclude getting enough of the topic in a note. Aggregate the notes into a single page and notes linking to them don't export their links. Interesting dilemma.

Comment on this new addition to the aTbRef HTML pages is welcomed.

~~~~~~~~~~~~~~~~~~~~~~

Wondering how it's done? The templates in question (3 of them, IIRC) have this code added:
Code:
<div>
<p>Possible relevant notes (via "Similar to" feature):</p>
^similarTo("this",10)^
</div> 


Initially, I put the code in a boilerplate note and used an include but then realised the export code was evaluating 'this' in the context of the note storing the code and not the page being exported. So the code's now in the templates.
Back to top
 
« Last Edit: Apr 11th, 2012, 4:37am by Mark Anderson »  

--
Mark Anderson
TB user and Wiki Gardener
aTbRef v6
(TB consulting - email me)
WWW shoantel   IP Logged
Mark Anderson
YaBB Administrator
*
Offline

User - not staff!

Posts: 5689
Southsea, UK
Re: aTbRef - 'similar notes' listing added
Reply #1 - Apr 11th, 2012, 4:51am
 
Seems no one's tried this, which is a shame. As I investigate these new links more I'm finding it helpful for exploring the 3 main listings (Attributes, action codes, export codes) and designators - which should aid learners.

Though the overall export is slower (for reasons stated above) than the speed I'd got used to before adding these links I think the result makes it worthwhile. FWIW, I don't think listing fewer matches per page affects speed of output as the work is in TB having to run the Similar Words query for each page it exports regardless of the number of results it then adds to the exported page.
Back to top
 
 

--
Mark Anderson
TB user and Wiki Gardener
aTbRef v6
(TB consulting - email me)
WWW shoantel   IP Logged
Pages: 1
Send Topic Print