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
Some TBX-only features of aTbRef (Read 4665 times)
Mark Anderson
YaBB Administrator
*
Offline

User - not staff!

Posts: 5689
Southsea, UK
Some TBX-only features of aTbRef
Feb 25th, 2013, 1:58pm
 
I've added a new page here which might be of interest to those who've never downloaded the TBX source file of aTbRef. Partly by dint of what it has to do the create the website, the TBX contains a number of what are effectively further demos of some of TB's functions. It's not all HTML-export related!
Back to top
 
 

--
Mark Anderson
TB user and Wiki Gardener
aTbRef v6
(TB consulting - email me)
WWW shoantel   IP Logged
J Fallows
Full Member
*
Offline



Posts: 418

Re: Some TBX-only features of aTbRef
Reply #1 - Feb 25th, 2013, 6:20pm
 
Mark A., I think I speak for all the TBX user diaspora in thanking you for the incredible care and work that has gone into this file. Thank you!

At the risk of again sounding dense, I wonder if I could ask you to clarify one aspect of downloading the ref file in TBX format. The instructions on part of your site http://www.acrobatfaq.com/atbref5/index/AboutaTbRef/ObtainingtheaTbRefsource.htm... say:

Quote:
A recent version of this file (including all needed HTML export templates) this will be downloadable from the root of the HTML site:

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

The files are packaged as a ZIP archive that should extract to a new folder on download. The above zip doesn't contain any of the site's images but a separate zip is available from:

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

The above unpacks to a folder "images" that should be placed in the root folder of your local aTbRef, i.e. alongside the "index.html".

Here is the dense part: When I un-zip the zipped version of the file, I get aTbRef.TBX with no particular root directory. If I saved the zipped file into ~Downloads, that's where the .TBX file shows up too. Where is the root directory into which I am supposed to unzip the images? Just that same one? Again, sorry not to grasp this automatically.
Back to top
 
 
  IP Logged
Mark Anderson
YaBB Administrator
*
Offline

User - not staff!

Posts: 5689
Southsea, UK
Re: Some TBX-only features of aTbRef
Reply #2 - Feb 26th, 2013, 4:51am
 
Oops. Passage of time - I need to revise those instructions. This is why a genuinely like to hear about errors and omissions - with so many pages to track I'm regularly embarrassed to find another overlooked corner. The resource is about to hit it eighth birthday!

Bottom line:
  • The TBX zip. This just unpacks a TBX, which you can open in TB. You can put it anywhere you like, so moving it from Downloads to your Documents folder is probably a good start.
  • The images zip.  this unpacks a folder of images that are (only) needed if you wish to export and use the HTML version of aTbRef on your own Mac - or do so and them move the whole resource elsewhere on your LAN. You do not need the images zip if you're only using the TBX resource within TB - the images are used only by the HTML pages (though I guess you could look up the image names in the TBX's notes' $WebImage attribute and go find the resource via Finder).
  • To make a local HTML version, open the TBX, File menu, Export HTML, choose a new/existing folder location on your system (TB will remember this), and export. Now, drag the images folder (from the Zip above) into the folder where you exported the TBX's HTML pages. The 'images' folder sites alongside the 'CSS' and 'index' folders.
  • Open your local HTML version by opening the 'index.html' in the exported folder. All in-site links are relative so work in situ?
  • On an academic or corporate LAMN with no or restricted web access? Once you've done a local export an aTbRef on your Mac and added in the images, you can move the export folder - i.e. the whole website - anywhere on your LAN. As long as you know the UTL for it's home the whole site will work from the new location.
  • One small exception is the version/build checker which looks at aTbRef's server - but you could customise that is you want.
  • Note the Creative Commons licence. I've added this so if people want to build off this, translate it, leverage it, do whatever within an organisation where copyright etc. is scrutinised then the CC licence should help.
  • Above all, whilst my personal outboard brain for TB, it's there as a shared community asset. As such errors and omissions are welcome. The app changes over time and some things become moribund or simply no longer the case.
  • My aTbRef probably gets some small change 2-3 a week. I don't update the zip for typos - I just upload the page. The RSS/Atom only get updated on a full export and as, with similarTo links on, this takes c.5 mins (15 secs without!) I don't do a full export so often. The images zip is updated as when images update (though there's no tracker for this).
I hope that helps clarify things. If not, do ask. I hope the end result will help shape a new aTbRef that is clearly missing at the moment!

Although the TBX does store use the images, I've realised we may be able use a trick I developed for the index of my Demo Bank to seed $File - in notes that export with an image - so that clicking on it can open the relevant image via Finder and read alongside the TBX note. [Note: not currently implemented]
Back to top
 
« Last Edit: Feb 26th, 2013, 5:17am 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: Some TBX-only features of aTbRef
Reply #3 - Feb 26th, 2013, 6:49am
 
Image linking idea now implemented and online files updated. See this thread.
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