django-persian-pdf 0.1.3

Status

Dependencies

• Django >= 3.2

• Google Chrome Stable

• xelatex

Install

pip install django-persian-pdf

• Make sure you have installed either google-chrome-stable or texlive-xetex on your machine.

sudo apt install google-chrome-stable
sudo apt install texlive-xetex

Usage

1. Edit settings.py and add django_persian_pdf to your INSTALLED_APPS.

2. Inherit your views from appropriate Template or Detail view classes.

Example #1: Using HTML Template to generate a PDF response

from django_persian_pdf import views as pdf_views

class TemplatePrint(pdf_views.HTMLToPDFTemplateView):
    template_name = 'payment_reports.html'

    def get_context_data(self, **kwargs):
        context = super().get_context_data()
        context['payments'] = Payments.objects.all()
        return context

class DetailPrint(pdf_views.HTMLToPDFDetailView):
    template_name = 'payment_detail.html'
    queryset = Payments.objects.all()

Example #2: Using LaTeX Template to generate a PDF response

from django_persian_pdf import views as pdf_views

class TemplatePrint(pdf_views.LatexToPDFTemplateView):
    template_name = 'payment_reports.tex'

    def get_context_data(self, **kwargs):
        context = super().get_context_data()
        context['payments'] = Payments.objects.all()
        return context

class DetailPrint(pdf_views.LatexToPDFDetailView):
    template_name = 'payment_detail.tex'
    queryset = Payments.objects.all()

Notes on LaTeX

1. Using latex template with persian fonts requires you to have installed your persian fonts in home directory.

mkdir ~/.fonts
cp /path_to_fonts/Vazirmatn.ttf ~/.fonts/
fc-cache -f -v

2. In latex template make sure you have used xepersian package as last package.

3. Define persian fonts in latex template.

4. You can use django template tags in latex template.

Here is an example of latex template for a given view:

\documentclass[a4paper,9pt]{letter}
\usepackage[portrait,margin=0.1in]{geometry}
\usepackage{xepersian}

\settextfont{Vazirmatn}
\setlatintextfont{Vazirmatn}
\setdigitfont[Scale=1.1]{Vazirmatn}


\begin{document}

  {% for payment in payments %}
    {{ payment.trace_code }}
    \newline
    {{ payment.amount }}
    \newline
  {% endfor %}

\end{document}