Dokumen ini menjelaskan bagaimana mengeluarkan berkas-berkas PDF secara dinamis menggunakan tampilan Django. Ini dibuat mungkin oleh istimewa, sumber terbuka pustaka PDF Python ReportLab.
\nKeuntungan dari membangkitkan berkas-berkas PDF secara dinamis adalah bahwa anda dapat membuat penyesuaian PDF untuk tujuan berbeda -- katakan, untuk pengguna berbeda atau potongan berbeda dari isi.
\nSebagai contoh, Django telah digunakan pada kusports.com untuk membangkitkan penyesuaian, kurung turnamen NCAA ramah-mencetak, sebagai berkas-berkas PDF, untuk orang yang ikut serta di perlombaan March Madness.
\nPustaka ReportLab adalah available on PyPI. Sebuah user guide (tidak secara kebetulan, sebuah berkas PDF) juga tersedia untuk unduhan. Anda dapat memasang ReportLab dengan pip:
$ pip install reportlab\nUjikan pemasangan anda dengan mengimpornya dalam penterjemah interaktif Python:
\n>>> import reportlab\nJika perintah itu tidak menimbulkan kesalahan apapun, pemasangan bekerja.
\nKunci untuk membangkitkan PDF secara dinamis dengan Django adalah bahwa API ReportLab bertindak pada obyek seperti-berkas, dan obyek HttpResponse Django adalah obyek seperti-berkas.
Ini adalah contoh "Hello World"
\nfrom django.http import HttpResponse\nfrom reportlab.pdfgen import canvas\n\ndef some_view(request):\n # Create the HttpResponse object with the appropriate PDF headers.\n response = HttpResponse(content_type='application/pdf')\n response['Content-Disposition'] = 'attachment; filename="somefilename.pdf"'\n\n # Create the PDF object, using the response object as its "file."\n p = canvas.Canvas(response)\n\n # Draw things on the PDF. Here's where the PDF generation happens.\n # See the ReportLab documentation for the full list of functionality.\n p.drawString(100, 100, "Hello world.")\n\n # Close the PDF object cleanly, and we're done.\n p.showPage()\n p.save()\n return response\nKode dan komentar seharunya sudah cukup jelas, tetapi sedikit hal pantas disebut:
\nTanggapan mendapatkan jenis MIME khusus, application/pdf. Ini memberitahu perambah bahwa dokumen adalah sebuah berkas PDF, daripada sebuah berkas HTML. Jika anda mengosongkan ini, perambah akan kemungkinan pentafsirkan keluaran sebagai HTML, yang akan menghasilkan buruk, uraian berbelit-belit yang menakutkan dalam jendela perambah.
Tanggapan mendapatkan sebuah tambahan kepala Content-Disposition, yang mengandung nama dari berkas PDF. Nama berkas ini berubah-ubah: Panggil dia kapanpun anda ingin. Dia akan digunakan oleh perambah dalam dialog "Save as...", dll.
Kepala Content-Disposition dimulai dengan 'attachment; ' dalam contoh ini. Ini memaksa perambah Jaringan memunculkan kotak dialog menunjuk/memastikan bagaimana menangani dokumen bahkan jika nilai awal disetel pada mesin. Jika anda meninggalkan 'attachment; ', perambah akan menangani PDF menggunakan program/tambahan apapun mereka telah konfigurasikan digunakan untuk PDF. Ini adalah apa kode kelihatan seperti:
response['Content-Disposition'] = 'filename="somefilename.pdf"'\nMengaitkan kedalam API ReportLab adalah mudah: Cukup lewatkan response sebagai argumen pertama pada canvas.Canvas. Kelas Canvas kecuali obyek seperti-berkas, dan obyek HttpResponse sesuai dengan tagihan.
Catat bahwa semua cara pembangkitan-PDF berikutnya dipanggil pada obyek PDF (dalam kasus ini, p) -- bukan pada response.
Akhirnya, sangatlah penting memanggil showPage() dan save() pada berkas PDF.
Jika anda sedang membuat dokumen PDF rumit dengan ReportLab, pertimbangkan menggunakan pustaka io sebagai tempat menampung sementara untu berkas PDF anda. Pustaka ini menyediakan antarmuka obyek seperti-berkas yang khususnya efisien. Ini adalah contoh "Hello World" diatas ditulis kembali untuk menggunakan io:
from io import BytesIO\nfrom reportlab.pdfgen import canvas\nfrom django.http import HttpResponse\n\ndef some_view(request):\n # Create the HttpResponse object with the appropriate PDF headers.\n response = HttpResponse(content_type='application/pdf')\n response['Content-Disposition'] = 'attachment; filename="somefilename.pdf"'\n\n buffer = BytesIO()\n\n # Create the PDF object, using the BytesIO object as its "file."\n p = canvas.Canvas(buffer)\n\n # Draw things on the PDF. Here's where the PDF generation happens.\n # See the ReportLab documentation for the full list of functionality.\n p.drawString(100, 100, "Hello world.")\n\n # Close the PDF object cleanly.\n p.showPage()\n p.save()\n\n # Get the value of the BytesIO buffer and write it to the response.\n pdf = buffer.getvalue()\n buffer.close()\n response.write(pdf)\n return response\nPerhatikan bahwa tidak ada banyak di contoh ini yaitu spesifik-PDF -- cukup bit menggunakan reportlab. Anda dapat menggunakan teknik mirip untuk membangkitkan bentuk berubah-ubah yang anda dapat temukan pustaka Python. Juga lihat Mengeluarkan CSV dengan Django untuk contoh lainnya dan beberapa teknik anda dapat gunakan ketika membangkitkan bentuk berbasis-teks.