Skip to content

_index.md

Latest commit

 

History

History
262 lines (189 loc) · 12.6 KB

_index.md

File metadata and controls

262 lines (189 loc) · 12.6 KB
date 2026-02-21
description تعلم كيفية استخدام GroupDocs Viewer Maven لتحويل ملفات txt إلى html و jpg و png و pdf في Java. يتضمن خطوات تحويل txt إلى pdf باستخدام Java وإنشاء صفحات html متعددة باستخدام Java.
keywords
GroupDocs.Viewer for Java
convert TXT to HTML
render TXT as JPG/PNG
title groupdocs viewer maven: تحويل TXT إلى HTML، JPG، PNG، PDF
type docs
url /ar/java/export-conversion/groupdocs-viewer-java-txt-conversion-guide/
weight 1

groupdocs viewer maven: تحويل ملفات TXT إلى HTML، JPG، PNG، و PDF باستخدام GroupDocs.Viewer للـ Java

في تطبيقات Java الحديثة، groupdocs viewer maven يجعل من السهل تحويل مستندات النص العادي (TXT) إلى HTML جاهز للويب، أو صور عالية الدقة، أو ملفات PDF محمولة. سواءً كنت تبني بوابة مستندات، أو خدمة أرشفة، أو ميزة معاينة، فإن تحويل ملفات TXT باستخدام GroupDocs.Viewer يوفر لك الوقت ويقضي على الحاجة إلى محللات مخصصة. في هذا الدليل سنستعرض الإعداد الكامل ونوضح لك كيفية convert txt files java إلى HTML (صفحة واحدة أو متعددة)، JPG، PNG، و PDF.

تحويل ملفات TXT إلى HTML، JPG، PNG، و PDF باستخدام GroupDocs.Viewer للـ Java

إجابات سريعة

  • أي قطعة Maven أحتاجها؟ com.groupdocs:groupdocs-viewer (انظر مقتطف Maven أدناه).
  • هل يمكنني إنشاء HTML متعدد الصفحات؟ نعم – استخدم HtmlViewOptions.forEmbeddedResources بدون علامة الصفحة الواحدة.
  • هل يلزم وجود ترخيص للإنتاج؟ النسخة التجريبية تعمل للتقييم؛ يلزم الحصول على ترخيص دائم للاستخدام التجاري.
  • ما نسخة Java المدعومة؟ Java 8 أو أحدث (يوصى بـ Java 11+).
  • هل أحتاج إلى مكتبات إضافية لإخراج الصور؟ لا، مكتبة Viewer تتضمن دعم JPG و PNG مباشرةً.

ما هو groupdocs viewer maven؟

groupdocs viewer maven هو توزيع Maven لمكتبة GroupDocs.Viewer للـ Java. يوفر API بسيطًا لتصوير أكثر من 100 تنسيق مستندات — بما في ذلك النص العادي — إلى HTML أو صور أو PDF دون الحاجة إلى Microsoft Office أو أدوات طرف ثالث.

لماذا تحويل txt files java؟

  • معاينة عبر المنصات – يمكن عرض HTML والصور في المتصفحات أو التطبيقات المحمولة.
  • أرشفة موحدة – يحافظ PDF على التنسيق وهو قابل للقراءة عالميًا.
  • ملائم للأتمتة – دمج التحويل في وظائف الدُفعات، الخدمات السحابية، أو خطوط أنابيب CI.

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

  • GroupDocs.Viewer for Java الإصدار 25.2 أو أحدث (يتم توفيره عبر Maven).
  • JDK 8 + (يوصى بـ Java 11 +).
  • بيئة تطوير متكاملة مثل IntelliJ IDEA أو Eclipse أو NetBeans.
  • معرفة أساسية بـ Java و Maven.

إعداد GroupDocs.Viewer للـ Java

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

<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>

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

  • ابدأ بـ تجربة مجانية أو احصل على ترخيص مؤقت لاستكشاف جميع الإمكانات.
  • للإنتاج، اشترِ ترخيصًا عبر الصفحة الرسمية purchase page.

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

  1. أضف اعتماد Maven المعروض أعلاه.
  2. تأكد من تكوين JDK و IDE بشكل صحيح.

الآن دعنا نتعمق في سيناريوهات التحويل العملية.

دليل التنفيذ

الميزة 1: تحويل TXT إلى HTML متعدد الصفحات (multi page html java)

نظرة عامة

هذا المثال يحول مستند TXT إلى ملف HTML متعدد الصفحات، مع الحفاظ على فواصل الأسطر عبر صفحات ويب منفصلة.

استيراد المكتبات المطلوبة

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

إعداد المسارات و Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Render the document to HTML using these options
    viewer.view(options);
}

Explanation: HtmlViewOptions.forEmbeddedResources يجمع CSS، الخطوط، والصور مباشرةً في مخرجات HTML، مما يجعلها محمولة.

الميزة 2: تحويل TXT إلى HTML صفحة واحدة (convert txt to html java)

نظرة عامة

دمج ملف النص بالكامل في صفحة HTML واحدة — مثالي للمعاينات السريعة.

استيراد المكتبات المطلوبة

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.HtmlViewOptions;

