სიტყვა ნიშნად

Java-ში Word-ის Markdown-ად გადაქცევა

Microsoft Word ფართოდ გამოიყენება Word დოკუმენტების (DOC/DOCX) შესაქმნელად, რედაქტირებისთვის და სხვადასხვა ფორმატში გარდაქმნისთვის. ანალოგიურად, Markdown არის მსუბუქი მარკირების ენა, რომელიც შეგიძლიათ გამოიყენოთ ფორმატირების ელემენტების დასამატებლად უბრალო ტექსტურ დოკუმენტებში. ეს არის უბრალო ტექსტური დოკუმენტი, რომელიც იკითხება ტეგების გარეშე, რომელიც არ ასახავს ყველაფერს. Markdown სინტაქსში ძნელია მისი ხელით შექმნა. თუმცა, პროგრამულ გადაწყვეტას შეუძლია პრობლემის გადაჭრა. ეს სტატია აპირებს ახსნას ყველა დეტალს, თუ როგორ უნდა განვავითაროთ სიტყვა-დან მარკდაუნ კონვერტორი Java Cloud SDK-ის გამოყენებით.

Word to Markdown Conversion API

ჩვენი REST დაფუძნებული API სახელწოდებით Aspose.Words Cloud არის საოცარი გადაწყვეტა MS Word დოკუმენტის შექმნის, მანიპულაციისა და კონვერტაციის ოპერაციების განსახორციელებლად სხვადასხვა მხარდაჭერილ ფორმატებში. ახლა იმისათვის, რომ განვახორციელოთ იგივე დოკუმენტის კონვერტაციის და დამუშავების შესაძლებლობები Java აპლიკაციაში, ჩვენ უნდა გამოვიყენოთ Aspose.Words Cloud SDK for Java, რომელიც არის REST API-ს გარშემო. ასე რომ, SDK-ის გამოყენების პირველ საფეხურზე, ჩვენ უნდა დავამატოთ მისი მითითება ჩვენს Java პროექტში შემდეგი ინფორმაციის pom.xml-ში (maven build ტიპის პროექტი) ჩართვის გზით.

<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 ფორმატში Java კოდის ფრაგმენტის გამოყენებით. ჩვენ ვაპირებთ გამოვიყენოთ ორი ვარიანტი შეყვანის Word Document-ის ჩასატვირთად, ანუ შევქმნათ Cloud-ის საცავი ან ლოკალური დისკი და შემდეგ გადავიყვანოთ იგი Markdown ფორმატში.

ჩატვირთეთ Word დოკუმენტი ადგილობრივი დისკიდან

  • უპირველეს ყოვლისა, შექმენით WordsApi-ს ეგზემპლარი და გადაიტანეთ პერსონალიზებული რწმუნებათა სიგელები არგუმენტებად
  • მეორეც, წაიკითხეთ Word დოკუმენტის შეყვანის შინაარსი Files.readAllBytes(…) მეთოდის გამოყენებით და მიიღეთ დაბრუნებული მნიშვნელობა ბაიტი[] მასივში.
  • მესამე, შექმენით ConvertDocumentRequest-ის ობიექტი, რომელიც არგუმენტად იღებს Word ფაილს, MD ფორმატს და შედეგის Markdown ფაილის სახელს.
  • ახლა, გამოიძახეთ მეთოდი convertDocument(…) Word-ში MD-ში კონვერტაციისთვის. შედეგი Markdown ბრუნდება როგორც საპასუხო ნაკადი, რომელიც შეინახება ბაიტში[] მაგალითში
  • დაბოლოს, შედეგის მარკდაუნის ლოკალურ დისკზე შესანახად შექმენით FileOutputStream-ის ობიექტი და გამოიყენეთ მისი ჩაწერის(…) მეთოდი.
// დამატებითი კოდის ფრაგმენტებისთვის, გთხოვთ, https://github.com/aspose-words-cloud/aspose-words-cloud-java

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// თუ baseUrl არის null, WordsApi იყენებს ნაგულისხმევს https://api.aspose.cloud
	WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
			
        // ჩატვირთეთ Word დოკუმენტი ლოკალური სისტემიდან
        File file1 = new File("sample_EmbeddedOLE.docx");

        // წაიკითხეთ input word დოკუმენტის შინაარსი
        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);
    }
სიტყვა მარკდაუნს

სურათი: - Word to Markdown კონვერტაციის გადახედვა

თქვენ შეგიძლიათ განიხილოთ შეყვანილი Word დოკუმენტის ჩამოტვირთვა sampleEmbeddedOLE.docx-დან.

ჩატვირთეთ Word დოკუმენტი Cloud Storage-დან

  • ანალოგიურად, პირველ რიგში, ჩვენ უნდა შევქმნათ WordsApi-ს ეგზემპლარი, პერსონალიზებული რწმუნებათა სიგელების არგუმენტებად გადაცემისას
  • მეორეც, შექმენით GetDocumentWithFormatRequest-ის ობიექტი, რომელიც არგუმენტად იღებს Word ფაილის სახელს, MD ფორმატს და შედეგად Markdown ფაილის სახელს.
  • და ბოლოს, მოვუწოდებთ მეთოდს getDocumentWithFormat(..), რომელიც იწვევს Word to Markdown კონვერტაციის ოპერაციას. შედეგად მიღებული MD ფაილი ინახება Cloud საცავში
// დამატებითი კოდის ფრაგმენტებისთვის, გთხოვთ, https://github.com/aspose-words-cloud/aspose-words-cloud-java

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// თუ baseUrl არის null, 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 მარკდაუნისთვის cURL ბრძანებების გამოყენებით

REST API-ები ასევე უზრუნველყოფენ მოქნილობას ნებისმიერი პლატფორმიდან 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 ბრძანებების საშუალებით.

API-ს შესაძლებლობების შესწავლის კიდევ ერთი ვარიანტია SwaggerUI ვებ ბრაუზერში. ჩვენ ასევე გირჩევთ გაეცნოთ Product Documentation, რომელიც ინფორმაციის საოცარი წყაროა სხვა საინტერესო ფუნქციების გასაგებად. თუ გჭირდებათ Cloud SDK-ის საწყისი კოდის ჩამოტვირთვა და შეცვლა, ის ხელმისაწვდომია GitHub-ზე (გამოქვეყნებულია MIT ლიცენზიით). და ბოლოს, თუ API-ს გამოყენებისას რაიმე პრობლემას წააწყდებით, შეგიძლიათ მოგვმართოთ სწრაფი გადაწყვეტისთვის უფასო პროდუქტის მხარდაჭერის ფორუმის მეშვეობით.

დაკავშირებული სტატიები

გთხოვთ ეწვიოთ შემდეგ ბმულებს მეტი ინფორმაციისთვის: