Aha! Documentation formatting issue resolved...

If you've been staring at the documentation on the new DataFaucet site (http://www.datafaucet.com) or on your own server, and wondering why the formatting is all out of whack, then I have good news. I finally figured out what causes this -- and apparently it's the ColdFusion server's white-space management.

I don't use it on my own servers -- and the onTap framework allows me to handle most of my white-space issues by simply turning on EnableCFOutputOnly in the config.cfc, so my onTap framework projects end up having pretty clean result pages without the need for aggressive white space management. And so hence, since I never turned it on, I never noticed the problem with the framework documentation on my own machine.

It suddenly dawned on me today... I'd noticed last night that one of the examples on the official site was whacked (during a presentation no less!) and thought, "I'll have to fix that later"... And then today I realized that it wasn't just that one, it was all of them. I was hoping I could just set something in the onRequestStart to fix it, but no such luck. I've had to insert cfprocessingdirective tags in each page to prevent the aggressive white-space management from trashing my pre-formatted samples.

I don't think I could even put that in the custom tag that handles those samples, because the cfprocessingdirective tag requires an end tag, and if memory serves, you cant put the opening tag and the closing tag in separate halves of a flow-control like a cfif or a cfswitch, which is what you'd need to do to wrap the content of the tag.

Anyway, long story short, I finally fixed it and published a new zip archive. :)

And hopefully this may help some other folks who are scratching their heads about a similar issue with a HostMySite account.

Comments
BlogCFC was created by Raymond Camden. This blog is running version 5.5.006.