Skip to content

meshantz/django-phantom-pdf

 
 

Repository files navigation

Django Phantom PDF

A simpla django package that takes tha pain out of rendering PDFs in django.

Quick start

  1. Install node and phantomjs:

On Mac OSX:

brew install node npm
npm install -g phantomjs

On Ubuntu:

apt-get install node npm
sudo npm install -g phantomjs
  1. Install django-phantom-pdf:

     pip install django-phantom-pdf
    
  2. That's it, you can now start using it in your django views like so and rendering PDFs!

     from phantom_pdf import render_to_pdf
     from django.http import HttpResponse
    
     def home(request):
         # If 'print=pdf' in GET params, then render the PDF!
     	if request.GET.get("print", None) == "pdf":
         	basename = 'output'  # `.pdf` will be appended to this string.
             return render_to_pdf(request, basename)
         else:
     	    return HttpResponse("Hello World!")
    

Advanced Use

For more advanced use and control, you can set the following variables in your setting. They are already set to sane defaults, so it's not necessary unless you are looking for more fine grained control.

PHANTOMJS_COOKIE_DIR = Directory where the temp cookies will be saved.
PHANTOMJS_PDF_DIR = Directory where you want to the PDF to be saved temporarily.
PHANTOMJS_BIN = Path to PhantomsJS binary.
PHANTOMJS_GENERATE_PDF = Path to generate_pdf.js file.
keep_pdf_files = Option to not delete the PDF file after rendering it.

About

Easy PDF rendering for django templates / views.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 84.5%
  • JavaScript 15.5%