Табдил додани Word (DOC/DOCX) ба Markdown (MD) дар Java

Microsoft Word барои эҷод, таҳрир ва табдил додани ҳуҷҷатҳои Word (DOC/DOCX) ба форматҳои гуногун васеъ истифода мешавад. Ба ҳамин монанд, Markdown забони сабуки аломатгузорӣ мебошад, ки шумо метавонед онро барои илова кардани унсурҳои форматкунӣ ба ҳуҷҷатҳои матнии оддӣ истифода баред. Ин як ҳуҷҷати матнии оддӣ аст, ки бидуни барчаспҳо хондан мумкин аст, аммо ба ҳар ҳол бояд роҳҳои илова кардани тағирдиҳандаҳои матн ба монанди рӯйхатҳо, ғафс, курсив ва ғайра вуҷуд дошта бошанд. Пас, агар мо ҳуҷҷати Word дошта бошем ва мо бояд файли муодилиро эҷод кунем. дар синтаксиси Markdown, эҷоди дастӣ он душвор мешавад. Аммо, ҳалли барномавӣ метавонад мушкилотро ҳал кунад. Ин мақола ҳама тафсилотро дар бораи чӣ гуна таҳия кардани табдилдиҳандаи калима ба аломатгузории Java Cloud SDK шарҳ медиҳад.

• Word ба API Conversion Markdown
• Word ба MD дар Java
• DOC ба Markdown бо истифода аз фармонҳои cURL

Word ба API Conversion Markdown

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>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 мебошад. Дар акси ҳол, шумо бояд аввал ҳисоби ройгонро ҳангоми истифодаи суроғаи почтаи электронии дуруст сабт кунед.

Word ба MD дар Java

Ин бахш қадамҳо ва тафсилоти марбутро шарҳ медиҳад, ки чӣ тавр мо метавонем Word-ро ба формати MD бо истифода аз порчаи коди Java табдил диҳем. Мо ду вариантро барои бор кардани Ҳуҷҷати вурудии Word, яъне анбори абрӣ ё диски маҳаллӣ истифода мебарем ва сипас онро ба формати Markdown табдил медиҳем.

Ҳуҷҷати Wordро аз диски маҳаллӣ бор кунед

• Пеш аз ҳама, як мисоли WordsApi эҷод кунед ва маълумоти шахсии худро ҳамчун далел интиқол диҳед
• Сониян, мундариҷаи ҳуҷҷати воридшудаи Word-ро бо усули Files.readAllBytes(…) хонед ва арзиши баргардонидашударо дар массиви байт [] гиред
• Сеюм, объекти ConvertDocumentRequest эҷод кунед, ки файли воридшудаи Word, формати MD ва номи файли Markdown-ро ҳамчун далел қабул мекунад
• Акнун, ба усули табдил додани ҳуҷҷат (…) барои табдили 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);
  
        // Калимаро барои табдили аломатгузорӣ иҷро кунед ва натиҷаро дар массиви байт захира кунед
        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ро аз sampleEmbeddedOLE.docx баррасӣ кунед.

Ҳуҷҷати Wordро аз анбори абрӣ бор кунед

• Ба ҳамин монанд, аввал мо бояд як мисоли WordsApi эҷод кунем, ҳангоми интиқол додани эътимодномаҳои фардӣ ҳамчун далел
• Сониян, объекти GetDocumentWithFormatRequest эҷод кунед, ки номи файли Word, формати MD ва номи файли Markdown-ро ҳамчун далел қабул мекунад
• Дар ниҳоят, усули getDocumentWithFormat(..) -ро даъват кунед, ки амалиёти табдилдиҳии Word ба 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

API-ҳои 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-ро омӯхтаем.

Варианти дигари омӯхтани имкониятҳои API тавассути SwaggerUI дар дохили браузери веб мебошад. Мо инчунин тавсия медиҳем, ки Ҳуҷҷатҳои маҳсулот-ро омӯзед, ки манбаи аҷиби иттилоот барои омӯхтани дигар хусусиятҳои ҷолиб аст. Агар ба шумо лозим аст, ки рамзи сарчашмаи Cloud SDK-ро зеркашӣ ва тағир диҳед, он дар GitHub дастрас аст (таҳти иҷозатномаи MIT нашр шудааст). Ниҳоят, агар шумо ҳангоми истифодаи API бо ягон мушкилот рӯ ба рӯ шавед, шумо метавонед фикр кунед, ки ба мо барои ҳалли зуд тавассути ройгон форуми дастгирии маҳсулот муроҷиат кунед.

Мақолаҳои марбут

Лутфан ба истиноди зерин муроҷиат кунед, то дар бораи маълумоти бештар маълумот гиред:

• WebP ба JPG бо истифода аз Java
• Табдил додани PDF ба TIFF дар Java
• Excel ба Word бо истифода аз Java
• Табдил додани HTML ба тасвир дар Java
• Табдил додани SVG ба PNG дар Java