Skip to content

_index.md

Latest commit

 

History

History
206 lines (147 loc) · 12.1 KB

_index.md

File metadata and controls

206 lines (147 loc) · 12.1 KB
date 2026-02-10
description تعلم كيفية إضافة خطوط مخصصة إلى HTML باستخدام GroupDocs.Viewer للغة Java، وتكوين إعدادات الخط في Java، وتضمين خطوط مخصصة في HTML للعلامة التجارية وسهولة القراءة.
keywords
custom font rendering Java
GroupDocs Viewer setup
Java GroupDocs Viewer custom fonts
title كيفية إضافة خط مخصص إلى HTML في جافا باستخدام GroupDocs.Viewer: دليل خطوة بخطوة
type docs
url /ar/java/custom-rendering/java-groupdocs-viewer-custom-font-rendering/
weight 1

كيفية إضافة خط مخصص HTML في Java باستخدام GroupDocs.Viewer: دليل خطوة بخطوة

المقدمة

هل تواجه صعوبة مع الخطوط الافتراضية التي لا تتطابق مع هوية علامتك التجارية البصرية؟ في العديد من التقارير التجارية، المستندات القانونية، والعروض التقديمية، add custom font HTML أمر أساسي للحفاظ على المظهر المتسق وتحسين قابلية القراءة. يوضح هذا الدليل كيفية استخدام GroupDocs.Viewer for Java لتكوين إعدادات الخطوط Java وتضمين خطوط مخصصة HTML، بحيث تبدو المستندات التي تم عرضها تمامًا كما تريد.

تنفيذ عرض الخط المخصص باستخدام GroupDocs.Viewer لـ Java

ما ستتعلمه

  • كيفية إعداد GroupDocs.Viewer لـ Java
  • كيفية add custom font HTML إلى المخرجات التي تم عرضها
  • كيفية configure font settings Java لتحقيق الأداء الأمثل

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

إجابات سريعة

  • ما هو الهدف الأساسي؟ عرض المستندات باستخدام خطوطك الخاصة باستخدام GroupDocs.Viewer Java.
  • ما هو الإصدار المطلوب؟ GroupDocs.Viewer 25.2 (أو أحدث).
  • هل أحتاج إلى ترخيص؟ تتوفر نسخة تجريبية مجانية؛ يلزم وجود ترخيص مدفوع للإنتاج.
  • هل يمكنني تضمين custom fonts HTML؟ نعم – ما عليك سوى توجيه العارض إلى مجلد يحتوي على خطوطك.
  • هل Maven هو الطريقة الوحيدة لإضافة المكتبة؟ يُنصح باستخدام Maven، لكن يمكنك أيضًا استخدام Gradle أو تضمين JAR يدويًا.

ما هو “add custom font HTML”؟

إضافة خط مخصص HTML تعني إرشاد محرك العرض لاستخدام الخطوط التي تزودها، بدلاً من الخطوط النظامية الافتراضية، عند إنشاء مخرجات HTML. يضمن ذلك أن النمط البصري للمستند يتطابق مع هوية علامتك التجارية أو إرشادات إمكانية الوصول.

لماذا يتم تكوين إعدادات الخطوط Java مع GroupDocs.Viewer؟

تكوين إعدادات الخطوط Java يمنحك التحكم الكامل في ملفات الخط التي يتم البحث عنها، وكيفية تخزينها مؤقتًا، وكيفية تطبيق الخطوط الاحتياطية. يقلل ذلك من أخطاء العرض، ويحسن الأداء، ويضمن مظهرًا متسقًا عبر المتصفحات.

المتطلبات المسبقة

  • Java Development Kit (JDK): 8 أو أحدث
  • IDE: IntelliJ IDEA، Eclipse، أو أي محرر متوافق مع Java
  • Maven: لإدارة التبعيات
  • ملفات الخط المخصص: ملفات .ttf أو .otf موضوعة في مجلد مخصص

إعداد GroupDocs.Viewer لـ Java

معلومات التثبيت

أضف مستودع GroupDocs والاعتماد إلى ملف pom.xml الخاص بـ Maven:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

الحصول على الترخيص

تقدم GroupDocs نسخة تجريبية مجانية لاستكشاف ميزاتها، مع خيارات للحصول على ترخيص مؤقت أو شراء ترخيص كامل. لأغراض الاختبار، قم بتحميل أحدث نسخة من صفحة release page.

التهيئة الأساسية والإعداد

بعد إضافة GroupDocs.Viewer كاعتماد، قم بتهيئته في مشروع Java الخاص بك:

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("sample.pdf")) {
            // Initial setup and viewing code here
        }
    }
}

يوضح هذا المثال الأساسي كيفية فتح مستند باستخدام GroupDocs.Viewer.

دليل التنفيذ

كيفية إضافة خط مخصص HTML في GroupDocs.Viewer Java

في هذا القسم سنستعرض الخطوات الدقيقة المطلوبة لـ add custom font HTML عند عرض المستندات.

استيراد الحزم الضرورية

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.fonts.FolderFontSource;
import com.groupdocs.viewer.fonts.FontSettings;
import com.groupdocs.viewer.fonts.SearchOption;

تسهل هذه الاستيرادات التعامل مع الخطوط المخصصة وخيارات عرض المستند.

إعداد الخطوط المخصصة

تحديد مسار مجلد الخطوط الخاص بك
String fontPath = "/path/to/your/custom/fonts";

استبدل "/path/to/your/custom/fonts" بالموقع الفعلي لملفات .ttf أو .otf الخاصة بك.

إنشاء كائن FontSource
FolderFontSource fontSource = new FolderFontSource(fontPath, SearchOption.TOP_FOLDER_ONLY);

SearchOption.TOP_FOLDER_ONLY يخبر العارض بالبحث فقط في المجلد المحدد، مما يسرّع عملية البحث.

تكوين إعدادات الخطوط Java
FontSettings.setFontSources(fontSource);

هذا السطر configures font settings Java بحيث يستخدم كل عملية عرض الخطوط التي قمت بتوفيرها.

تحديد دليل الإخراج وخيارات العرض

String outputPath = "/path/to/output/directory";
String pageFilePathFormat = String.format("%s/page_{0}.html", outputPath);
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

هنا نوضح أيضًا كيفية embed custom fonts HTML باستخدام HtmlViewOptions.forEmbeddedResources، الذي يدمج ملفات الخط مباشرةً في HTML المُولَّد.

نصائح استكشاف الأخطاء وإصلاحها

  • تحقق من أن ملفات الخط لديها أذونات قراءة للمستخدم الذي يشغل عملية Java.
  • تحقق مرة أخرى من مسار المجلد؛ فقد يؤدي عدم وجود الشرطة المائلة النهائية إلى أخطاء “الخط غير موجود”.
  • تأكد من أن الخطوط متوافقة مع نوع المستند (مثل TrueType لملفات PDF).

تطبيقات عملية

يمكن تطبيق عرض الخط المخصص في سيناريوهات متعددة:

  1. الاتساق في العلامة التجارية: استخدم خطوطًا خاصة بالعلامة التجارية عبر جميع التقارير المُولدة.
  2. تحسينات الوصولية: اختر خطوطًا مقروءة تساعد المستخدمين ذوي الإعاقات البصرية.
  3. المستندات القانونية والمالية: أبرز الأقسام الرئيسية بخطوط تحسن قابلية المسح.

يمكنك دمج هذا النهج مع أنظمة إدارة المستندات، بوابات المحتوى، أو أي تطبيق مؤسسي يحتاج إلى تقديم معاينات HTML للمستندات.

اعتبارات الأداء

عند معالجة دفعات كبيرة:

  • قلل عدد الخطوط المخصصة للحفاظ على استهلاك الذاكرة منخفضًا.
  • قم بتخزين كائنات HtmlViewOptions مؤقتًا عند عرض العديد من المستندات بنفس الإعدادات.
  • راقب مساحة الذاكرة heap في JVM واضبط -Xmx حسب الحاجة لتجنب أخطاء OutOfMemory.

الخلاصة

لقد تعلمت الآن كيفية add custom font HTML باستخدام GroupDocs.Viewer لـ Java، وكيفية configure font settings Java، وكيفية embed custom fonts HTML للحصول على عرض مستندات متسق ومُعَلَّم بالعلامة التجارية. تمكّنك هذه التقنيات من تقديم معاينات HTML مصقولة ومُتاحة في أي حل مبني على Java.

كخطوة تالية، استكشف قدرات إضافية في GroupDocs.Viewer مثل وضع العلامات المائية، دعم التعليقات التوضيحية، وعرض ملفات PDF متعددة الصفحات. للحصول على تفاصيل أعمق، راجع documentation.

الأسئلة المتكررة

س: كيف أضمن توافق الخطوط المخصصة مع أنواع المستندات المختلفة؟
ج: اختبر خطوطك مع ملفات PDF، DOCX، وPPTX للتأكد من عرض متسق عبر الصيغ.

س: هل يمكن لـ GroupDocs.Viewer التعامل مع النصوص غير اللاتينية باستخدام خطوط مخصصة؟
ج: نعم—بمجرد وضع الخط المناسب الذي يدعم Unicode في مجلد الخطوط، سيعرض العارض الأحرف بشكل صحيح.

س: ما هي خيارات الترخيص المتاحة للاستخدام في الإنتاج؟
ج: يمكنك البدء بنسخة تجريبية مجانية، ثم الترقية إلى ترخيص مؤقت أو دائم عبر purchase page.

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

س: هل يمكنني الرجوع إلى الخطوط الافتراضية إذا كان الخط المخصص غير متوفر؟
ج: نعم—بإضافة عدة كائنات FontSource، يمكنك إعطاء الأولوية للخطوط المخصصة مع الاحتفاظ بالخطوط النظامية كنسخ احتياطية.

الموارد

للمزيد من الاستكشاف:

آخر تحديث: 2026-02-10
تم الاختبار مع: GroupDocs.Viewer 25.2 for Java
المؤلف: GroupDocs