EmbedPDF 3.0 از موتور تا رابط کاربری بازنویسی شد
خلاصهٔ کاملتر
تیم CloudPDF نسخهٔ 3.0 کتابخونهٔ EmbedPDF رو منتشر کرده و میگه کل پروژه از موتور PDF به بالا دوباره ساخته شده. سه راه برای استفاده ازش هست. اول یه نمایشگر آماده که با یه تگ تو HTML ساده، React، Vue، Svelte یا Angular اضافه میشه و با چند خط تنظیمات شخصیسازی میشه. دوم کامپوننتهای headless (یعنی منطق آماده بدون ظاهر، که UIش رو خودت میسازی) با همون پلاگینها. سوم خود EmbedPDF Engine برای باز کردن، خوندن، تغییر و رندر PDF از داخل کد.
موتورش تو مرورگر روی WebAssembly اجرا میشه و تو Node از نسخههای native برای macOS، لینوکس و ویندوز استفاده میکنه. یعنی همون کد پردازش PDF رو میشه هم سمت کاربر و هم سمت سرور به کار برد.
طبق یادداشت انتشار، همهٔ امکانات نمایشگر از اول روشنن و هر کدوم قابل خاموش شدنه:
- حاشیهنویسی: هایلایت، زیرخط، خط زدن، نقاشی، یادداشت، شکل، مهر و کامنت با جواب
- فرم و امضا: پر کردن و ساختن فرم، امضای کشیده یا تایپشده یا آپلودی، و بررسی امضاها
- Redaction: علامت زدن متن و ناحیه و حذف همیشگیشون از فایل
- اندازهگیری فاصله، محیط و مساحت با مقیاس نقشه
- مدیریت صفحهها: چرخوندن، جابهجایی، اضافه و حذف، همه با قابلیت undo
نصبش با npm install @embedpdf/viewer انجام میشه و برای فریمورکها هم پکیجهایی مثل @embedpdf/viewer-react و @embedpdf/viewer-vue هست. کسایی که از 2.x میان باید حواسشون باشه که اسم پکیجها عوض شده: @embedpdf/snippet و @embedpdf/react-pdf-viewer و بقیه جاشون رو به @embedpdf/viewer و پکیجهای فریمورکیش دادن. یه راهنمای مهاجرت هم هست که هر پکیج و کلید تنظیمات 2.x رو به معادل 3.0 وصل میکنه. نسخهٔ 2.x همچنان با تگ npm v2-latest آپدیت میگیره.
شرکت CloudPDF که سازندهٔ EmbedPDF هست، پکیجهای @cloudpdf رو هم منتشر کرده: همین نمایشگر برای سندهایی که روی سرور CloudPDF نگه داشته میشن، خود سرور به شکل image داکر و Helm chart، و یه SDK برای APIش.
نکات کلیدی:
- EmbedPDF 3.0 از موتور تا UI بازنویسی شده و سه حالت viewer، headless و engine داره
- موتور تو مرورگر با WebAssembly و تو Node با نسخهٔ native برای macOS، لینوکس و ویندوز اجرا میشه
- پکیج اصلی حالا @embedpdf/viewer هست و پکیجهای 2.x مثل @embedpdf/snippet جایگزین شدن
- نسخهٔ 2.x با تگ npm v2-latest همچنان اصلاحیه میگیره
- همهٔ پکیجها روی 3.0.0 هستن، بهجز سه پکیج فونت و مهر که روی 1.0.0 هستن
- سرور CloudPDF به شکل image ghcr.io/embedpdf/cloudpdf-server:3.0.0 و Helm chart منتشر شده




