Microsoft Word er meget brugt til at oprette, redigere og transformere Word-dokumenter (DOC/DOCX) til forskellige formater. Tilsvarende er Markdown et let opmærkningssprog, som du kan bruge til at tilføje formateringselementer til almindelige tekstdokumenter. Det er et almindeligt tekstdokument, som skal kunne læses, uden at tags skal slå alt op, men der skulle stadig være måder at tilføje tekstmodifikatorer som lister, fed, kursiv osv. Så hvis vi har et Word-dokument og vi skal lave en tilsvarende fil i Markdown-syntaks bliver det svært at oprette det manuelt. En programmatisk løsning kan dog løse problemet. Denne artikel vil forklare alle detaljerne om, hvordan man udvikler ord til markdown-konverter ved hjælp af Java Cloud SDK.
Word to Markdown Conversion API
Vores REST-baserede API ved navn Aspose.Words Cloud er en fantastisk løsning til at implementere MS Word-dokumentoprettelse, manipulation og konverteringsoperationer til forskellige understøttede formater. For nu at implementere de samme dokumentkonverterings- og behandlingsmuligheder i Java-applikationen, skal vi bruge Aspose.Words Cloud SDK for Java, som er en indpakning omkring REST API. Så i det første trin af SDK-udnyttelse skal vi tilføje dens reference i vores Java-projekt ved at inkludere følgende oplysninger i 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>
Når SDK-referencen er blevet tilføjet i projektet, er det næste vigtige skridt at få dine klientoplysninger fra Cloud Dashboard. Ellers skal du først registrere en gratis konto, mens du bruger en gyldig e-mailadresse.
Word til MD i Java
Dette afsnit forklarer trinene og relaterede detaljer om, hvordan vi kan konvertere Word til MD-format ved hjælp af Java-kodestykke. Vi vil bruge to muligheder for at indlæse input Word-dokumentet, dvs. form Cloud-lagring eller lokalt drev, og derefter transformere det til Markdown-format.
Indlæs Word-dokument fra lokalt drev
- Først og fremmest skal du oprette en forekomst af WordsApi og sende personlige legitimationsoplysninger som argumenter
- For det andet, læs indholdet af input Word-dokument ved hjælp af Files.readAllBytes(…) metoden og få returneret værdi i et byte[] array
- For det tredje skal du oprette et objekt af ConvertDocumentRequest, som tager input Word-fil, MD-format og den resulterende Markdown-fils navn som argumenter
- Kald nu metode convertDocument(…) for Word til MD-konvertering. Den resulterende Markdown returneres som svarstrøm for at blive gemt i byte[]-instans
- Til sidst, for at gemme den resulterende Markdown til lokalt drev, skal du oprette et objekt af FileOutputStream og bruge dets skrive(…) metode
// For flere kodestykker, venligst https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// hvis baseUrl er null, bruger WordsApi standard https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// indlæs word-dokument fra det lokale system
File file1 = new File("sample_EmbeddedOLE.docx");
// læse indholdet af input word-dokument
byte[] documentStream = Files.readAllBytes(file1.toPath());
// resulterende filformat
String format = "md";
// oprette dokumentkonverteringsanmodning, hvor vi giver det resulterende filnavn
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// udfør ord til markdown konvertering og gem output i byte Array
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Gem den resulterende markdown-dokumentation på det lokale drev
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Du kan overveje at downloade Word-dokumentet fra sampleEmbeddedOLE.docx.
Indlæs Word-dokument fra Cloud Storage
- På samme måde skal vi først oprette en forekomst af WordsApi, mens vi sender personlige legitimationsoplysninger som argumenter
- For det andet skal du oprette et objekt af GetDocumentWithFormatRequest, som tager input Word-filnavn, MD-format og resulterende Markdown-fils navn som argumenter
- Til sidst skal du kalde metoden getDocumentWithFormat(..), som udløser konverteringshandlingen Word til Markdown. Den resulterende MD-fil gemmes i skylageret
// For flere kodestykker, venligst https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// hvis baseUrl er null, bruger WordsApi standard https://api.aspose.cloud
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// opret nu et nyt objekt i GetDocumentWithFormatRequest
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// kald nu metoden for at starte konverteringsoperationen
// den resulterende fil gemmes i skylageret
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC til Markdown ved hjælp af cURL-kommandoer
REST API’erne giver også fleksibiliteten til at få adgang til fra enhver platform ved hjælp af cURL-kommandoer. Så i dette afsnit vil vi diskutere detaljerne om, hvordan man indlæser Word-dokument fra Cloud-lagring, udfører DOCX til Markdown-konvertering og gemmer den resulterende MD-fil på lokalt drev. Nu skal vi først generere JWT-adgangstokenet (baseret på klientlegitimationsoplysninger) ved hjælp af følgende kommando og derefter udføre DOCX til Markdown-konvertering.
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"
Når JWT er genereret, skal du udføre følgende kommando for at indlæse Word-dokument fra Cloud-lager og udføre Word til Markdown-konvertering. Den resulterende MD-fil gemmes derefter på det lokale drev
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"
Konklusion
Vi er nået til slutningen af denne artikel, hvor vi har lært detaljerne om, hvordan vi programmæssigt kan konvertere Word til Markdown ved hjælp af Java. På samme måde har vi også undersøgt trinene til at konvertere DOCX til Markdown via cURL-kommandoer.
En anden mulighed for at udforske API’s muligheder er gennem SwaggerUI i en webbrowser. Vi anbefaler også at udforske Produktdokumentation, som er en fantastisk kilde til information for at lære om andre spændende funktioner. Hvis du har brug for at downloade og ændre kildekoden til Cloud SDK, er den tilgængelig på GitHub (udgivet under MIT-licens). Til sidst, hvis du støder på problemer, mens du bruger API’en, kan du overveje at kontakte os for en hurtig løsning via gratis produktsupportforum.
relaterede artikler
Besøg venligst følgende links for at lære mere om: