Tinderbox User-to-User Forum (for formal tech support please email: info@eastgate.com)
http://www.eastgate.com/Tinderbox/forum//YaBB.cgi
Tinderbox Users >> Documentation and Tutorials >> aTbRef v5.7.1 released
http://www.eastgate.com/Tinderbox/forum//YaBB.cgi?num=1290549222

Message started by Mark Anderson on Nov 23rd, 2010, 4:53pm

Title: aTbRef v5.7.1 released
Post by Mark Anderson on Nov 23rd, 2010, 4:53pm

Site updated including zips for TBX and of images. Please report an errors/omissions to me.

http://www.acrobatfaq.com/atbref5/

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Nov 23rd, 2010, 6:06pm

I forgot to save the TBX before the export - I've just refresh the ZIP of the TBX. this only affects those who use the TBX locally. They should re-download the ZIP. The HTML site is unaffected.

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Nov 25th, 2010, 1:54pm

Updated. I missed to post-beta additions to operators (here and here) plus I've added a couple of notes re syntax (here and here).

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Nov 27th, 2010, 8:36am

I downloaded aTbRef v5.7.1 to use it as a Tinderbox file locally on my computer, and very useful it seems to be too.

However, it uses a lot of resources, not so much in terms of RAM of which there seems to be quite a lot idle, but in terms of CPU - when the file is loaded, User CPU goes to 50 per cent plus and the temperature rises sharply, causing the fan to roar away at maximum speed. (I close all other significant programmes.)

Is this to be expected? A function of all the links? Is the CPU too puny? Or is something else going on that I can stop, such as agents recycling? If possible, I'd like to keep the file open whilst using Tinderbox for other purposes.

I am not manipulating the file, simply opening each note in order in the outline, reading it and closing it. No other single application I have, or even reasonable combination of applications, appears to use CPU to this extent.

The computer, by the way, is a MacBook: Intel Core 2 Duo, 2 GHz, 2 Mb RAM, 5.5.8.

Title: Re: aTbRef v5.7.1 released
Post by Paul Walters on Nov 27th, 2010, 8:53am

@Hugh

I recommend exporting the aTbRef Tinderbox document as HTML to a dedicated folder.  Downloaded the images and unzip them to an "images" folder at the root of the export folder (at the same level as index.HTML). You will then have a local copy of aTbRef.  Navigate your browser to index.HTML in the export folder and bookmark it.  The result is no more resource intensive than any website in your browser - and probably less so.

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Nov 27th, 2010, 9:59am

Paul ~ perfect! Thank you!

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Nov 27th, 2010, 1:44pm

Hugh, I've  2.75 year old MacBookPro with OS 10.5.8, 2.5GHz Core 2 Duo, 4 GB RAM. When I load the file I see one core go to c.50% for about 30 sec or so. I assume this is all the agents initialising. Some agents depend on others running, IOW agent B depends on agent A having data, so it takes a few cycles to get everything steady. However, performance is otherwise OK but not as fast as in smaller TBXs. I do leave "check spelling as you type" on and turning that off does help performance a little.

For those using rather than editing aTbRef, you could add an agent:

AgentQuery: descendedFrom("A Tinderbox Reference File") & $AgentQuery
AgentAction: $AgentPriority = -1

Let it run, then delete that agent. Now all the agents in the content part of the TBX are off. Their main role is to help express the attribute, action operator and export code lists in secondary ways, e.f. attribute by data type.  Once 'complete' the lists don't need the agent running.

I'm open to genuine suggestions for improving the performance of my TBX.

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Nov 28th, 2010, 6:37am

Thanks Mark. I shall follow your advice as well. Ultimately I prefer the TBX format for aTbRef -- and it will be good practice in the use of agents!

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Nov 28th, 2010, 10:08am

@Hugh, testing more, I do see the sort of issue you describe. Pulling out all agents and rules doesn't affect it which makes me think it's some other gremlin - which might account for the text view slow-down as well. The TBX has survived every version since 2.3.4 and most betas too so some thing may have got lodged under the hood.

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Nov 28th, 2010, 10:38am

Ah. I wondered. It did seem to me reasonable that a single TBX ought to be able to contain as many agents and links as aTbRef contains without being quite so CPU-intensive.

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Nov 28th, 2010, 12:11pm

It seems the effect is inconsistent - on my Mac anyway.  Try the latest TBX. I updated it this afternoon (although not via TBX full export which is why the built-in aTbRef update alert in your current copy won't have triggered).

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Nov 29th, 2010, 5:33am

Hmm. Same again with the updated version, unfortunately. CPU usage up to 75 per cent. Shortly after closing the new TBX file (unedited), the application quit unexpectedly.

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Nov 29th, 2010, 7:37am

Noted - I'm looking in to it.

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Dec 3rd, 2010, 6:48pm

Kudos to Mark B for finding the slow-down. Anyway, aTbRef site refreshed; some new data but mainly a TBX that won't max out the CPU.

Incidentally, thanks to @hugh for raising this issue. My ageing MBP still fast enough that whilst I'd spotted the TBX getting sluggish I'd not thought to look at Activity Monitor, instead wrongly blaming the agent update cycle and trying to affect that. This is why it is nice if people do report errors/omissions in aTbRef - sometimes I miss things.

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Dec 4th, 2010, 6:47am

Glad to have helped, Mark A.

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Dec 7th, 2010, 7:22am

Mark A. - just to check. Now as I read through the file in Tinderbox in Outline View, the CPU is pleasantly subdued, but the text links appear to be dead. Is that by design?

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Dec 7th, 2010, 8:37am

Can you give me a pointer as to some notes where you think links are missing? Whith the note selected, when you click Cmd+\ do you see any links in the Browse Links? All seems to work here, what - more precisely is not happening that you expect?


~~~~
FWIW, the Rule running on the cover note (which caused the problem) will likely need to wait for the next release for a long-term fix.  In the meantime the only thing that may break is the index page, if exported,  may say it was last updated 'never'.

Title: Re: aTbRef v5.7.1 released
Post by Hugh on Dec 7th, 2010, 9:12am

My error. I'd thought that I merely had to click on a text-link anchor to open the associated note. Now I realise I have to press Cmd-Opt as well. (Probably a confusion with the HTML version which I'd been using in lieu.)

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Dec 7th, 2010, 9:34am

