كلمة للتخفيض السعر

تحويل Word إلى Markdown في Java

يستخدم Microsoft Word على نطاق واسع لإنشاء مستندات Word وتحريرها وتحويلها (DOC / DOCX) إلى تنسيقات مختلفة. وبالمثل ، تعد Markdown لغة ترميز خفيفة الوزن يمكنك استخدامها لإضافة عناصر تنسيق إلى مستندات النص العادي. إنه مستند نصي عادي يمكن قراءته بدون علامات تفسد كل شيء ، ولكن لا يزال هناك طرق لإضافة معدِّلات نصية مثل القوائم ، والخط العريض ، والمائل ، وما إلى ذلك ، لذا إذا كان لدينا مستند Word ونحتاج إلى إنشاء ملف مكافئ في صيغة Markdown ، يصبح من الصعب إنشائه يدويًا. ومع ذلك ، يمكن أن يحل الحل البرمجي المشكلة. ستشرح هذه المقالة جميع التفاصيل حول كيفية تطوير محول Word to markdown باستخدام Java Cloud SDK.

Word to Markdown التحويل API

تعد واجهة برمجة التطبيقات (API) القائمة على REST والمسمى Aspose.Words Cloud حلاً رائعًا لتنفيذ عمليات إنشاء مستندات MS Word ومعالجتها وتحويلها إلى مجموعة متنوعة من التنسيقات المدعومة. الآن من أجل تنفيذ نفس إمكانات تحويل المستندات ومعالجتها في تطبيق Java ، نحتاج إلى استخدام Aspose.Words Cloud SDK for Java وهو عبارة عن غلاف حول REST API. لذلك في الخطوة الأولى لاستخدام SDK ، نحتاج إلى إضافة مرجعها في مشروع Java الخاص بنا من خلال تضمين المعلومات التالية في pom.xml (مشروع نوع بناء maven).

<repositories> 
    <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>https://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>

<dependencies>
    <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-words-cloud</artifactId>
        <version>22.12.0</version>
    </dependency>
</dependencies>

بمجرد إضافة مرجع SDK في المشروع ، فإن الخطوة المهمة التالية هي الحصول على بيانات اعتماد العميل من Cloud Dashboard. عدا ذلك ، تحتاج أولاً إلى تسجيل حساب مجاني أثناء استخدام عنوان بريد إلكتروني صالح.

من Word إلى MD في Java

يشرح هذا القسم الخطوات والتفاصيل ذات الصلة حول كيفية تحويل Word إلى تنسيق MD باستخدام مقتطف كود Java. سنستخدم خيارين لتحميل مستند Word المدخل ، أي من التخزين السحابي أو محرك الأقراص المحلي ، ثم نحوله إلى تنسيق Markdown.

تحميل مستند Word من محرك الأقراص المحلي

  • بادئ ذي بدء ، قم بإنشاء مثيل لـ WordsApi وتمرير بيانات الاعتماد الشخصية كوسيطات
  • ثانيًا ، اقرأ محتوى مستند Word المدخل باستخدام طريقة Files.readAllBytes (…) واحصل على القيمة المرجعة في صفيف بايت []
  • ثالثًا ، قم بإنشاء كائن من ConvertDocumentRequest الذي يأخذ إدخال ملف Word وتنسيق MD واسم ملف Markdown الناتج كوسائط
  • الآن ، استدعاء طريقة convertDocument (…) لتحويل Word إلى MD. يتم إرجاع Markdown الناتج كتدفق استجابة ، ليتم حفظه في مثيل [] بايت
  • أخيرًا ، من أجل حفظ Markdown الناتج على محرك الأقراص المحلي ، أنشئ كائنًا من FileOutputStream واستخدم طريقة الكتابة (…)
// لمزيد من مقتطفات الشفرة ، يرجى https://github.com/aspose-words-cloud/aspose-words-cloud-java

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// إذا كانت baseUrl خالية ، فإن WordsApi تستخدم https://api.aspose.cloud افتراضيًا
	WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
			
        // تحميل وثيقة كلمة من النظام المحلي
        File file1 = new File("sample_EmbeddedOLE.docx");

        // قراءة محتوى مستند كلمة الإدخال
        byte[] documentStream = Files.readAllBytes(file1.toPath());
  
        // تنسيق الملف الناتج
        String format = "md";

        // إنشاء طلب تحويل المستند حيث نقدم اسم الملف الناتج
        ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
  
        // أداء كلمة لتحويل markdown وحفظ الإخراج في صفيف بايت
        byte[] resultantFile = wordsApi.convertDocument(convertRequest);
        
        // حفظ وثائق تخفيض السعر الناتج على محرك الأقراص المحلي
	FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
	fos.write(resultantFile);
	fos.close();
      
    }catch(Exception ex)
    {
	System.out.println(ex);
    }