إعداد المسارات و Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result_single_page.html");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_2_TXT")) {
    // Configure options for rendering with embedded resources
    HtmlViewOptions options = HtmlViewOptions.forEmbeddedResources(pageFileFullPath);
    
    // Set the option to render as a single page HTML
    options.setRenderToSinglePage(true);
    
    // Render the document using these options
    viewer.view(options);
}

Explanation: setRenderToSinglePage(true) يجمع جميع الصفحات في ملف HTML واحد.

الميزة 3: تحويل TXT إلى JPG

نظرة عامة

تحويل ملف TXT إلى صورة JPEG عالية الجودة، مفيد للمشاركة على المنصات التي تقبل الصور فقط.

استيراد المكتبات المطلوبة

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.JpgViewOptions;

إعداد المسارات و Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.jpg");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a JPEG image
    JpgViewOptions options = new JpgViewOptions(pageFileFullPath);
    
    // Render the document as a JPG using these options
    viewer.view(options);
}

Explanation: JpgViewOptions يتيح لك التحكم في جودة الصورة، DPI، ومسار الإخراج.

الميزة 4: تحويل TXT إلى PNG

نظرة عامة

إنشاء صور PNG غير مضغوطة من ملفات النص — مثالي عندما تحتاج إلى رسومات واضحة وقابلة للتوسيع.

استيراد المكتبات المطلوبة

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PngViewOptions;

إعداد المسارات و Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.png");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PNG image
    PngViewOptions options = new PngViewOptions(pageFileFullPath);
    
    // Render the document as a PNG using these options
    viewer.view(options);
}

Explanation: PNG يوفر ضغطًا غير مضغوط، محافظًا على المظهر الدقيق للنص الأصلي.

الميزة 5: تحويل TXT إلى PDF (txt to pdf java / convert txt to pdf java)

نظرة عامة

إنشاء ملف PDF من مستند TXT — رائع للأرشفة، الطباعة، أو الإرسال إلى العملاء.

استيراد المكتبات المطلوبة

import com.groupdocs.viewer.Viewer;
import com.groupdocs.viewer.options.PdfViewOptions;

إعداد المسارات و Viewer

Path outputDirectory = Path.of("YOUR_OUTPUT_DIRECTORY");
Path pageFileFullPath = outputDirectory.resolve("Txt_result.pdf");

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_TXT")) {
    // Configure options for rendering to a PDF
    PdfViewOptions options = new PdfViewOptions(pageFileFullPath);
    
    // Render the document as a PDF using these options
    viewer.view(options);
}

Explanation: PdfViewOptions يتعامل مع تخطيط الصفحات، الخطوط، وتضمين الموارد تلقائيًا.

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

  1. أنظمة إدارة المستندات: أتمتة تحويل مستندات TXT القديمة إلى HTML للبوابات الداخلية.
  2. منصات النشر: تحويل المخطوطات المقدمة بصيغة TXT إلى HTML لتكامل سلس مع أنظمة إدارة المحتوى.
  3. حلول الأرشفة: حفظ ملفات النص القديمة كـ PDF أو PNG للتخزين طويل الأمد.
  4. تكامل التخزين السحابي: تحويل عند الطلب وتخزين الملفات المصدرة في AWS S3 أو Azure Blob أو Google Cloud.

المشكلات الشائعة والحلول

المشكلة السبب الحل
المخرجات فارغة مسار الملف غير صحيح أو نقص في أذونات القراءة. تحقق من أن YOUR_DOCUMENT_DIRECTORY يشير إلى ملف TXT الفعلي وأن العملية لديها صلاحيات القراءة.
الصور ذات جودة منخفضة DPI الافتراضي منخفض. استخدم JpgViewOptions.setResolution(int dpi) أو PngViewOptions.setResolution(int dpi) لزيادة DPI (مثلاً 300).
HTML يحتوي على روابط مكسورة الموارد غير مدمجة. استخدم HtmlViewOptions.forEmbeddedResources أو قدم مجلد موارد مخصص.
استثناء الترخيص لم يتم تعيين ترخيص صالح. حمّل ملف الترخيص باستخدام License license = new License(); license.setLicense("path/to/license.file"); قبل إنشاء الـ Viewer.

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

س: هل يمكنني تحويل ملفات TXT الكبيرة (مئات الـ MB) باستخدام GroupDocs.Viewer؟
ج: نعم. المكتبة تقوم ببث الملف المصدر، لكن قد تحتاج إلى زيادة حجم heap للـ JVM للوثائق الكبيرة جدًا.

س: هل أحتاج إلى تبعيات إضافية لتوليد JPG أو PNG؟
ج: لا. حزمة Viewer تتضمن جميع مكتبات معالجة الصور المطلوبة.

س: هل يمكن تخصيص حجم صفحة PDF؟
ج: بالتأكيد. استخدم PdfViewOptions.setPageSize(PageSize.A4) أو أي حجم PageSize آخر قبل التصيير.

س: كيف أتعامل مع ملفات TXT المحمية بكلمة مرور؟
ج: ملفات TXT لا تدعم كلمات مرور. إذا كان الملف مشفرًا، يجب فك تشفيره أولاً قبل تمريره إلى Viewer.

س: هل يمكن تشغيل هذا التحويل داخل حاوية Docker؟
ج: نعم. فقط قم بتضمين JDK، انسخ ملف pom.xml مع اعتماد GroupDocs، وشغّل تطبيق Java داخل الحاوية.

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