📄 Django & PDF – Génération, Manipulation & Tools

1. Approche "Template" (WeasyPrint, xhtml2pdf)

Principe : Vous réutilisez vos connaissances Web. Vous écrivez du HTML/CSS (comme une page web), et un moteur de rendu le convertit en PDF.

• Avantages : Rapide à développer, facile à maintenir, réutilisation des templates Django.
• Inconvénients : Plus lent en CPU/RAM, mise en page "pixel perfect" parfois complexe.
• Leader : WeasyPrint.

2. Approche "Programmation" (ReportLab)

Principe : Vous écrivez du code Python pour dire "Dessine un rectangle en X=100, Y=200". C'est comme dessiner sur un Canvas.

• Avantages : Extrêmement rapide (génération de masse), contrôle total au millimètre près, pas de moteur de rendu lourd.
• Inconvénients : Très verbeux, difficile à maintenir, nécessite d'apprendre une API complexe.
• Leader : ReportLab.

Pourquoi WeasyPrint ?

C'est la solution recommandée pour 90% des projets Django. Elle supporte le CSS moderne (Flexbox, Grid partiel, @page) et produit des PDFs propres.

Installation Python

# Dans votre venv
pip install WeasyPrint

Exemple Minimal (Python)

from weasyprint import HTML

# Depuis une chaîne
HTML(string='<h1>Hello</h1>').write_pdf("hello.pdf")

# Depuis une URL
HTML('https://google.com').write_pdf("google.pdf")

WeasyPrint nécessite des librairies système (GTK, Pango) pour fonctionner (voir carte 1.3).

Installation

pip install reportlab

Concept : Canvas

L'objet `Canvas` est une feuille blanche. On utilise des coordonnées (X, Y) partant du coin bas-gauche (0,0).

from reportlab.pdfgen import canvas

def create_pdf(filename):
    c = canvas.Canvas(filename)
    # Dessiner un texte (x=100, y=750)
    c.drawString(100, 750, "Hello World from ReportLab")
    # Sauvegarder
    c.save()

Platypus (Haut Niveau)

ReportLab offre une couche "haute" appelée Platypus qui gère les paragraphes et les tableaux automatiquement (flowables).

from reportlab.platypus import SimpleDocTemplate, Paragraph
from reportlab.lib.styles import getSampleStyleSheet

doc = SimpleDocTemplate("doc.pdf")
styles = getSampleStyleSheet()
story = []

story.append(Paragraph("Ceci est un paragraphe long qui va se wrapper...", styles['Normal']))
doc.build(story)

La règle @page

Définit les marges et la taille du papier.

@page {
    size: A4; /* ou Letter, A3 */
    margin: 2.5cm;
    margin-top: 3cm; /* Espace pour le header */
    
    /* Zones de page (Headers/Footers) */
    @top-center {
        content: "Mon Entreprise SAS";
        font-weight: bold;
    }
    @bottom-right {
        /* Compteurs automatiques */
        content: "Page " counter(page) " sur " counter(pages);
        font-size: 10px;
    }
}

Contrôle des sauts de page

Crucial pour éviter qu'un tableau ou une image soit coupé en deux.

/* Empêcher de couper un élément */
.no-break {
    page-break-inside: avoid;
    break-inside: avoid;
}

/* Forcer un saut de page avant */
.new-page {
    page-break-before: always;
    break-before: always;
}

/* Tables : répéter le header sur chaque page */
thead {
    display: table-header-group;
}
tr {
    page-break-inside: avoid;
}

Fusionner (Merge)

from pypdf import PdfWriter

merger = PdfWriter()

# Ajouter des fichiers
merger.append("intro.pdf")
merger.append("chapitre1.pdf")
merger.append("fin.pdf")

# Sauvegarder le résultat
merger.write("document_complet.pdf")
merger.close()

Lire et Extraire

from pypdf import PdfReader, PdfWriter

reader = PdfReader("source.pdf")
writer = PdfWriter()

# Extraire la page 1 seulement
page = reader.pages[0]
writer.add_page(page)

# Sauvegarder
with open("page1.pdf", "wb") as fp:
    writer.write(fp)

WeasyPrint Django View

import io
from django.http import FileResponse
from django.template.loader import render_to_string
from weasyprint import HTML

def pdf_view(request):
    # 1. Template -> HTML
    html_txt = render_to_string("doc.html", {})
    
    # 2. HTML -> PDF (Buffer)
    buf = io.BytesIO()
    HTML(string=html_txt, 
         base_url=request.build_absolute_uri()
    ).write_pdf(buf)
    buf.seek(0)
    
    # 3. Response
    return FileResponse(buf, filename="doc.pdf")

CSS Print Snippets

/* Format A4 */
@page { size: A4; margin: 2cm; }

/* Saut de page forcé */
.break { page-break-before: always; }

/* Ne pas couper au milieu */
.nobreak { page-break-inside: avoid; }

/* Numérotation */
@page {
  @bottom-center {
    content: counter(page);
  }
}