كلمة Markdown

صورة: - كلمة لمعاينة تحويل Markdown

يمكنك تنزيل مستند Word المدخل من sampleEmbeddedOLE.docx.

قم بتحميل مستند Word من Cloud Storage

  • وبالمثل ، نحتاج أولاً إلى إنشاء مثيل لـ WordsApi أثناء تمرير بيانات الاعتماد الشخصية كوسيطات
  • ثانيًا ، قم بإنشاء كائن GetDocumentWithFormatRequest الذي يأخذ اسم ملف Word المُدخل وتنسيق MD واسم ملف Markdown الناتج كوسائط
  • أخيرًا ، قم باستدعاء الأسلوب getDocumentWithFormat (..) الذي يقوم بتشغيل Word to Markdown عملية التحويل. يتم حفظ ملف MD الناتج في التخزين السحابي
// لمزيد من مقتطفات الشفرة ، يرجى https://github.com/aspose-words-cloud/aspose-words-cloud-java

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// إذا كانت baseUrl خالية ، فإن WordsApi تستخدم https://api.aspose.cloud افتراضيًا
	WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);

        String format = "md";
        // الآن قم بإنشاء كائن جديد من GetDocumentWithFormatRequest 
        GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);

        // الآن قم باستدعاء الطريقة لبدء عملية التحويل
        // يتم تخزين الملف الناتج في التخزين السحابي
        wordsApi.getDocumentWithFormat(convertRequest);
      
    }catch(Exception ex)
    {
	System.out.println(ex);
    }

DOC لعملية Markdown باستخدام أوامر cURL

توفر واجهات برمجة تطبيقات REST أيضًا المرونة في الوصول إليها من أي نظام أساسي بمساعدة أوامر cURL. لذلك في هذا القسم ، سنناقش التفاصيل حول كيفية تحميل مستند Word من التخزين السحابي ، وإجراء تحويل DOCX إلى Markdown وحفظ ملف MD الناتج على محرك الأقراص المحلي. الآن نحتاج أولاً إلى إنشاء رمز وصول JWT (بناءً على بيانات اعتماد العميل) باستخدام الأمر التالي ثم إجراء تحويل DOCX إلى Markdown.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

بمجرد إنشاء JWT ، يرجى تنفيذ الأمر التالي لتحميل مستند Word من التخزين السحابي وتنفيذ تحويل Word إلى Markdown. ثم يتم تخزين ملف MD الناتج على محرك الأقراص المحلي

curl -v -X GET "https://api.aspose.cloud/v4.0/words/sample_EmbeddedOLE.docx?format=md" \
-H  "accept: application/octet-stream" \
-H  "Authorization: Bearer <JWT Token>" \
-o "newOutput.md"

استنتاج

لقد وصلنا إلى نهاية هذه المقالة حيث تعلمنا التفاصيل حول كيفية تحويل Word برمجيًا إلى Markdown باستخدام Java. وبالمثل ، اكتشفنا أيضًا خطوات تحويل DOCX إلى Markdown عبر أوامر cURL.

هناك خيار آخر لاستكشاف إمكانيات واجهة برمجة التطبيقات وهو من خلال SwaggerUI داخل متصفح الويب. نوصي أيضًا باستكشاف وثائق المنتج والتي تعد مصدرًا رائعًا للمعلومات للتعرف على ميزات أخرى مثيرة. في حال احتجت إلى تنزيل وتعديل الكود المصدري لـ Cloud SDK ، فهو متاح على GitHub (منشور بموجب ترخيص MIT). أخيرًا ، في حالة مواجهة أية مشكلات أثناء استخدام واجهة برمجة التطبيقات ، يمكنك التفكير في الاتصال بنا للحصول على حل سريع عبر منتدى دعم المنتج مجانًا.

مقالات ذات صلة

يرجى زيارة الروابط التالية لمعرفة المزيد حول: