مكتبة التعليقات التوضيحية لـPython PDF مفتوحة المصدر
جرب مكتبة Python المجانية والمفتوحة المصدر لإضافة واستخراج التعليقات التوضيحية من مستندات PDF.
ما هو pypdf؟
Pypdf هي مكتبة بايثون مجانية ومفتوحة المصدر معروفة بمجموعة متنوعة من الميزات للتعامل مع مستندات PDF في بيئة بايثون. هذه الأداة مفيدة للعديد من عمليات معالجة ملفات PDF ولكننا سنركز على ميزاتها المتعلقة بالتعليقات التوضيحية في هذه المراجعة.
تشمل الميزات البارزة لـ pypdf المتعلقة بالتعليقات التوضيحية ما يلي:
- إضافة تعليقات توضيحية للأشكال: يمكننا رسم أشكال مثل الخطوط والمستطيلات وعلامات الحذف والمضلعات وما إلى ذلك في مناطق محددة من صفحات PDF كتعليقات توضيحية.
- إضافة تعليقات توضيحية نصية: يمكننا إضافة تعليقات توضيحية نصية إلى مواضع معينة في صفحات PDF.
- إضافة تعليقات توضيحية للارتباط: من الممكن أيضًا إضافة تعليقات توضيحية للارتباط (مثل الارتباط التشعبي) إلى مستندات PDF.
- استخراج التعليقات التوضيحية: يمكننا تكرار واستخراج المعلومات حول جميع التعليقات التوضيحية في مستند PDF باستخدام مكتبة pypdf.
الشروع في العمل مع pypdf
تحتاج إلى إصدار Python 3.6.0 أو أعلى لتثبيت pypdf واستخدامه. لذا، قم أولاً بتثبيت Python ثم استخدم الأوامر أدناه لتثبيت pypdf على جهازك باستخدام pip والبيئة الافتراضية.
لينكس
python3 -m venv venv
source venv/bin/activate
pip install pypdf
ماك
python -m venv venv
source venv/bin/activate
pip install pypdf
شبابيك
python3 -m venv venv
venv\Scripts\activate.bat
pip install pypdf
إضافة تعليق توضيحي مستطيل إلى PDF
يمكننا إضافة تعليقات توضيحية مستطيلة إلى مستندات PDF باستخدام مكتبة pypdf. سوف نستخدم فئة المستطيل من وحدة pypdf.annotations من مكتبة pypdf لتعريف المستطيل. بعد ذلك سوف نستخدم طريقة add_annotations لفئة PDFWriter لإضافة تعليق توضيحي مستطيل إلى ملف PDF.
تحقق من مقتطف الكود أدناه للحصول على التفاصيل:
انتاج
في لقطة الشاشة أدناه، يمكنك رؤية إضافة المستطيل للتعليق على الكلمة المصدر المفتوح:
إضافة تعليق نصي إلى PDF
نقوم بإنشاء تعليقات توضيحية نصية باستخدام فئة Text من وحدة pypdf.annotations في مكتبة pypdf. بعد ذلك يمكننا استخدام طريقة add_annotations لفئة PDFWriter من مكتبة pypdf لإضافة تعليق توضيحي إلى ملف PDF. تتم إضافة التعليق التوضيحي النصي كأيقونة يتم توسيعها وإظهار النص عند النقر فوق الأيقونة. تحقق من مقتطف الكود أدناه للحصول على التفاصيل:
انتاج
كما نرى في تسجيل الشاشة أدناه، يضيف الكود أعلاه رمزًا إلى ملف PDF في الموضع المحدد والذي يعرض التعليق التوضيحي للنص عند النقر فوق الرمز:
إضافة تعليق توضيحي للارتباط إلى ملف PDF
يتم إنشاء التعليقات التوضيحية للرابط باستخدام فئة الرابط من الوحدة النمطية pypdf.annotations. ومع ذلك، فإن المشكلة المتعلقة بالتعليق التوضيحي للرابط هي أنه يضيف الرابط فقط ولكنه غير مرئي. لمعالجة هذه المشكلة، سنقوم بدمج مستطيل باستخدام فئة المستطيل من وحدة pypdf.annotations كما أوضحنا سابقًا. بهذه الطريقة، يمكن للمستخدم تحديد الموقع الذي تمت إضافة التعليق التوضيحي للرابط فيه بشكل مرئي. تحقق من مقتطف الشفرة أدناه لفهم أفضل:
انتاج
كما نرى في الإخراج، يعمل المستطيل كمنطقة، عند النقر عليها، تعيد توجيه المستخدم إلى الرابط المحدد.
استخراج التعليقات التوضيحية من PDF
يمكننا استخراج التعليقات التوضيحية من ملف PDF باستخدام مكتبة pypdf. نقوم بمراجعة جميع التعليقات التوضيحية على صفحات PDF ثم نستخدم طريقة get_object للحصول على كائن التعليق التوضيحي. ثم نستخرج المعلومات ذات الصلة من الكائن. تحقق من مقتطف الكود أدناه للحصول على التفاصيل:
انتاج
كما نرى في لقطة الشاشة أدناه، أعاد البرنامج نوع التعليق التوضيحي وإحداثيات التعليقات التوضيحية في مستند PDF:
خاتمة
يمكّن Pypdf مطوري Python من إضافة أنواع مختلفة من التعليقات التوضيحية إلى ملفات PDF والوصول إلى المعلومات الأساسية حول التعليقات التوضيحية، مثل نوعها وموقعها، مما يجعلها خيارًا عمليًا للمهام التي تتطلب إضافة التعليقات التوضيحية واستخراج البيانات حول التعليقات التوضيحية.