كيفية تحويل HTML إلى PNG بلغة جافا "HTML to PNG"

تناقش هذه المقالة الحاجة إلى التوثيق المرئي لتعليمات HTML البرمجية

وتوفر حل API مجانيًا يحول سلاسل HTML إلى لقطات شاشة PNG.

منذ ظهورها في أواخر الثمانينيات ، استمرت لغة ترميز النص التشعبي

(HTML) كعنصر حاسم في عرض صفحات الويب على الإنترنت.

تستمر لغة البرمجة في كل مكان في تقديم إطار عمل تفصيلي لهيكلة المحتوى

الذي نراه ونتفاعل معه على الويب ، مما يسمح لنا بتنسيق النص ومكونات الوسائط

المتعددة في كود نص عادي ، وهو أمر بسيط بما يكفي للتغيير عند الحاجة.

ماهو تحويل HTML

كما هو الحال مع جميع لغات البرمجة تقريبًا ، تحولت HTML لتضم العشرات

من الميزات الجديدة على مدى عقود منذ تقديمها ، لتلائم الضغوط المعاصرة

النموذجية مثل تعليقات المجتمع / النقد والنمو السريع لتقنيات تطوير الويب المجاورة.

يمكن رؤية نتائج هذا التحول بسهولة في إخراج كود HTML الحديث ؛

على سبيل المثال ، يقدم أحدث إصدار من HTML - HTML5 ، الذي تم تقديمه

في عام 2014 - عناصر جديدة وبسيطة لتضمين ملفات الفيديو والصوت ، بالإضافة إلى

التحسينات التي تمس الحاجة إليها في عرض الجوال والوظائف العامة للجوال.

بالطبع ، العناصر الجديدة وتحسينات جودة العرض ليست السبب الوحيد لتغيير كود

HTML لموقع الويب بشكل موثوق بمرور الوقت. يتم تصميم مواقع الويب

وإعادة تصميمها باستمرار ، على الأرجح من أجل الابتكار بقدر ما هو استجابة

للاتجاهات الناشئة عن تعليقات المستخدمين. على سبيل المثال ، من المحتمل أن

يتضمن موقع ويب تم تطويره في عام 2014 مجموعة متنوعة من اتجاهات التصميم

المعاصرة بغض النظر عن التغييرات التي تم إدخالها في HTML5 في ذلك العام.

في السنوات التي أعقبت هذا المشروع ، من المحتمل أن يجد مطورو موقع الويب

أنفسهم يكررون على الأقل جزءًا من كود HTML الخاص بهم عدة مرات ، كل ذلك

أثناء البناء نحو الإصدار الحتمي لـ HTML6 والدمج النهائي لميزاته الجديدة والمحسّنة.

بالنظر إلى هذه التطورات الطبيعية في تطوير HTML ، يُطرح سؤال مهم: كيف

يمكننا تتبع وتوثيق نمو كود HTML لموقعنا على الويب بشكل فعال؟

الإجابة بسيطة نسبيًا ، نظرًا للطبيعة المرئية بطبيعتها لمخرجات HTML.

يمكننا بسهولة تخزين تكرارات مواقع الويب بتنسيق HTML الخاصة بنا في شكل

ملفات صور ثابتة ثنائية الأبعاد - لقطات شاشة - ويمكننا إنجاز هذا الانتقال برمجيًا بسهولة نسبية.

لقطات شاشة بتنسيق HTML

يحتوي التقاط لقطة شاشة بتنسيق HTML على العديد من تطبيقات الأعمال العملية.

عندما تتم كتابة كود HTML جديد لموقع ويب ، فإن تقديم صورة لإخراج كود

HTML هذا يعمل على أنه "فحص حالة" بسيط يمكن مشاركته بسهولة

لمعرفة كيفية ظهور محتواه على مستعرض ويب في وقت معين. على نفس

المنوال ، تقدم لقطات الشاشة طريقة ممتازة للاختبار السريع للتكرارات التجريبية

الجديدة لشفرة HTML ، مما يسهل على المطور إنشاء وتخزين إصدارات

مختلفة - سواء كانت ناجحة أو غير ناجحة - من مشروع قيد التطوير.

توفر لقطات الشاشة أيضًا وسيلة مثالية للتوثيق المرئي للمشكلات الحتمية التي

تحدث مع مواقع الويب الحية ، مما يسهل تتبع المشكلات المزعجة وتتبع كيفية

ظهورها على الأجهزة أو المتصفحات أو أنظمة التشغيل المختلفة.

كيفية تحويل HTML إلى PNG في Java

الغرض من هذا البرنامج التعليمي هو توفير حل API بسيط ومجاني وسهل

الاستخدام لتحويل سلاسل HTML إلى لقطات شاشة PNG في Java.

ستعرض واجهة برمجة التطبيقات هذه موقع الويب بالكامل ، مع عرض لقطة

شاشة لما يعرضه HTML في عرض متصفح الويب العادي. وهو يدعم جميع

ميزات تطوير الويب الحديثة والمتقدمة ، بما في ذلك تلك المتعلقة

بـ HTML5 و CSS و JavaScript والمزيد. من أجل راحتك ، يتم توفير أمثلة أكواد

Java الجاهزة للتشغيل في أسفل الصفحة لمساعدتك في تنظيم مكالمة API الخاصة بك بسهولة.

تحتوي واجهة برمجة التطبيقات هذه على معلمتين إلزاميتين للطلب ، والتي تشمل ما يلي:

1- سلسلة HTML الخاصة بك

2- مفتاح Cloudmersive API مجاني (يمكنك الحصول عليه من

خلال زيارة موقعنا على الإنترنت وتسجيل حساب مجاني).

بالإضافة إلى المدخلات الإلزامية أعلاه ، توفر واجهة برمجة التطبيقات هذه العديد من

المعلمات الاختيارية ، والتي تسمح بمزيد من التخصيص لطلب الإدخال الخاص بك.

تتضمن هذه المعلمات الاختيارية ما يلي:

1- انتظار التحميل الإضافي :

العدد الإضافي من المللي ثانية للانتظار بمجرد انتهاء تحميل صفحة الويب قبل

التقاط لقطة الشاشة (يمكن أن يكون مفيدًا لمواقع الويب غير المتزامنة للغاية).

2- ارتفاع لقطة الشاشة :

الارتفاع المطلوب للشاشة ، معبراً عنه بوحدات البكسل (الإعدادات الافتراضية

هي 1280 × 1024). يؤدي توفير العدد الصحيح "0" إلى تشغيل الإعداد الافتراضي ،

بينما يطلب توفير العدد الصحيح "-1" من واجهة برمجة التطبيقات قياس ومحاولة لقطة شاشة بارتفاع الشاشة.

3- عرض لقطة الشاشة :

العرض المطلوب من لقطة الشاشة الخاصة بك ، معبراً عنه بوحدات البكسل

(يتم تعيينه افتراضيًا أيضًا على قياس قياسي 1280 × 1024). يؤدي توفير

الأعداد الصحيحة "0" أو "-1" إلى نفس النتائج الموضحة في معلمة " ارتفاع لقطة الشاشة " أعلاه.

في ردها ، ستوفر واجهة برمجة التطبيقات هذه سلسلة تحتوي على ترميز ملف PNG الجديد.

لتنظيم استدعاء API الخاص بك في Java ، فإن خطوتك الأولى هي تثبيت SDK.

يمكن تحقيق ذلك مع Maven عن طريق إضافة المرجع التالي أولاً إلى المستودع في pom.xml:

<repositories>

<repository>

<id>jitpack.io</id>

<url>https://jitpack.io</url>

</repository>

</repositories>

بعد ذلك ، أضف المرجع أدناه إلى التبعية في pom.xml:

<dependencies>

<dependency>

<groupId>com.github.Cloudmersive</groupId>

<artifactId>Cloudmersive.APIClient.Java</artifactId>

<version>v4.25</version>

</dependency>

</dependencies>

لتثبيت SDK مع Gradle بدلاً من ذلك ، أضف المرجع الخاص بك في

الجذر build.gradle(في نهاية المستودعات):

allprojects {

repositories {

...

maven { url 'https://jitpack.io' }

}

ثم أضف التبعية في build.gradle:

dependencies {

implementation 'com.github.Cloudmersive:Cloudmersive.APIClient.Java:v4.25'

}

مع اكتمال التثبيت ، كل ما تبقى هو نسخ ولصق أمثلة التعليمات البرمجية التالية و

استيفاء معلمات الطلب الإلزامية والاختيارية كما هو موضح أعلاه:

// Import classes:

//import com.cloudmersive.client.invoker.ApiClient;

//import com.cloudmersive.client.invoker.ApiException;

//import com.cloudmersive.client.invoker.Configuration;

//import com.cloudmersive.client.invoker.auth.*;

//import com.cloudmersive.client.ConvertWebApi;

ApiClient defaultClient = Configuration.getDefaultApiClient();

// Configure API key authorization: Apikey

ApiKeyAuth Apikey = (ApiKeyAuth) defaultClient.getAuthentication("Apikey");

Apikey.setApiKey("YOUR API KEY");

// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)

//Apikey.setApiKeyPrefix("Token");

ConvertWebApi apiInstance = new ConvertWebApi();

HtmlToPngRequest input = new HtmlToPngRequest(); // HtmlToPngRequest | HTML to PNG request parameters

try {

byte[] result = apiInstance.convertWebHtmlToPng(input);

System.out.println(result);

} catch (ApiException e) {

System.err.println("Exception when calling ConvertWebApi#convertWebHtmlToPng");

e.printStackTrace();

}

بمجرد إكمال هذه الخطوة ، تكون قد انتهيت تمامًا - يمكنك الآن استدعاء

واجهة برمجة التطبيقات هذه وتقديم سلاسل HTML بسهولة على هيئة لقطات شاشة بتنسيق PNG.

ملاحظة: سيزودك مفتاح API ذو الطبقة المجانية بحد أقصى 800 استدعاء

لواجهة برمجة التطبيقات شهريًا دون أي التزامات.

بمجرد وصولك إلى هذا الحد ، سيتم إعادة تعيين المجموع الخاص بك ببساطة في الشهر التالي.

J Rose

القائمة الرئيسية

الصفحات

كيفية تحويل HTML إلى PNG بلغة جافا "HTML to PNG"