مكتبة التعليقات التوضيحية مفتوحة المصدر بلغة JavaScript PDF
مكتبة JavaScript مجانية ومفتوحة المصدر لإضافة التعليقات التوضيحية إلى مستندات PDF.
ما هو PDFKit؟
PDFKit هي مكتبة JavaScript مجانية ومفتوحة المصدر لإضافة التعليقات التوضيحية مثل الروابط والنصوص المشطوبة والملاحظات التفاعلية إلى ملفات PDF. هناك نقطة مهمة يجب ملاحظتها: PDFKit لا يسمح بفتح أو تحرير مستندات PDF الموجودة، وبالتالي، لا يمكنك إضافة تعليقات توضيحية إلى مستندات PDF الموجودة، ولكن يمكنك إنشاء ملفات PDF من البداية باستخدام مكتبة PDFKit ثم إضافة تعليقات توضيحية إليها.
فيما يلي بعض ميزات التعليقات التوضيحية الرئيسية لـ PDFKit:
- إضافة الروابط:يمكّنك PDFKit من تضمين روابط قابلة للنقر داخل مستندات PDF الخاصة بك.
- إضافة نص مشطوب:يمكنك تطبيق تأثير الشطب على النص في ملفات PDF التي تم إنشاؤها باستخدام PDFKit.
- إضافة ملاحظات:يسمح لك PDFKit بإدراج تعليقات توضيحية تفاعلية في مستندات PDF الخاصة بك.
البدء باستخدام PDFKit
يمكنك تثبيت مكتبة PDFKit باستخدام مدير الحزم npm. ما عليك سوى كتابة الأمر التالي بعد تثبيت npm.
التثبيت باستخدام NPM
npm install pdfkit
إضافة تعليق على الرابط إلى ملف PDF
يمكننا إضافة ارتباطات تشعبية في مستندات PDF باستخدام ميزة التعليق على الارتباطات في مكتبة PDFKit. نوفر إحداثيات X وY، بالإضافة إلى ارتفاع وعرض النص، بالإضافة إلى الارتباط لجعله ارتباطًا تشعبيًا باستخدام وظيفة link كما هو موضح في مقتطف التعليمات البرمجية أدناه:
الناتج
يعرض الإخراج التالي مستند PDF الذي يحتوي على ارتباط تشعبي:
إضافة نص مشطوب إلى ملف PDF
يمكننا إضافة نص مشطوب إلى مستند PDF باستخدام الدالتين moveTo وlineTo المقدمتين من مكتبة PDFKit. تضع الدالة moveTo المؤشر عند نقطة بداية السطر، وتستخدم الدالة lineTo لرسم خط من نقطة البداية إلى نهاية النص المراد شطبه. راجع مقتطف التعليمات البرمجية أدناه للحصول على التفاصيل:
الناتج
تعرض لقطة الشاشة الناتجة مستند PDF مع النص المشطوب المضاف إليه.
إضافة ملاحظات تفاعلية إلى ملف PDF
يمكننا إضافة ملاحظات تفاعلية إلى مستندات PDF، مما يجعلها أكثر جاذبية للقراء. يتم عرض هذه الملاحظات التفاعلية كأيقونات داخل ملف PDF، وعندما يحوم المستخدمون فوقها، فإنها تكشف عن محتوى منبثق. لديك سيطرة كاملة على موضعها وأبعادها، وضبط إحداثيات X وY والارتفاع والعرض حسب الحاجة. جرب مقتطف التعليمات البرمجية أدناه لإضافة ملاحظة تفاعلية إلى ملف PDF:
الناتج
تُظهر لقطة الشاشة التالية مستند PDF مع الملاحظة التفاعلية المضافة إليه:
وعندما نمرر المؤشر فوق الرمز الأصفر تظهر الملاحظة كاملة كما يلي:
خاتمة
في الختام، PDFKit عبارة عن مكتبة JavaScript مجانية لإضافة التعليقات التوضيحية إلى مستندات PDF. وهي توفر طريقة سهلة الوصول وسهلة الاستخدام لإضافة التعليقات التوضيحية.
على الرغم من تفوق PDFKit في العديد من المجالات، فمن المهم ملاحظة أن وظيفة goTo لا تعمل كما هو متوقع. بالإضافة إلى ذلك، قد تؤدي وظيفة note إلى إدخال مسافات إضافية في المحتوى، مما قد يؤدي إلى نتائج غير مرغوب فيها. وعلاوة على ذلك، وكما ذكرنا سابقًا، يمكننا إضافة التعليقات التوضيحية إلى مستندات PDF الجديدة فقط (وليس ملفات PDF الموجودة) التي تم إنشاؤها باستخدام PDFKit. وقد تثير هذه التناقضات تساؤلات حول مدى ملاءمتها للمهام الآلية. ومع ذلك، تظل PDFKit أداة قيمة للتعليق التوضيحي اليدوي وتخصيص المستندات.