Aspose.PDF FOSS for TypeScript — سوالات متداول
مجوزدهی و منبع باز
مدل مجوزدهی برای Aspose.PDF FOSS برای TypeScript چیست؟
Aspose.PDF FOSS برای TypeScript تحت مجوز MIT منتشر شده است. کد منبع در GitHub منتشر شده و هیچ علامت آبشاری ارزیابی، محدودیت استفاده یا فایل مجوز جداگانهای برای مدیریت وجود ندارد.
آیا میتوانم آن را در محصولات تجاری استفاده کنم؟
بله. مجوز MIT اجازه استفاده در محصولات تجاری را بدون حقالامتیاز یا الزامات انتساب، به جز حفظ اعلان مجوز، میدهد.
نصب و پیشنیازها
چگونه Aspose.PDF FOSS برای 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 ممکن است قبل از انتشار نسخهٔ پایدار تغییر کنند.
آیا کتابخانه ویژگیهای مستند شدهٔ پیادهسازینشدهای دارد؟
تا زمان نوشتن این متن، هیچ متد پیادهسازینشده یا استاب در منبع کتابخانه شناسایی نشد.