Cmd+Opt highlights the link. Put the cursor inside a link (in a text window) and use Cmd+] to follow the link, this will open a new text window. If you want to re-use the current window there is a doc-level preference for this.

Title: Re: aTbRef v5.7.1 released
Post by Stefan on Dec 26th, 2010, 6:56am

I would like to download a local copy, but don't get how to do it. Sorry.

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Dec 26th, 2010, 1:36pm

See here. If you're getting stuck please explain which bit of the instructions you don't understand.

Title: Re: aTbRef v5.7.1 released
Post by Stefan on Dec 27th, 2010, 6:14am

That worked out ok. Thanks.

Title: Re: aTbRef v5.7.1 released
Post by Jody Foo on Jan 18th, 2011, 8:28am

Hi, I am a new Tinderbox user wanting to build the offline html version of aTbRef. I have downloaded the tbx and the image zip file but when I export to HTML from Tinderbox, my local export looks strange. E.g. I do not have the sitemap file.

When I open the sitemap note in HTML view, the template used is "jody". What have I done wrong?

I export by opening the file, then selecting Export to HTML from the file menu.

Thanks!

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Jan 18th, 2011, 9:08am

Aha, it looks like a undetected by-blow of some beta-testing hosed all the templates allocations - certainly for all the notes outside the main content section. I've corrected those and uploaded a fresh zip of the TBX to the aTbRef site.  Let me know if that helps.

Title: Re: aTbRef v5.7.1 released
Post by Jody Foo on Jan 18th, 2011, 12:07pm

Worked like a charm! Thanks! I will now proceed to upload it to my Dropbox so that I can try the iPad/GoodReader trick you posted about :)

Title: Re: aTbRef v5.7.1 released
Post by Jody Foo on Jan 19th, 2011, 5:57am

I just encountered a missing file: index/Preferences/Text/Font.html

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Jan 19th, 2011, 8:17am

I think you'll find all he pages using screen grabs and asll the change pages don't export properly. Delving deeper, it looks like the earlier breakage destroyed all non-default set $HTMLExportTemplate data - 200+ notes worth.  I've fixed that in the current master, but that's now irretrievably updated for the upcoming v5.7.2. If I can spare up some time I may be able to fix the current v5.7.1 master zip on the aTbRef site but I can't make any promises as it's a time-consuming task. In diagnosing this problem I have fond and fixed some broken image links in the live pages.

Before someone asks, the reason this didn't show up is I rarely do a complete re-export (into an empty container). Indeed most during-version edits are done by simply exporting the page(s) affected.

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Jan 19th, 2011, 10:10am

Good news, I figured a way to fix the current copy much more quickly. I believe, the zipped TBX on the website should now export correctly, though I've not time to export and visually check all pages - so do please report any remaining template errors

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Jan 20th, 2011, 1:06pm

I found one last template loss. Open HTML view on each of the 3 children of /Boilerplate/ and set the template /TEMPLATES/body_text_only. It's no big loos without as it's only the code includes for the Creative Commons stuff and the Google search box.

This last fix is not yet in the TBX zip!

Title: Re: aTbRef v5.7.1 released
Post by Jody Foo on Jan 21st, 2011, 2:23am

Thanks for the update!

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Jan 21st, 2011, 11:10am

TBX zip now filxed for the last reported template glitch.

Title: Re: aTbRef v5.7.1 released
Post by AGHorne on Jan 23rd, 2011, 7:29am

Mark,

I wanted to thank you for your work on aTbRef.  I've learned more about action/operator codes by actually opening up and seeing how you wrote your codes.  I can read how-to's all day long, but to see specific code written out in your files has proved invaluable.

Thanks again.  

Title: Re: aTbRef v5.7.1 released
Post by Mark Anderson on Jan 23rd, 2011, 7:59am

Thanks, that's kind. I'm the same in other area's seeing a mature doc using a good number of an app's features can be a real insight. Glad it's helped. It's probably worth adding that it can be useful to download the source TBX just to look at how the export process works. Besides the HTML - the most obvious part - there are codes/templates for:
  • an Atom newsfeed
  • an RSS newsfeed
  • a sitemap (a single HTML page with the full (exported) note outline
  • a method for tracking finding per version citations/changes
  • a method for tracking if the TBX has been updated for a new version
  • a method for tracking if the TBX has been updated during the current TB version
  • the main templates use includes for things like the footer text (Google, etc.)
  • envelope/letter style recursive export (used for the sitemap)
...and more.

[edits for typos]

Tinderbox User-to-User Forum (for formal tech support please email: info@eastgate.com) » Powered by YaBB 2.2.1!
YaBB © 2000-2008. All Rights Reserved.