Microsoft Word tiek plaši izmantots, lai izveidotu, rediģētu un pārveidotu Word dokumentus (DOC/DOCX) dažādos formātos. Tāpat Markdown ir viegla iezīmēšanas valoda, ko varat izmantot, lai vienkārša teksta dokumentiem pievienotu formatēšanas elementus. Tas ir vienkārša teksta dokuments, kas ir lasāms bez tagiem, kas visu sajauc, taču joprojām ir jābūt veidiem, kā pievienot teksta modifikatorus, piemēram, sarakstus, treknrakstu, slīprakstu utt. Tātad, ja mums ir Word dokuments un mums ir jāizveido līdzvērtīgs fails Markdown sintaksē ir grūti to izveidot manuāli. Tomēr programmatisks risinājums var atrisināt problēmu. Šajā rakstā ir izskaidrota visa informācija par to, kā izstrādāt vārdu uz atzīmes pārveidotāju, izmantojot Java Cloud SDK.
Word to Markdown Conversion API
Mūsu REST balstītā API ar nosaukumu Aspose.Words Cloud ir pārsteidzošs risinājums, lai īstenotu MS Word dokumentu izveides, manipulācijas un konvertēšanas darbības dažādos atbalstītos formātos. Tagad, lai Java lietojumprogrammā ieviestu vienas un tās pašas dokumentu konvertēšanas un apstrādes iespējas, mums ir jāizmanto Aspose.Words Cloud SDK for Java, kas ir REST API iesaiņojums. Tātad pirmajā SDK izmantošanas posmā mums ir jāpievieno tā atsauce mūsu Java projektā, iekļaujot tālāk norādīto informāciju failā pom.xml (maven build type project).
<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>
Kad SDK atsauce ir pievienota projektam, nākamais svarīgais solis ir iegūt klienta akreditācijas datus no Cloud Dashboard. Pretējā gadījumā vispirms ir jāreģistrē bezmaksas konts, vienlaikus izmantojot derīgu e-pasta adresi.
Word uz MD Java
Šajā sadaļā ir izskaidrotas darbības un ar to saistītā informācija par to, kā Word var pārvērst MD formātā, izmantojot Java koda fragmentu. Mēs izmantosim divas iespējas, lai ielādētu ievades Word dokumentu, ti, veidotu mākoņkrātuvi vai lokālo disku, un pēc tam pārveidotu to Markdown formātā.
Ielādējiet Word dokumentu no vietējā diska
- Vispirms izveidojiet WordsApi gadījumu un nosūtiet personalizētus akreditācijas datus kā argumentus
- Otrkārt, izlasiet ievades Word dokumenta saturu, izmantojot Files.readAllBytes(…) metodi, un iegūstiet atgriezto vērtību baitu [] masīvā.
- Treškārt, izveidojiet ConvertDocumentRequest objektu, kas kā argumentus izmanto ievades Word failu, MD formātu un iegūto Markdown faila nosaukumu.
- Tagad Word konvertēšanai uz MD izsauciet metodi convertDocument(…). Iegūtā Markdown tiek atgriezta kā atbildes plūsma, kas jāsaglabā baitu [] instancē
- Visbeidzot, lai saglabātu iegūto Markdown vietējā diskā, izveidojiet FileOutputStream objektu un izmantojiet tā rakstīšanas (…) metodi.
// Lai iegūtu vairāk koda fragmentu, lūdzu, apmeklējiet vietni https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// ja baseUrl ir nulle, WordsApi izmanto noklusējuma vietni https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// ielādējiet Word dokumentu no vietējās sistēmas
File file1 = new File("sample_EmbeddedOLE.docx");
// lasīt ievades Word dokumenta saturu
byte[] documentStream = Files.readAllBytes(file1.toPath());
// iegūtais faila formāts
String format = "md";
// izveidot dokumentu konvertēšanas pieprasījumu, kurā mēs sniedzam iegūtā faila nosaukumu
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// veiciet Word uz atzīmes konvertēšanu un saglabājiet izvadi baitu masīvā
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Saglabājiet iegūto atzīmes dokumentāciju vietējā diskā
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Varat apsvērt iespēju lejupielādēt ievades Word dokumentu no vietnes sampleEmbeddedOLE.docx.
Ielādējiet Word dokumentu no mākoņkrātuves
- Tāpat vispirms mums ir jāizveido WordsApi gadījums, vienlaikus nododot personalizētus akreditācijas datus kā argumentus
- Otrkārt, izveidojiet GetDocumentWithFormatRequest objektu, kas kā argumentus izmanto Word faila nosaukumu, MD formātu un iegūto Markdown faila nosaukumu.
- Visbeidzot, izsauciet metodi getDocumentWithFormat(..), kas aktivizē Word uz Markdown konvertēšanas darbību. Iegūtais MD fails tiek saglabāts mākoņkrātuvē
// Lai iegūtu vairāk koda fragmentu, lūdzu, apmeklējiet vietni https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// ja baseUrl ir nulle, WordsApi izmanto noklusējuma vietni https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// tagad izveidojiet jaunu GetDocumentWithFormatRequest objektu
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// tagad izsauciet metodi konvertēšanas darbības uzsākšanai
// iegūtais fails tiek saglabāts mākoņa krātuvē
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC uz Markdown, izmantojot cURL komandas
REST API nodrošina arī elastību, lai piekļūtu no jebkuras platformas, izmantojot cURL komandas. Tāpēc šajā sadaļā mēs apspriedīsim informāciju par to, kā ielādēt Word dokumentu no mākoņkrātuves, veikt DOCX konvertēšanu uz Markdown un saglabāt iegūto MD failu vietējā diskdzinī. Tagad vispirms mums ir jāģenerē JWT piekļuves marķieris (pamatojoties uz klienta akreditācijas datiem), izmantojot šo komandu, un pēc tam jāveic DOCX konvertēšana uz 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"
Kad JWT ir ģenerēts, lūdzu, izpildiet šo komandu, lai ielādētu Word dokumentu no mākoņa krātuves un veiktu Word konvertēšanu uz Markdown. Pēc tam iegūtais MD fails tiek saglabāts vietējā diskdzinī
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"
Secinājums
Esam nonākuši līdz šī raksta beigām, kur esam uzzinājuši, kā programmatiski pārvērst Word par Markdown, izmantojot Java. Tāpat mēs esam arī izpētījuši darbības DOCX konvertēšanai uz Markdown, izmantojot cURL komandas.
Vēl viena iespēja izpētīt API iespējas ir izmantot SwaggerUI tīmekļa pārlūkprogrammā. Mēs arī iesakām izpētīt Produkta dokumentāciju, kas ir lielisks informācijas avots, lai uzzinātu par citām aizraujošām funkcijām. Ja jums ir jālejupielādē un jāmaina Cloud SDK pirmkods, tas ir pieejams vietnē GitHub (publicēts saskaņā ar MIT licenci). Visbeidzot, ja API lietošanas laikā rodas problēmas, varat sazināties ar mums, lai ātri atrisinātu šo problēmu, izmantojot bezmaksas produktu atbalsta forumu.
Saistītie raksti
Lūdzu, apmeklējiet šīs saites, lai uzzinātu vairāk par: