Aspose.PDF FOSS for TypeScript — الأسئلة المتكررة
الترخيص ومصدر مفتوح
ما هو نموذج الترخيص لـ Aspose.PDF FOSS for TypeScript؟
Aspose.PDF FOSS for TypeScript مُصدَر تحت رخصة MIT. الكود المصدري منشور على GitHub، ولا توجد علامة مائية للتقييم، ولا حد للاستخدام، ولا ملف رخصة منفصل لإدارته.
هل يمكنني استخدامه في منتجات تجارية؟
نعم. تسمح رخصة MIT بالاستخدام في المنتجات التجارية دون أية إتاوات أو متطلبات إسناد تتجاوز الحفاظ على إشعار الرخصة.
التثبيت والمتطلبات
كيف أقوم بتثبيت Aspose.PDF FOSS for TypeScript؟
git clone https://github.com/aspose-pdf-foss/Aspose.PDF-FOSS-for-TypeScript.git
cd Aspose.PDF-FOSS-for-TypeScript
npm install
npm run buildما إصدارات Node.js المدعومة؟
يتطلب Node.js 22 أو أحدث.
هل هناك أي تبعيات تشغيلية أخرى؟
لا. الحزمة خالية من التبعيات — Node.js هو المتطلب التشغيلي الوحيد.
دعم الصيغ
ما الصيغ التي يمكن لـ Aspose.PDF FOSS لـ TypeScript قراءتها وكتابتها؟
المكتبة تقرأ وتكتب PDF، ويمكنها أيضًا قراءة وكتابة Markdown وSVG وTIFF. كما يمكنها توليد مخرجات DOCX و HTML وPNG وEPUB، رغم أنها لا تقرأ تلك الصيغ الأربعة مرة أخرى.
هل يمكنني تحويل ملف PDF إلى Markdown أو HTML؟
نعم. Document.ToMarkdown() يُحوِّل مستندًا كاملاً إلى Markdown بنكهة GitHub، وDocument.ToHtml() يُحوِّله إلى HTML دلالي مستقل.
هل يمكنني تحويل صفحات PDF إلى صور؟
نعم. Page.ToImage() يُحوِّل صفحة واحدة إلى بايتات PNG نقطية، وPage.ToSvg() يُحوِّل الصفحة إلى SVG مستقل.
API Usage
ما هو نقطة الدخول الرئيسية للعمل مع مستند PDF؟
فئة Document. Document.OpenFile() يفتح ملف PDF من مسار ملف، Document.Open() يقبل بايتات في الذاكرة، وDocument.New() يبدأ مستندًا فارغًا.
كيف يمكنني إنشاء ملف PDF جديد من الصفر؟
استدعِ Document.New() باستخدام PageFormat، ثم أضف المحتوى باستخدام طرق مثل Page.AddText() وDocument.AddPage():
import { Document, PageFormat } from '@asposefoss/pdf';
const doc = Document.New(PageFormat.A4); // one blank A4 page
doc.Pages[0].AddText('Hello', 72, 720, { fontSize: 14 });
doc.AddPage(PageFormat.A4.landscape()); // append more as you go
doc.WriteTo('scratch.pdf');كيف يمكنني إضافة تعليقات توضيحية إلى صفحة؟
كل Page يكشف طرق التعليق التوضيحي مباشرةً، مثل Page.AddHighlight()، Page.AddTextNote()، Page.AddFreeText()، وPage.AddStamp(). الأنواع الفرعية المكتوبة مثل MarkupAnnotation وStampAnnotation تكشف عن طريقة Flatten() لدمج التعليق التوضيحي في محتوى الصفحة.
كيف يمكنني تشفير ملف PDF عند حفظه؟
مرّر خيار encrypt إلى Document.WriteTo() مع algorithm: 'aes256' | 'aes128' | 'rc4'، وزوج كلمة مرور المستخدم/المالك اختياري، وإعدادات Permissions دقيقة.
كيف يمكنني طمس المحتوى الحساس من ملف PDF؟
Document.Redact() وDocument.RedactText() يحددان ويزيلان بشكل دائم المناطق الحساسة أو النص المطابق؛ Page.ApplyRedactions() يطبق العلامات المضافة سابقًا. كلاهما يُكوَّن عبر RedactOptions.
القيود المعروفة
هل API مستقر؟
ليس بعد. الحزمة حالياً بالإصدار 0.1.0 وتخضع لتطوير نشط في مرحلة مبكرة، لذا قد تتطور توقيعات API قبل الإصدار المستقر.
هل تحتوي المكتبة على أي ميزات غير منفذة موثقة؟
حسب ما هو مكتوب الآن، لم يتم اكتشاف أي طرق غير منفذة أو نماذج أولية في شفرة المكتبة.
