مكتبة التعليقات التوضيحية مفتوحة المصدر لـPython PDF
جرب مكتبة Python المجانية والمفتوحة المصدر هذه لإضافة واستخراج التعليقات التوضيحية من مستندات PDF.
ما هو pypdf؟
Pypdf هي مكتبة بايثون مجانية ومفتوحة المصدر معروفة بمجموعتها المتنوعة من الميزات للتعامل مع مستندات PDF في بيئة بايثون. هذه الأداة مفيدة في التعامل مع ملفات PDF المختلفة ولكننا سنركز على ميزاتها المتعلقة بالتعليق التوضيحي في هذه المراجعة.
تتضمن الميزات البارزة لـ pypdf المتعلقة بالتعليقات التوضيحية ما يلي:
- إضافة تعليقات توضيحية للأشكال: يمكننا رسم أشكال مثل الخطوط والمستطيلات والقطع الناقص والمضلعات وما إلى ذلك على مناطق محددة من صفحات PDF كتعليقات توضيحية.
- إضافة تعليقات نصية: يمكننا إضافة تعليقات نصية إلى مواضع محددة من صفحات PDF.
- إضافة تعليقات الارتباط: من الممكن أيضًا إضافة تعليقات الارتباط (مثل الارتباط التشعبي) إلى مستندات PDF.
- استخراج التعليقات التوضيحية: يمكننا تكرار واستخراج المعلومات حول جميع التعليقات التوضيحية في مستند PDF باستخدام مكتبة pypdf.
البدء باستخدام pypdf
تحتاج إلى إصدار Python 3.6.0 أو أعلى لتثبيت واستخدام pypdf. لذا، قم أولاً بتثبيت Python ثم استخدم الأوامر أدناه لتثبيت pypdf على جهازك باستخدام pip وvirtual Environment.
لينكس
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. سنستخدم فئة Rectangle من وحدة pypdf.annotations من مكتبة pypdf لتحديد المستطيل. بعد ذلك سنستخدم طريقة add_annotations من فئة PDFWriter لإضافة تعليقات توضيحية على شكل مستطيل إلى ملف PDF.
تحقق من مقتطف الكود أدناه للحصول على التفاصيل:
الناتج
في لقطة الشاشة أدناه، يمكنك أن ترى أنه تمت إضافة المستطيل لشرح الكلمة مفتوحة المصدر:
إضافة تعليق نصي إلى ملف PDF
نقوم بإنشاء تعليقات توضيحية نصية باستخدام فئة Text من وحدة pypdf.annotations من مكتبة pypdf. بعد ذلك يمكننا استخدام طريقة add_annotations من فئة PDFWriter من مكتبة pypdf لإضافة تعليقات توضيحية إلى ملف PDF. تتم إضافة التعليقات التوضيحية النصية كأيقونة تتوسع وتُظهر النص عند النقر فوق الأيقونة. راجع مقتطف التعليمات البرمجية أدناه للحصول على التفاصيل:
الناتج
كما يمكننا أن نرى في لقطة الشاشة أدناه، يضيف الكود أعلاه أيقونة إلى ملف PDF في موضع محدد والذي يعرض تعليقًا نصيًا عند النقر فوق الأيقونة:
إضافة تعليق على الرابط إلى ملف PDF
يتم إنشاء تعليقات الارتباط باستخدام فئة Link من وحدة pypdf.annotations. ومع ذلك، فإن المشكلة مع تعليق الارتباط هي أنه يضيف الرابط فقط ولكنه غير مرئي. لمعالجة هذه المشكلة، سنقوم بدمج مستطيل باستخدام فئة Rectangle من وحدة pypdf.annotations كما شرحنا سابقًا. بهذه الطريقة، يمكن للمستخدم تحديد الموقع الذي تمت إضافة تعليق الارتباط فيه بصريًا. تحقق من مقتطف التعليمات البرمجية أدناه لفهم أفضل:
الناتج
كما نرى في الناتج، فإن المستطيل بمثابة منطقة، عند النقر عليها، يتم إعادة توجيه المستخدم إلى الرابط المحدد.
استخراج التعليقات التوضيحية من ملف PDF
يمكننا استخراج التعليقات التوضيحية من ملف PDF باستخدام مكتبة pypdf. نكرر كل التعليقات التوضيحية على صفحات PDF ثم نستخدم طريقة get_object للحصول على كائن التعليقات التوضيحية. ثم نستخرج المعلومات ذات الصلة من الكائن. راجع مقتطف التعليمات البرمجية أدناه للحصول على التفاصيل:
الناتج
كما يمكننا أن نرى في لقطة الشاشة أدناه، قام البرنامج بإرجاع نوع التعليقات التوضيحية وإحداثيات التعليقات التوضيحية في مستند PDF:
خاتمة
يتيح Pypdf لمطوري Python إضافة أنواع مختلفة من التعليقات التوضيحية إلى ملفات PDF والوصول إلى معلومات أساسية حول التعليقات التوضيحية، مثل نوعها وموقعها، مما يجعله خيارًا عمليًا للمهام التي تتطلب إضافة تعليقات توضيحية واستخراج بيانات حول التعليقات التوضيحية.