در موارد خاص، ممکن است لازم باشد یک عبارت متنی، خط یا ناحیه را در اسناد PDF برجسته کنیم. به برجسته کردن متن مهم با رنگ نیمه شفاف در قالب الکترونیکی کمک می کند، همانطور که با یک نشانگر روی کاغذ استاندارد انجام می دهیم. ما می توانیم با استفاده از حاشیه نویسی هایلایت در برنامه ها از ویژگی برجسته به صورت برنامه نویسی استفاده کنیم. در این مقاله، نحوه برجسته کردن متن در PDF با استفاده از REST API در Node.js را یاد خواهیم گرفت.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- PDF Text Highlighter REST API و Node.js SDK
- متن را در PDF با استفاده از REST API در Node.js برجسته کنید
PDF Text Highlighter REST API و Node.js SDK
برای برجسته کردن متن در فایل‌های PDF، از Node.js SDK of GroupDocs.Annotation Cloud API استفاده خواهیم کرد. این امکان افزودن حاشیه نویسی، همپوشانی واترمارک، جایگزینی متن، ویرایش و نشانه گذاری متن را به [فرمت های سند پشتیبانی شده] می دهد. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:
npm install groupdocs-annotation-cloud
لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 4 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
// این مثال کد نشان می دهد که چگونه شناسه مشتری و Secret خود را به کد اضافه کنید.
global.clientId = "659fe7da-715b-4744-a0f7-cf469a392b73";
global.clientSecret = "b377c36cfa28fa69960ebac6b6e36421";
global.myStorage = "";
const configuration = new groupdocs_annotation_cloud.Configuration(clientId, clientSecret);
configuration.apiBaseUrl = "https://api.groupdocs.cloud";
متن را در PDF با استفاده از REST API در Node.js برجسته کنید
با دنبال کردن مراحل ساده زیر می توانیم متن را در فایل های PDF برجسته کنیم:
- آپلود فایل PDF را در ابر
- متن را برجسته کنید در PDF آپلود شده
- دانلود فایل مشروح
سند را آپلود کنید
ابتدا فایل PDF را با استفاده از نمونه کد زیر در فضای ابری آپلود می کنیم:
// این مثال کد نحوه آپلود یک فایل PDF را در فضای ابری نشان می دهد.
// نمونه api را راه اندازی کنید
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// فایل را در IOStream از محلی/دیسک باز کنید.
var resourcesFolder = 'C:\\Files\\Annotation\\sample.pdf';
// فایل را بخوانید
fs.readFile(resourcesFolder, (err, fileStream) => {
// درخواست آپلود فایل
var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.pdf", fileStream, myStorage);
// آپلود فایل
fileApi.uploadFile(request);
});
در نتیجه، فایل PDF آپلود شده در بخش فایل ها داشبورد در فضای ابری در دسترس خواهد بود.
متن را در سند PDF با استفاده از Node.js برجسته کنید
اکنون، با دنبال کردن مراحل زیر، حاشیه نویسی هایلایت را برای برجسته کردن متن در سند PDF آپلود شده اضافه می کنیم:
- ابتدا یک نمونه از AnnotateApi ایجاد کنید.
- بعد، موقعیت نقاط حاشیه نویسی را تنظیم کنید.
- سپس، نقاطی را به شی AnnotationInfo اختصاص دهید و رنگ و نوع پس زمینه آن را تنظیم کنید.
- در مرحله بعد، مسیر فایل ورودی را ارائه دهید.
- سپس، شی AnnotateOptions را مقداردهی اولیه کنید و مسیر فایل خروجی را تنظیم کنید.
- پس از آن، AnnotateRequest را با AnnotateOptions به عنوان آرگومان ایجاد کنید.
- در نهایت، متن را در PDF با استفاده از روش AnnotateApi.annotate() برجسته کنید.
نمونه کد زیر نحوه برجسته کردن متن در یک سند PDF را با استفاده از REST API در Node.js نشان می دهد.
// این مثال کد نحوه اضافه کردن حاشیه نویسی هایلایت را به فایل PDF نشان می دهد.
// نمونه api را راه اندازی کنید
let annotateApi = groupdocs_annotation_cloud.حاشیه نویسی کنیدApi.fromKeys(clientId, clientSecret);
// حاشیه نویسی را تعریف کنید
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
// نقطه 1
let p1 = new groupdocs_annotation_cloud.Point();
p1.x = 30;
p1.y = 710;
// نقطه 2
let p2 = new groupdocs_annotation_cloud.Point();
p2.x = 460;
p2.y = 710;
// نکته 3
let p3 = new groupdocs_annotation_cloud.Point();
p3.x = 30;
p3.y = 690;
// نقطه 4
let p4 = new groupdocs_annotation_cloud.Point();
p4.x = 460;
p4.y = 690;
// امتیاز اضافه کنید
a1.points = [p1, p2, p3, p4];
// رنگ پس زمینه
a1.backgroundColor = 3329434;
// تایپ کنید
a1.type = groupdocs_annotation_cloud.AnnotationInfo.تایپ کنیدEnum.TextHighlight;
// فایل ورودی
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.pdf";
// حاشیه نویسی کنیدOptions را تعریف کنید
let options = new groupdocs_annotation_cloud.حاشیه نویسی کنیدOptions();
options.fileInfo = fileInfo;
// حاشیه نویسی را اختصاص دهید
options.annotations = [a1];
// مسیر فایل خروجی
options.outputPath = "output.pdf";
// درخواست حاشیه نویسی کنید ایجاد کنید
let request = new groupdocs_annotation_cloud.حاشیه نویسی کنیدRequest(options);
// حاشیه نویسی کنید
let result = await annotateApi.annotate(request);
// انجام شده
console.log("AddAreaAnnotation: Area Annotation added: " + result.href);
متن را در سند PDF با استفاده از Node.js برجسته کنید
می توانید مقدار رنگ مورد نیاز را از لینک زیر برای استفاده به عنوان رنگ پس زمینه دریافت کنید. https://docs.microsoft.com/en-us/office/vba/api/excel.xlrgbcolor
فایل حاشیه نویسی را دانلود کنید
نمونه کد بالا فایل پی‌دی‌اف مشروح‌شده را در فضای ابری ذخیره می‌کند. با استفاده از نمونه کد زیر قابل دانلود است:
// این مثال کد نحوه دانلود یک فایل PDF از ابر را نشان می دهد.
// FileApi را بسازید
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// درخواست فایل دانلود را ایجاد کنید
let request = new groupdocs_annotation_cloud.DownloadFileRequest("output.pdf", myStorage);
// دریافت فایل
let response = await fileApi.downloadFile(request);
// فایل را در دایرکتوری کاری خود ذخیره کنید
fs.writeFile("C:\\Files\\Annotation\\output.pdf", response, "binary", function (err) { });
آنلاین را امتحان کنید
لطفاً ابزار حاشیه نویسی PDF آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/annotation/pdf
نتیجه
در این مقاله یاد گرفتیم که چگونه:
- اضافه کردن حاشیه نویسی هایلایت به PDF با استفاده از Node.js.
- به صورت برنامه نویسی فایل PDF را در فضای ابری آپلود کنید.
- فایل پی دی اف مشروح را از ابر دانلود کنید.
علاوه بر این، با استفاده از documentation می‌توانید درباره GroupDocs.Annotation Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان تماس بگیرید.