OpenPDF

OpenPDF هي مكتبة Java مفتوحة المصدر لملفات PDF

OpenPDF هي مكتبة Java لإنشاء وتحرير ملفات PDF باستخدام ترخيص LGPL وMPL مفتوح المصدر. OpenPDF هو خليفة LGPL/MPL مفتوح المصدر لـ iText، ويعتمد على بعض تشعبات علامة iText 4 svn. نحن نرحب بمساهمات المطورين الآخرين. لا تتردد في إرسال طلبات السحب وتقارير الأخطاء إلى مستودع GitHub هذا.

تم إصدار الإصدار 2.0.3 من OpenPDF بتاريخ 07-08-2024

احصل على الإصدار 2.0.3 هنا: https://github.com/LibrePDF/OpenPDF/releases/tag/2.0.3

يرجى ملاحظة: قد يستغرق تحديث المستودعات مثل Maven Central وغيرها بضعة أيام.

إصدارات أخرى

• OpenPDF 1.4.2 (الإصدار 30/03/2024)
• OpenPDF 1.3.43 (الإصدار 29-03-2024)
• الإصدارات السابقة

سمات

تتضمن بعض ميزات OpenPDF ما يلي:

• إنشاء ملفات PDF: يمكنك استخدام OpenPDF لإنشاء مستندات PDF جديدة من البداية.
• معالجة ملفات PDF الموجودة: يتيح لك OpenPDF تعديل مستندات PDF الموجودة عن طريق إضافة أو إزالة الصفحات وتعديل النص والمزيد.
• دعم النص والخط: يمكنك إضافة نص إلى مستندات PDF باستخدام خطوط وأنماط مختلفة، واستخراج النص من ملفات PDF.
• الرسومات والصور: يدعم OpenPDF إضافة الصور والرسومات إلى ملفات PDF.
• دعم الجداول: تسهل المكتبة إنشاء الجداول في مستندات PDF.
• التشفير: يمكنك تشفير مستندات PDF لأغراض أمنية.
• تخطيط الصفحة: يتيح لك OpenPDF ضبط حجم الصفحة واتجاهها وخصائص التخطيط الأخرى.

استخدم OpenPDF كتبعية لـ Maven

أضف هذا إلى ملف pom.xml الخاص بك لاستخدام أحدث إصدار من OpenPDF:

< dependency >
  < groupId >com.github.librepdf</ groupId >
  < artifactId >openpdf</ artifactId >
  < version >2.0.3</ version >
</ dependency >

رخصة

يستخدم OpenPDF ترخيصًا مزدوجًا: عند استخدام المكتبة، يمكنك اختيار إما Mozilla Public License الإصدار 2.0 أو GNU Lesser General Public License 2.1.

معرف ترخيص SPDX لترخيص OpenPDF هو MPL-2.0 OR LGPL-2.1+

رخصة جنو العامة الصغرى (LGPL)، الإصدار 2.1

للحصول على شرح قصير، راجع https://en.wikipedia.org/wiki/GNU_Lesser_general_Public_License

إصدار رخصة موزيلا العامة 2.0

للحصول على شرح قصير، راجع https://en.wikipedia.org/wiki/Mozilla_Public_License

يمكنك أيضًا العثور على شرح جيد لهذه التراخيص ضمن https://itsfoss.com/open-source-licenses-explained/

نريد أن يتكون OpenPDF من كود المصدر المرخص بشكل ثابت مع تراخيص LGPL وMPL فقط. وهذا يعني أيضًا أن أي مساهمات جديدة في المشروع يجب أن تحتوي على ترخيص LGPL وMPL مزدوج فقط.

التوثيق

• أمثلة
• JavaDoc
• البرنامج التعليمي (ويكي، العمل قيد التقدم)
• الهجرة من iText، ودعم TIFF

خلفية

OpenPDF هو برنامج مفتوح المصدر بترخيص LGPL وMPL. إنها شوكة من الإصدار 4 من iText، وبشكل أكثر تحديدًا علامة iText svn 4.2.0، والتي تمت استضافتها علنًا على sourceforge مع رؤوس ترخيص LGPL وMPL في كود المصدر، ومستندات ترخيص LGPL وMPL في مستودع svn. بدءًا من الإصدار 5.0 من iText، انتقل المطورون إلى AGPL لتحسين قدرتهم على بيع التراخيص التجارية.

أسلاف OpenPDF في GitHub (بترتيب الشوكة):

1. @rtfarte / OpenPDF - أصل LibrePDF/OpenPDF
2. @kulatamicuda / iText-4.2.0
3. @دافيددوراند/iText-4.2.0
4. @ymasory / iText-4.2.0 - الأصل الأصلي على GitHub

المشاريع باستخدام OpenPDF

• إطار الربيع
• طبق طائر
• خدمة التوقيع الرقمي
• التقاء تصدير PDF
• OpenCMS وNuxeo Web Framework ومكتبة QR Invoice Library والعديد من التطبيقات التجارية مغلقة المصدر أيضًا.
• القائمة الكاملة هنا: القطع الأثرية باستخدام OpenPDF

أندرويد

يمكن استخدام OpenPDF مع Android، مزيد من المعلومات هنا: دعم Android

المساهمة

الافراج عن كلاب الصيد! الرجاء ارسال كافة طلبات السحب. تأكد من إمكانية إصدار مساهماتك باستخدام ترخيص LGPL وMPL المزدوج. على وجه الخصوص، يجب أن تحتوي طلبات السحب إلى مشروع OpenPDF فقط على التعليمات البرمجية التي كتبتها بنفسك. لن يتم قبول كود GPL أو AGPL المرخص.

للمساهمة بالكود في مشروع OpenPDF، يجب أن يحتوي حسابك على GitHub على اسمك الحقيقي، حتى نتمكن من التحقق من هويتك. وذلك لضمان الثقة والأمن والنزاهة في مشروع OpenPDF، ولمنع الحوادث الأمنية مثل "XZ Utils backdoor". إن معرفة الاسم الحقيقي للمساهمين سيؤدي أيضًا إلى تحديد ومنع تضارب المصالح.

مزيد من التفاصيل: المساهمة

نمط الترميز

• نمط المسافة البادئة للكود هو 4 مسافات. الحد الأقصى لطول السطر هو 120 حرفًا.
• حاول بشكل عام الحفاظ على نمط الترميز في الملف الذي تقوم بتعديله.

التبعيات

التبعيات المطلوبة

لدينا الآن إصدارات مختلفة من OpenPDF، وهي تتطلب إصدارات مختلفة من Java:

• يتطلب فرع 2.0.x Java 17 أو إصدار أحدث.
• يتطلب الفرع 1.4.x وجود Java 11 أو إصدار أحدث.
• يتطلب الفرع 1.3.x وجود Java 8 أو إصدار أحدث.
• يتم إصدار بعض إصدارات 1.3 باستخدام Java 11 كحد أدنى من المتطلبات، ولكننا قمنا بإعادة هذا إلى Java 8 كحد أدنى من المتطلبات.
• إصدارات OpenPDF 2.0.x: نعمل على تحديث مكتبة OpenPDF لـ Java 17+.

خطوط UTF-8

اعتبارًا من 1.3.21، انتقلت خطوط تحرير UTF-8 إلى الوحدة النمطية الخاصة بها، لتقليل حجم جرة OpenPDF. إذا كنت تريد استخدام خطوط UTF-8 المجمعة، فيرجى إضافة التبعية التالية إلى مشروعك واستخدام الفئة org.librepdf.openpdf.fonts.Liberation .

< dependency >
  < groupId >com.github.librepdf</ groupId >
  < artifactId >openpdf-fonts-extra</ artifactId >
  < version >${openpdf.version}</ version >
</ dependency >

دعم استبدال الحروف الرسومية المعقدة/استبدال الأربطة

يدعم OpenPDF استبدال الحروف الرسومية وهو أمر مطلوب للعرض الصحيح لمتطلبات استبدال الحروف المركبة. مطلوب تبعية FOP لتمكين هذه الميزة. راجع الويكي التالي للحصول على التفاصيل: ويكي

دعم تخطيط OpenType وتحديد موضع الحروف الرسومية وإعادة الترتيب والاستبدال

يدعم OpenPDF تخطيط OpenType، وتحديد موضع الحروف الرسومية، وإعادة الترتيب، والاستبدال، وهو أمر مطلوب على سبيل المثال لتحديد موضع العلامات بشكل صحيح، وعرض النصوص غير اللاتينية والتي تكتب من اليمين إلى اليسار. يدعم OpenPDF DIN 91379. راجع: wiki

خياري

• BouncyCastle (يتم استخدام BouncyCastle لتوقيع ملفات PDF، لذا فهي تبعية موصى بها)
  • الموفر ( org.bouncycastle:bcprov-jdk18on أو org.bouncycastle:bcprov-ext-jdk18on اعتمادًا على الخوارزمية التي تستخدمها)
  • PKIX/CMS ( org.bouncycastle:bcpkix-jdk18on )
• أباتشي FOP ( org.apache.xmlgraphics:fop )
• يرجى الرجوع إلى pom.xml الخاص بنا لمعرفة الإصدار المطلوب.

الاعتمادات

يرجى الاطلاع على Contributors.md.