One of the most important changes we're making for Build 25D.01.00 is a re-build of our HTML to PDF translation tool, CHTSNAP2PDF.EXE. This tool has been with us for approximately 6 years. It has enabled us to publish all of our HTML website pages and HTML documentation also as user-interactive PDF documents.
Examples of HTML to PDF translations abound on our website. Here are just two of them:CHT Home Page as HTML
While you're checking out the above links, please notice the follwing things:
• The PDF documents look exactly like the HTML documents, (as expected).
• The PDF documents work exactly like the HTML documents, (better than print to pdf).
We say "work exactly like" the HTML documents because all internal links work as they do in HTML. You can jump to subsections of the same document just as you are able to do with HTML. All viable, original HTML internal links are honored.
We say "work exactly like" the HTML documents because all extermal links work as they do in HTML. You can jump to external document URLs (if reachable) just as you are able to do with HTML. All viable, original HTML external links are honored too.
Try making this work with any of the Print-to-PDF printer driver conversions many of you have used up to now. They may look the same, but they won't work the same.
Previously CHTSNAP2PDF.EXE was a one-piece application. It has been rebuilt as a two-piece application consisting of an executable, CHTSNAP2PDF.EXE and a DLL, PDFLIB.DLL.
Clarion applications can now execute CHTSNAP2PDF.EXE using Clarion's "RUN" functionality or CHT's capture console (HNDCAPCON.INC/.CLW) "RUN" function.
CHTSNAP2PDF.EXE as discussed here is a command-line application which we (or you) can call from your Clarion application, or from a batch script, to provide a translation of any HTML document into a well-formed, interactive, PDF. We've simplified the command-line interface as follows:
Our latest "multiple-version-installer", [Ver 9.0] is able to install any or all of our CHT Clarion 10 version, CHT Clarion 11 version or our CHT Clarion 11.1 version and now a backward compatible Clarion 9.1 version.
We know from the variety of CHT downloads happening in the last month, that many of you are installing CHT to multiple Clarion IDE's located on your development computer(s). More power to you if you're doing this and you have found some new advantage, opportunity, or convenience by doing this.
We keep a suite of 120 or more CHT applications compiling separately, at different times, on each of our Clarion IDE versions using a copy of HNDCMP.APP (compiled with the target IDE version). This is our Clarion-Version compatibility check. It points us to template and/or class differences required for a given IDE version. We incorporate these different requirements into the templates and classes directly such that all 4 Clarion IDE's use EXACTLY the same set of CHT templates and EXACTLY the same set of Clarion classes.
The newest CHT installer can be picked up, as usual, at the URL shown in the following image:
This "CHT Utility Application" HNDTPLREGISTRY.EXE, is used to re-register a set of user-selected templates to the Clarion IDE.
Since CHT enables you to install multiple versions of the same Clarion IDE on a single machine, it becomes important to organize the registered templates on a given IDE instance to just the templates required for a specific application or project.
We've found from long experience that the template registry of most Clarion developers is replete (overflowing) with useless and unnecessary templates.
It may interest you to know that CHT has well over 120+ utility and demonstration applications including everything from zip-utilites to web-servers, to powerful data browses that work locally or across the web, all with two template sets: ABCHAIN.TPL and HNDTOOLS.TPL and nothing, seriously, nothing else.
We can do this with Clarion 9.1, Clarion 10, Clarion 11, Clarion 11.1 -- same apps, same code, same exact templates and classses.
Because we're template developers and we reload template modifications daily, we find that if we don't rebuild our template registry from scratch on at least a weekly basis, our favorite IDE's template registry file, TEMPLATEREGISTRY10.TRF will grow to be well above 140MB in no time at all.
When we rebuild the registry using just the two template sets, mentioned above our registry is barely 14MB - or ten times smaller and many times faster at generating applications.
Its the nature of the beast (Clarion's Template Registration System) that the template registry grows by the size of the template set(s) modified since last registered.
We'd be willing to bet that there are template junkies out there who curse their Clarion IDE for no good reason other than the fact that their template registries have grown to a gargantuan size, such that their Clarion IDE runs badly, GPF's unnecessarily, or chokes regularly.
On any application or project, unecessary, unused template sets in the registry are no better than "junk in the attic". They take up space and get in the way of speed and impede developer productivity.
Four versions of the executable are provided, one each for Clarion 10, Clarion 11, Clarion 11.1 and Clarion 9.1. They are located in the \accessory\bin\ directory. The source application, HNDTPLREGISTRY.APP is also provided in the \hndapps\ directory of the Clarion IDE to which you are installing.
Each HNDTPLREGISTRY.EXE version, that we provide pre-compiled and ready to run, addresses directly, and only, the Clarion template registry of the Clarion version with which it was compiled.
First, select all the .TPL files that you want to register from \template\win\ and from \accessory\template\win\ into the application browse. These are stored in the HNDTPLREGISTRY.TPS file under the application directory. You only need to do this first step once, unless extra templates not already selected and stored are required.
Next, close the Clarion IDE version being addressed if it is running, as the application will refuse to re-register templates if it detects that Clarion version is still running.
Next, select the templates you wish registered using the CHT LBX browse record selection method. Browse record selection works as in any CHT HandyMarkerBrowse or CHT ListBoxBrowseExtender browse.
Finally, click the "Re-Register" button on the toolbar. The application confirms with you, that the Clarion IDE being targeted is NOT running. Once confirmed, it renames the current \template\win\clarionregistryXX.trf and re-registers the templates selected in the application browse.
Click the link below to contact us by email.
It will start your email client with our email address inserted: