kelma għal markdown

Ikkonverti Word għal Markdown f’Java

Microsoft Word tintuża ħafna biex toħloq, teditja u tittrasforma dokumenti tal-Word (DOC/DOCX) f’diversi formati. Bl-istess mod, Markdown hija lingwaġġ ta’ markup ħafif li tista’ tuża biex iżżid elementi ta’ ifformattjar ma’ dokumenti b’test sempliċi. Huwa dokument b’test sempliċi li għandu jkun jista’ jinqara mingħajr tikketti li jtellfu kollox, iżda xorta għandu jkun hemm modi biex jiżdiedu modifikaturi tat-test bħal listi, grassa, korsiv, eċċ. Mela jekk ikollna dokument Word u għandna bżonn noħolqu fajl ekwivalenti fis-sintassi ta’ Markdown, isir diffiċli li toħloqha manwalment. Madankollu, soluzzjoni programmatika tista ‘ssolvi l-problema. Dan l-artikolu se jispjega d-dettalji kollha dwar kif tiżviluppa konvertitur word to markdown billi tuża Java Cloud SDK.

Word għal Markdown Konverżjoni API

L-API tagħna bbażata fuq REST bl-isem Aspose.Words Cloud hija soluzzjoni aqwa biex timplimenta operazzjonijiet ta’ ħolqien, manipulazzjoni u konverżjoni ta’ dokumenti MS Word għal varjetà ta’ formati appoġġjati. Issa sabiex nimplimentaw l-istess kapaċitajiet ta ‘konverżjoni u pproċessar ta’ dokumenti fl-applikazzjoni Java, għandna bżonn nużaw Aspose.Words Cloud SDK for Java li huwa wrapper madwar REST API. Allura fl-ewwel pass tal-utilizzazzjoni tal-SDK, irridu nżidu r-referenza tiegħu fil-proġett Java tagħna billi ninkludu l-informazzjoni li ġejja f’pom.xml (proġett tat-tip 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>

Ladarba r-referenza SDK tkun ġiet miżjuda fil-proġett, il-pass importanti li jmiss huwa li tikseb il-kredenzjali tal-klijent tiegħek minn Cloud Dashboard. Inkella, l-ewwel trid tirreġistra kont b’xejn waqt li tuża indirizz elettroniku validu.

Kelma għal MD f’Java

Din it-taqsima tispjega l-passi u d-dettalji relatati dwar kif nistgħu nikkonvertiw il-Kelma għall-format MD billi tuża snippet tal-kodiċi Java. Se nużaw żewġ għażliet għat-tagħbija tad-Dokument tal-Kelma tal-input jiġifieri forma ta ‘ħażna Cloud jew drive lokali, u mbagħad tittrasformah f’format Markdown.

Tagħbija Word Dokument minn drive lokali

  • L-ewwelnett, oħloq eżempju ta ‘WordsApi u għaddi kredenzjali personalizzati bħala argumenti
  • It-tieni, aqra l-kontenut tad-dokument tal-Word tal-input billi tuża l-metodu Files.readAllBytes(…) u tikseb valur lura f’firxa ta’ byte[]
  • It-tielet, oħloq oġġett ta’ ConvertDocumentRequest li jieħu l-input tal-fajl Word, il-format MD u l-isem tal-fajl Markdown li jirriżulta bħala argumenti
  • Issa, sejħa metodu convertDocument(…) għall-Kelma għall-konverżjoni MD. Il-Markdown li jirriżulta huwa rritornat bħala fluss ta’ rispons, biex jiġi ssejvjat f’istanza byte[].
  • Fl-aħħarnett, sabiex issalva l-Markdown riżultanti għal drive lokali, oħloq oġġett ta ‘FileOutputStream u uża l-metodu write (…) tiegħu
// Għal aktar snippets tal-kodiċi, jekk jogħġbok https://github.com/aspose-words-cloud/aspose-words-cloud-java

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// jekk baseUrl huwa null, WordsApi juża default https://api.aspose.cloud
	WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
			
        // tagħbija dokument kelma mis-sistema lokali
        File file1 = new File("sample_EmbeddedOLE.docx");

        // aqra l-kontenut tad-dokument word input
        byte[] documentStream = Files.readAllBytes(file1.toPath());
  
        // format tal-fajl li jirriżulta
        String format = "md";

        // toħloq talba għall-konverżjoni tad-Dokument fejn nipprovdu l-isem tal-fajl li jirriżulta
        ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
  
        // wettaq konverżjoni kelma għal markdown u ssalva l-output f'byte Array
        byte[] resultantFile = wordsApi.convertDocument(convertRequest);
        
        // Issejvja d-dokumentazzjoni tal-markdown riżultanti fuq drive lokali
	FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
	fos.write(resultantFile);
	fos.close();
      
    }catch(Exception ex)
    {
	System.out.println(ex);
    }
kelma lil Markdown

Immaġni: - Preview tal-konverżjoni Word għal Markdown

Tista’ tikkunsidra li tniżżel id-dokument Word tal-input minn sampleEmbeddedOLE.docx.

Tagħbija Word Dokument minn Cloud Storage

  • Bl-istess mod, l-ewwel irridu noħolqu eżempju ta ‘WordsApi filwaqt li ngħaddu kredenzjali personalizzati bħala argumenti
  • It-tieni, oħloq oġġett ta’ GetDocumentWithFormatRequest li jieħu l-isem tal-fajl Word input, il-format MD u l-isem tal-fajl Markdown li jirriżulta bħala argumenti
  • Fl-aħħarnett, sejjaħ il-metodu getDocumentWithFormat(..) li jqajjem l-operazzjoni ta ‘konverżjoni Word għal Markdown. Il-fajl MD li jirriżulta jiġi ffrankat fil-ħażna tal-Cloud
// Għal aktar snippets tal-kodiċi, jekk jogħġbok https://github.com/aspose-words-cloud/aspose-words-cloud-java

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// jekk baseUrl huwa null, WordsApi juża default https://api.aspose.cloud
	WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);

        String format = "md";
        // issa oħloq oġġett ġdid ta' GetDocumentWithFormatRequest 
        GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);

        // issa sejjaħ il-metodu biex tibda l-operazzjoni ta 'konverżjoni
        // il-fajl li jirriżulta huwa maħżun fil-ħażna tas-sħab
        wordsApi.getDocumentWithFormat(convertRequest);
      
    }catch(Exception ex)
    {
	System.out.println(ex);
    }

DOC għal Markdown billi tuża l-Kmandi tal-cURL

L-APIs REST jipprovdu wkoll il-flessibilità li tkun aċċessata minn kwalunkwe pjattaforma bl-għajnuna ta ‘kmandi cURL. Allura f’din it-taqsima, se niddiskutu d-dettalji dwar kif tagħbija dokument Word forma ħażna Cloud, wettaq DOCX għal konverżjoni Markdown u ssalva l-fajl MD riżultanti fuq drive lokali. Issa l-ewwel irridu niġġeneraw it-token ta ‘aċċess JWT (ibbażat fuq il-kredenzjali tal-klijent) billi tuża l-kmand li ġej u mbagħad inwettaq konverżjoni DOCX għal 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"

Ladarba l-JWT jiġi ġġenerat, jekk jogħġbok wettaq il-kmand li ġej biex tagħbija dokument Word mill-ħażna Cloud u twettaq konverżjoni Word għal Markdown. Il-fajl MD li jirriżulta mbagħad jinħażen fuq drive lokali

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"

Konklużjoni

Wasalna sal-aħħar ta ‘dan l-artikolu fejn tgħallimna d-dettalji dwar kif nistgħu nikkonvertiw b’mod programmatiku Word għal Markdown billi tuża Java. Bl-istess mod, esplorajna wkoll il-passi għall-konverżjoni ta ‘DOCX għal Markdown permezz ta’ kmandi tal-cURL.

Għażla oħra biex tesplora l-kapaċitajiet tal-API hija permezz ta’ SwaggerUI fi ħdan web browser. Nirrakkomandaw ukoll li tesplora l-Dokumentazzjoni tal-Prodott li hija sors aqwa ta’ informazzjoni biex titgħallem dwar karatteristiċi eċċitanti oħra. F’każ li jkollok bżonn tniżżel u timmodifika l-kodiċi tas-sors ta’ Cloud SDK, huwa disponibbli fuq GitHub (ippubblikat taħt liċenzja MIT). Fl-aħħar nett, f’każ li tiltaqa’ ma’ xi kwistjonijiet waqt li tuża l-API, tista’ tikkunsidra li tavviċinana għal riżoluzzjoni rapida permezz ta’ forum ta’ appoġġ tal-prodott.

Artikoli Relatati

Jekk jogħġbok żur il-links li ġejjin biex titgħallem aktar dwar: