Skip to main content

CFDOCUMENT Tips with Open BlueDragon

I'm porting a ColdFusion 8 application to Open BlueDragon and the app in question generates documents using both iText and PDFBox (which I posted about before), and also generates PDF files from HTML content using CFDOCUMENT. When compared with CF 8 I ran into some differences with CFDOCUMENT so I figured I'd post them here. In general everything just works, so this is more formatting issues than anything else.

1. Use Full URLs for Images and CSS

This was covered by Nitai in a thread on the OpenBD mailing list a while ago, so consider this a reminder that you need to use full URLs for images and external stylesheets.

2. Tweak Your CSS as Needed

Because the underlying rendering engine differs between OpenBD and CF (not sure what CF is using, but OpenBD uses the amazing Flying Saucer project), you may see differences in the handling of CSS. None of the ones I ran into were biggies, and in many cases when I looked at the CSS being used, CF 8 wasn't doing what it was supposed to be doing so while the rendered output was what I wanted, it wasn't adhering properly to the CSS. One particular case I'll mention as an example--an h1 tag had a style of float:left in the CSS which wasn't being respected by CF 8, so when the document was generated in OpenBD there wasn't a break where I was expecting one. A quick change to float:none and all was well.

3. Empty Paragraphs Don't Count

I had some instances of <p> tags with CSS applied that were being used as spacers, to generate horizontal rules using a border style on the paragraph, etc. but these paragraph tags had nothing between them (e.g. <p class="spacer"><p>). If you don't have *something* in between the open and close paragraph tag the CSS doesn't seem to apply. Throwing a non-breaking space in (<p class="spacer"> </p>) worked great for me.

4. Font Differences

Remember that depending on OS platform and a bunch of other variables you may find differences in the fonts being output. In my case the CSS (which I got from someone else originally) was using Georgia as the main font and I don't have Georgia on my Ubuntu laptop, so the rendered output wasn't the same. Just make sure you have the fonts you want to use available. You can check the Fonts page in the OpenBD administrator to see how OpenBD hunts for fonts and to add your own font paths if necessary.

That's all I ran into with CFDOCUMENT on OpenBD--a few tweaks here and there and it's working fantastically well!

Comments

Popular posts from this blog

Installing and Configuring NextPVR as a Replacement for Windows Media Center

If you follow me on Google+ you'll know I had a recent rant about Windows Media Center, which after running fine for about a year suddenly decided as of January 29 it was done downloading the program guide and by extension was therefore done recording any TV shows.

I'll spare you more ranting and simply say that none of the suggestions I got (which I appreciate!) worked, and rather than spending more time figuring out why, I decided to try something different.

NextPVR is an awesome free (as in beer, not as in freedom unfortunately ...) PVR application for Windows that with a little bit of tweaking handily replaced Windows Media Center. It can even download guide data, which is apparently something WMC no longer feels like doing.

Background I wound up going down this road in a rather circuitous way. My initial goal for the weekend project was to get Raspbmc running on one of my Raspberry Pis. The latest version of XBMC has PVR functionality so I was anxious to try that out as a …

Setting Up Django On a Raspberry Pi

This past weekend I finally got a chance to set up one of my two Raspberry Pis to use as a Django server so I thought I'd share the steps I went through both to save someone else attempting to do this some time as well as get any feedback in case there are different/better ways to do any of this.

I'm running this from my house (URL forthcoming once I get the real Django app finalized and put on the Raspberry Pi) using dyndns.org. I don't cover that aspect of things in this post but I'm happy to write that up as well if people are interested.

General Comments and Assumptions

Using latest Raspbian “wheezy” distro as of 1/19/2013 (http://www.raspberrypi.org/downloads)We’lll be using Nginx (http://nginx.org) as the web server/proxy and Gunicorn (http://gunicorn.org) as the WSGI serverI used http://www.apreche.net/complete-single-server-django-stack-tutorial/ heavily as I was creating this, so many thanks to the author of that tutorial. If you’re looking for more details on …

The Definitive Guide to CouchDB Authentication and Security

With a bold title like that I suppose I should clarify a bit. I finally got frustrated enough with all the disparate and seemingly incomplete information on this topic to want to gather everything I know about this topic into a single place, both so I have it for my own reference but also in the hopes that it will help others.Since CouchDB is just an HTTP resource and can be secured at that level along the same lines as you'd secure any HTTP resource, I should also point out that I will not be covering things like putting a proxy in front of CouchDB, using SSL with CouchDB, or anything along those lines. This post is strictly limited to how authentication and security work within CouchDB itself.CouchDB security is powerful and granular but frankly it's also a bit quirky and counterintuitive. What I'm outlining here is my understanding of all of this after taking several runs at it, reading everything I could find on the Internet (yes, the whole Internet!), and a great deal…