نشان زد کرنے کے لیے لفظ

جاوا میں ورڈ کو مارک ڈاؤن میں تبدیل کریں۔

مائیکروسافٹ ورڈ وسیع پیمانے پر ورڈ دستاویزات (DOC/DOCX) کو مختلف فارمیٹس میں بنانے، ترمیم کرنے اور تبدیل کرنے کے لیے استعمال کیا جاتا ہے۔ اسی طرح، Markdown ایک ہلکی پھلکی مارک اپ لینگویج ہے جسے آپ سادہ ٹیکسٹ دستاویزات میں فارمیٹنگ عناصر شامل کرنے کے لیے استعمال کر سکتے ہیں۔ یہ ایک سادہ ٹیکسٹ دستاویز ہے جسے ٹیگز کے بغیر پڑھنے کے قابل ہو جائے گا، لیکن پھر بھی ٹیکسٹ موڈیفائر جیسے فہرستیں، بولڈ، اٹالکس وغیرہ کو شامل کرنے کے طریقے ہونے چاہئیں۔ لہذا اگر ہمارے پاس ورڈ دستاویز ہے اور ہمیں ایک مساوی فائل بنانے کی ضرورت ہے۔ مارک ڈاؤن نحو میں، اسے دستی طور پر بنانا مشکل ہو جاتا ہے۔ تاہم، ایک پروگرامی حل مسئلہ کو حل کر سکتا ہے. یہ مضمون جاوا کلاؤڈ SDK کا استعمال کرتے ہوئے ورڈ ٹو مارک ڈاون کنورٹر کو کیسے تیار کرنے کے بارے میں تمام تفصیلات بتانے جا رہا ہے۔

ورڈ ٹو مارک ڈاون کنورژن API

ہمارا REST پر مبنی API جس کا نام Aspose.Words Cloud ہے، MS Word دستاویز کی تخلیق، ہیرا پھیری اور مختلف قسم کے [معاون شدہ فارمیٹس] میں تبدیلی کی کارروائیوں کو نافذ کرنے کا ایک حیرت انگیز حل ہے۔ اب جاوا ایپلیکیشن میں اسی دستاویز کی تبدیلی اور پروسیسنگ کی صلاحیتوں کو لاگو کرنے کے لیے، ہمیں Aspose.Words Cloud SDK for Java استعمال کرنے کی ضرورت ہے جو REST API کے ارد گرد ایک ریپر ہے۔ لہذا SDK کے استعمال کے پہلے مرحلے میں، ہمیں pom.xml (maven build type project) میں درج ذیل معلومات کو شامل کرکے اپنے جاوا پروجیکٹ میں اس کا حوالہ شامل کرنے کی ضرورت ہے۔

<repositories> 
    <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>http://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 سے اپنے کلائنٹ کی اسناد حاصل کرنا ہے۔ بصورت دیگر، آپ کو درست ای میل ایڈریس استعمال کرتے ہوئے پہلے ایک مفت اکاؤنٹ رجسٹر کرنے کی ضرورت ہے۔

جاوا میں MD کو لفظ

یہ سیکشن اقدامات اور متعلقہ تفصیلات کی وضاحت کرتا ہے کہ ہم جاوا کوڈ کا ٹکڑا استعمال کرتے ہوئے Word کو MD فارمیٹ میں کیسے تبدیل کر سکتے ہیں۔ ہم ان پٹ ورڈ دستاویز کو لوڈ کرنے کے لیے دو اختیارات استعمال کرنے جا رہے ہیں یعنی فارم کلاؤڈ اسٹوریج یا لوکل ڈرائیو، اور پھر اسے مارک ڈاؤن فارمیٹ میں تبدیل کریں۔

لوکل ڈرائیو سے ورڈ دستاویز لوڈ کریں۔

  • سب سے پہلے، WordsApi کی ایک مثال بنائیں اور دلائل کے طور پر ذاتی نوعیت کی اسناد پاس کریں۔
  • دوم، Files.readAllBytes(…) طریقہ کا استعمال کرتے ہوئے ان پٹ ورڈ دستاویز کے مواد کو پڑھیں اور بائٹ[] سرنی میں واپسی ہوئی قدر حاصل کریں۔
  • تیسرا، ConvertDocumentRequest کا ایک آبجیکٹ بنائیں جو ان پٹ ورڈ فائل، MD فارمیٹ اور نتیجے میں مارک ڈاؤن فائل کا نام بطور دلیل لے۔
  • اب، ورڈ سے ایم ڈی کی تبدیلی کے لیے میتھڈ کنورٹ ڈاکیومنٹ(…) کو کال کریں۔ نتیجے میں مارک ڈاؤن کو بائٹ [] مثال میں محفوظ کرنے کے لیے جوابی سلسلہ کے طور پر واپس کیا جاتا ہے۔
  • آخر میں، نتیجے میں مارک ڈاؤن کو لوکل ڈرائیو میں محفوظ کرنے کے لیے، 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);
  
        // مارک ڈاون کنورژن کے لیے لفظ پرفارم کریں اور آؤٹ پٹ کو بائٹ اری میں محفوظ کریں۔
        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);
    }
مارک ڈاؤن کے لیے لفظ

تصویر:- ورڈ ٹو مارک ڈاون تبدیلی کا پیش نظارہ

آپ ان پٹ ورڈ دستاویز کو sampleEmbeddedOLE.docx سے ڈاؤن لوڈ کرنے پر غور کر سکتے ہیں۔

کلاؤڈ اسٹوریج سے ورڈ دستاویز لوڈ کریں۔

  • اسی طرح، سب سے پہلے ہمیں WordsApi کی ایک مثال بنانے کی ضرورت ہے جب کہ ذاتی نوعیت کی اسناد کو دلیل کے طور پر پاس کرتے ہوئے
  • دوم، GetDocumentWithFormatRequest کا ایک آبجیکٹ بنائیں جو ورڈ فائل کا نام، MD فارمیٹ اور نتیجے میں مارک ڈاؤن فائل کا نام بطور دلیل لے۔
  • آخر میں، طریقہ getDocumentWithFormat(..) کو کال کریں جو ورڈ کو مارک ڈاؤن کنورژن آپریشن کو متحرک کرتا ہے۔ نتیجے میں 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);
    }

CURL کمانڈز کا استعمال کرتے ہوئے مارک ڈاؤن کرنے کے لیے DOC

REST APIs CURL کمانڈز کی مدد سے کسی بھی پلیٹ فارم سے رسائی کی لچک بھی فراہم کرتے ہیں۔ لہٰذا اس سیکشن میں، ہم کلاؤڈ سٹوریج کے فارم ورڈ دستاویز کو لوڈ کرنے، DOCX سے مارک ڈاؤن کنورژن کو انجام دینے اور نتیجے میں آنے والی 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 تیار ہونے کے بعد، براہ کرم کلاؤڈ اسٹوریج سے ورڈ دستاویز لوڈ کرنے اور ورڈ سے مارک ڈاؤن کنورژن کو انجام دینے کے لیے درج ذیل کمانڈ پر عمل کریں۔ نتیجے میں 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"

نتیجہ

ہم اس مضمون کے آخر تک پہنچ چکے ہیں جہاں ہم نے اس بارے میں تفصیلات سیکھی ہیں کہ ہم جاوا کا استعمال کرتے ہوئے ورڈ کو پروگرامی طور پر مارک ڈاؤن میں کیسے تبدیل کر سکتے ہیں۔ اسی طرح، ہم نے CURL کمانڈز کے ذریعے DOCX کو مارک ڈاؤن میں تبدیل کرنے کے اقدامات کو بھی دریافت کیا ہے۔

API کی صلاحیتوں کو دریافت کرنے کا دوسرا آپشن ویب براؤزر کے اندر SwaggerUI کے ذریعے ہے۔ ہم یہ بھی تجویز کرتے ہیں کہ پروڈکٹ ڈاکومینٹیشن کو تلاش کریں جو کہ دیگر دلچسپ خصوصیات کے بارے میں جاننے کے لیے معلومات کا ایک حیرت انگیز ذریعہ ہے۔ اگر آپ کو کلاؤڈ SDK کے سورس کوڈ کو ڈاؤن لوڈ اور اس میں ترمیم کرنے کی ضرورت ہے، تو یہ GitHub (MIT لائسنس کے تحت شائع) پر دستیاب ہے۔ آخر میں، اگر آپ کو API کا استعمال کرتے ہوئے کوئی مسئلہ درپیش ہوتا ہے، تو آپ مفت [پروڈکٹ سپورٹ فورم] کے ذریعے فوری حل کے لیے ہم سے رابطہ کرنے پر غور کر سکتے ہیں۔

متعلقہ مضامین

کے بارے میں مزید جاننے کے لیے براہ کرم درج ذیل لنکس پر جائیں: