معرفی شرکت ها
django_pdf_generator-0.1.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Generate PDF from HTML with django
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django_pdf_generator-0.1.3 |
| نام | django_pdf_generator |
| نسخه کتابخانه | 0.1.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Charles TISSIER |
| ایمیل نویسنده | charles@vingtcinq.io |
| آدرس صفحه اصلی | https://github.com/charlesthk/django-pdf-generator |
| آدرس اینترنتی | https://pypi.org/project/django_pdf_generator/ |
| مجوز | MIT |
|django-pdf-generator v0.1.3 on PyPi| |MIT license| |Stable|
django-pdf-generator
====================
Convert HTML to pdf with django using phantomjs
Requirements
------------
- Python (2.7) (Need to be tested for 3.x)
- Django (1.10, 1.9) (Need to be tested for previous versions)
- PhantomJS
Installation
------------
Install using ``pip`` :
``pip install django_pdf_generator``
Add ``pdf_generator`` to your INSTALLED\_APPS setting.
.. code:: python
INSTALLED_APPS = (
...
'pdf_generator',
)
Put phantomjs binary on your path or set the path manually in your
settings using ``PHANTOMJS_BIN_PATH`` settings (see below).
Example
-------
Generate a PDF with PDFGenerator class
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Generate a pdf from an url
.. code:: python
from pdf_generator.generators import PDFGenerator
pdf = PDFGenerator(url="https://github.com/charlesthk/django-pdf-generator",
Save it to the database using PdfDoc models :
.. code:: python
pdf.save(
filename='pdf_generator',
title="pdf_generator on github",
description="Convert HTML to pdf with django using phantomjs")
Get the PDF as a Django ContentFile named 'my\_pdf\_file.pdf' :
.. code:: python
pdf_content_file = pdf.get_content_file('my_pdf_file')
# Return a Django HttpResponse with the PDF Attached named 'my_pdf_file.pdf':
return pdf.get_http_response('my_pdf_file')
Return a Django HttpResponse with the PDF Attached named
'my\_pdf\_file.pdf':
.. code:: python
return pdf.get_http_response('my_pdf_file')
Generate a pdf just like Django ``render`` function :
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
urls.py
.. code:: python
url(r'^invoice$', views.invoice, name='invoice'),
views.py
.. code:: python
from pdf_generator.renderers import render_pdf
def invoice(request):
"""
Render an invoice
The invoice.pdf file is returned
"""
return render_pdf('invoice', request, 'front/invoice.html')
Juste add ``?html=1`` to the url to view the HTML instead of getting the
pdf file.
``PDFGenerator`` options
------------------------
The ``PDFGenerator`` class accepts the following arguments :
- url [required]
- paperformat [Required] default to 'A4', examples: "5in*7.5in",
"10cm*\ 20cm", "A4", "Letter"
- zoom [Optional] default to 1.
- script [Optional] default to DEFAULT\_RASTERIZE\_SCRIPT, defines
which render script to use.
- temp\_dir [Optional] default to DEFAULT\_TEMP\_DIR, defines which
temp dir to use.
Model used for saving PDF
-------------------------
When using ``save(filename, title='', description='')`` method of
``PDFGenerator``, the following model is used:
::
class PdfDoc(models.Model):
"""
Store each generated pdf
"""
title = models.CharField(verbose_name=_("Title"), max_length=255, blank=True)
description = models.TextField(verbose_name=_("Description"), blank=True)
document = models.FileField(verbose_name=_("Document PDF"), upload_to=pdf_settings.UPLOAD_TO)
created_at = models.DateTimeField(auto_now=False, auto_now_add=True, verbose_name=_('Creation'))
updated_at = models.DateTimeField(auto_now=True, auto_now_add=False, verbose_name=_('Update'))
Settings
--------
Add your settings to your main django settings file. The settings are
set by default to :
::
PDF_GENERATOR = {
'UPLOAD_TO': 'pdfs',
'PHANTOMJS_BIN_PATH': 'phantomjs',
'DEFAULT_RASTERIZE_SCRIPT': os.path.join(PDF_GENERATOR_DIR, 'rasterize.js'),
'DEFAULT_TEMP_DIR': os.path.join(PDF_GENERATOR_DIR, 'temp'),
'TEMPLATES_DIR': os.path.join(PDF_GENERATOR_DIR, 'templates/pdf_generator')
}
``UPLOAD_TO``
~~~~~~~~~~~~~
Define the directory or the function to be used when saving PDFs,
default to ``pdfs``.
``PHANTOMJS_BIN_PATH``
~~~~~~~~~~~~~~~~~~~~~~
Define the path to Phantomjs binary, default to ``phantomjs``.
``DEFAULT_RASTERIZE_SCRIPT``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Define which render\_script to use by default, default to
``rasterize.js`` inside the package.
``DEFAULT_TEMP_DIR``
~~~~~~~~~~~~~~~~~~~~
Define the directory to use for temporarily generated pdf by PhantomJS.
default to ``pdf_temp``.
``TEMPLATES_DIR``
~~~~~~~~~~~~~~~~~
Define the directory to use for temporarily generated HTML files by
PhantomJS. default to ``pdf_temp``.
Support
-------
If you are having issues, please let us know or submit a pull request.
License
-------
The project is licensed under the MIT License.
.. |django-pdf-generator v0.1.3 on PyPi| image:: https://img.shields.io/badge/pypi-0.1.3-green.svg
:target: https://pypi.python.org/pypi/django-pdf-generator
.. |MIT license| image:: https://img.shields.io/badge/licence-MIT-blue.svg
.. |Stable| image:: https://img.shields.io/badge/status-stable-green.svg
نحوه نصب
نصب پکیج whl django_pdf_generator-0.1.3:
pip install django_pdf_generator-0.1.3.whl
نصب پکیج tar.gz django_pdf_generator-0.1.3:
pip install django_pdf_generator-0.1.3.tar.gz