PDFKit JavaScript (Node.js) गाइड: उदाहरणों के साथ पूर्ण ट्यूटोरियल

PDFKit क्या है और इसकी आवश्यकता क्यों है?

PDFKit JavaScript (Node.js) के लिए एक शक्तिशाली और लचीली लाइब्रेरी है, जो प्रोग्रामेटिक रूप से PDF दस्तावेज़ बनाने के लिए डिज़ाइन की गई है। यह डेवलपर्स को टेक्स्ट, इमेज, टेबल, वेक्टर ग्राफिक्स, एनोटेशन और फॉर्म जैसी समृद्ध सामग्री के साथ जटिल, मल्टी-पेज PDF फ़ाइलें जनरेट करने की अनुमति देती है। कई अन्य लाइब्रेरीज़ के विपरीत, PDFKit निम्न स्तर पर काम करती है, जो दस्तावेज़ के हर पहलू पर पूर्ण नियंत्रण प्रदान करती है - एलिमेंट्स के स्थान निर्देशांक से लेकर फ़ॉन्ट एम्बेड करने तक।

PDFKit के मुख्य उपयोग के मामले:

• रिपोर्ट और इनवॉइस जनरेट करना: डेटाबेस या API से डेटा के आधार पर डायनामिक PDF दस्तावेज़ बनाना।
• चालान और रसीदें बनाना: ऑनलाइन स्टोर और अकाउंटिंग सिस्टम के लिए स्वचालित रूप से दस्तावेज़ जनरेट करना।
• प्रमाणपत्र और डिप्लोमा तैयार करना: प्रत्येक प्राप्तकर्ता के लिए अद्वितीय डेटा के साथ वैयक्तिकृत दस्तावेज़ जनरेट करना।
• डेटा निर्यात: प्रिंट या आर्काइव करने के लिए वेब पेजों, टेबल या ग्राफ़ को PDF फ़ॉर्मेट में बदलना।
• ई-बुक और गाइड बनाना: विषय-सूची और बुकमार्क के साथ मल्टी-पेज दस्तावेज़ों की प्रोग्रामेटिक लेआउटिंग।

PDFKit उन डेवलपर्स की पसंद है जिन्हें बाहरी निर्भरताओं (जैसे LibreOffice या wkhtmltopdf इंस्टॉल करने की आवश्यकता नहीं) के बिना प्रदर्शन, लचीलापन और पूर्ण नियंत्रण चाहिए।

PDFKit इंस्टॉलेशन

PDFKit npm पैकेज मैनेजर के माध्यम से वितरित की जाती है। इंस्टॉल करने के लिए, अपने प्रोजेक्ट की रूट डायरेक्टरी में टर्मिनल में निम्न कमांड चलाएँ:

npm install pdfkit

इंस्टॉलेशन के बाद, लाइब्रेरी आपके कोड में इम्पोर्ट करने के लिए उपलब्ध हो जाएगी। किसी अतिरिक्त निर्भरता की आवश्यकता नहीं है।

त्वरित शुरुआत: अपना पहला PDF दस्तावेज़ बनाना

आइए "Hello, World!" टेक्स्ट के साथ एक सरल PDF फ़ाइल बनाएँ।

const PDFDocument = require('pdfkit');
const fs = require('fs');

// एक नया PDF दस्तावेज़ बनाएँ
const doc = new PDFDocument();

// परिणाम लिखने के लिए स्ट्रीम निर्दिष्ट करें
doc.pipe(fs.createWriteStream('hello_world.pdf'));

// पेज पर टेक्स्ट जोड़ें
doc.fontSize(25)
   .text('Hello, World!', 100, 100);

// दस्तावेज़ को फाइनल करें और स्ट्रीम को समाप्त करें
doc.end();

console.log('PDF फ़ाइल "hello_world.pdf" सफलतापूर्वक बन गई!');

इस कोड को चलाने के बाद, उसी फ़ोल्डर में "Hello, World!" टेक्स्ट के साथ hello_world.pdf फ़ाइल दिखाई देगी।

PDFKit के मुख्य तरीके और फ़ंक्शन

PDFKit एक व्यापक API प्रदान करता है। नीचे विस्तृत विवरण और उदाहरणों के साथ 10 प्रमुख तरीके दिए गए हैं।

1. text(text, x, y, options)

विवरण: दस्तावेज़ में टेक्स्ट जोड़ता है। यह टेक्स्ट के साथ काम करने की मुख्य विधि है। यह लाइन रैपिंग, अलाइनमेंट, इंडेंटेशन और स्टाइलिंग को सपोर्ट करती है।

पैरामीटर:

• text (String) — जोड़ने के लिए टेक्स्ट।
• x (Number, वैकल्पिक) — X निर्देशांक। यदि निर्दिष्ट नहीं है, तो टेक्स्ट वर्तमान स्थिति से जारी रहता है।
• y (Number, वैकल्पिक) — Y निर्देशांक। यदि निर्दिष्ट नहीं है, तो टेक्स्ट वर्तमान स्थिति से जारी रहता है।
• options (Object, वैकल्पिक) — सेटिंग्स वाला ऑब्जेक्ट:
  • align (String) — अलाइनमेंट: 'left', 'center', 'right', 'justify'।
  • indent (Number) — पहली पंक्ति का इंडेंटेशन।
  • paragraphGap (Number) — पैराग्राफ के बीच का गैप।
  • lineGap (Number) — लाइनों के बीच का अंतर।
  • width (Number) — टेक्स्ट ब्लॉक की चौड़ाई (लाइन रैपिंग के लिए)।
  • height (Number) — टेक्स्ट ब्लॉक की ऊँचाई।
  • underline (Boolean) — अंडरलाइन।