szó leértékelésre

A Word konvertálása Markdown-ra Java nyelven

A Microsoft Word-et széles körben használják Word-dokumentumok (DOC/DOCX) létrehozására, szerkesztésére és különféle formátumokba való átalakítására. Hasonlóképpen, a Markdown egy egyszerű jelölőnyelv, amellyel formázási elemeket adhat hozzá az egyszerű szöveges dokumentumokhoz. Ez egy egyszerű szöveges dokumentum, amely címkék nélkül is olvasható, de továbbra is léteznie kell olyan szövegmódosítók hozzáadásának, mint a listák, félkövér, dőlt betű stb. Tehát ha van Word dokumentumunk, és létre kell hoznunk egy ezzel egyenértékű fájlt Markdown szintaxisban nehéz manuálisan létrehozni. A programozott megoldás azonban megoldhatja a problémát. Ez a cikk minden részletet elmagyaráz a szóból leértékelés konverter fejlesztéséhez a Java Cloud SDK használatával.

Word to Markdown Conversion API

Az Aspose.Words Cloud névre keresztelt REST alapú API-nk egy csodálatos megoldás az MS Word dokumentumkészítési, -manipulációs és -konverziós műveleteinek megvalósítására számos támogatott formátumba. Most annak érdekében, hogy ugyanazokat a dokumentum-konverziós és -feldolgozási képességeket implementálhassuk a Java-alkalmazásban, az [Aspose.Words Cloud SDK for Java]-t 17 kell használnunk, amely a REST API köré épül. Tehát az SDK használatának első lépésében hozzá kell adnunk a hivatkozást a Java projektünkhöz az alábbi információkkal a pom.xml-ben (maven build típusú projekt).

<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>

Miután az SDK hivatkozást hozzáadta a projekthez, a következő fontos lépés az ügyfél hitelesítő adatainak beszerzése a Cloud Dashboard webhelyről. Ellenkező esetben először regisztrálnia kell egy ingyenes fiókot, miközben érvényes e-mail címet használ.

Word to MD Java nyelven

Ez a rész ismerteti a Word-et Java kódrészlet segítségével MD formátumba konvertálásával kapcsolatos lépéseket és a kapcsolódó részleteket. Két lehetőséget fogunk használni a bemeneti Word-dokumentum betöltésére, azaz a felhőalapú tárolásra vagy a helyi meghajtóra, majd átalakítjuk Markdown formátumra.

Töltse be a Word dokumentumot a helyi meghajtóról

  • Először is hozzon létre egy WordsApi példányt, és adja át a személyre szabott hitelesítő adatokat argumentumként
  • Másodszor olvassa el a bemeneti Word dokumentum tartalmát a Files.readAllBytes(…) metódussal, és kapjon visszaadott értéket egy byte[] tömbben
  • Harmadszor, hozzon létre egy ConvertDocumentRequest objektumot, amely argumentumként veszi a bevitt Word fájlt, MD formátumot és az eredményül kapott Markdown fájl nevét.
  • Most hívja meg a convertDocument(…) metódust a Word MD konvertálásához. Az eredményül kapott Markdown válaszfolyamként kerül visszaadásra, amelyet a byte[] példányba kell menteni
  • Végül az eredményül kapott Markdown helyi meghajtóra mentéséhez hozzon létre egy FileOutputStream objektumot, és használja a write(…) metódust.
// További kódrészletekért kérjük, látogasson el a https://github.com/aspose-words-cloud/aspose-words-cloud-java oldalra

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// ha a baseUrl értéke null, a WordsApi az alapértelmezett https://api.aspose.cloud címet használja
	WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
			
        // Word dokumentum betöltése a helyi rendszerből
        File file1 = new File("sample_EmbeddedOLE.docx");

        // olvassa el az input word dokumentum tartalmát
        byte[] documentStream = Files.readAllBytes(file1.toPath());
  
        // eredő fájlformátum
        String format = "md";

        // hozzon létre egy dokumentumkonverziós kérelmet, ahol megadjuk az eredményül kapott fájlnevet
        ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
  
        // hajtson végre szó leértékelésre konvertálást, és mentse a kimenetet bájttömbbe
        byte[] resultantFile = wordsApi.convertDocument(convertRequest);
        
        // Mentse az eredményül kapott leértékelési dokumentációt a helyi meghajtóra
	FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
	fos.write(resultantFile);
	fos.close();
      
    }catch(Exception ex)
    {
	System.out.println(ex);
    }
szót Markdownnak

Kép: - Word to Markdown konverziós előnézet

Érdemes lehet letölteni a bemeneti Word-dokumentumot a sampleEmbeddedOLE.docx webhelyről.

Word-dokumentum betöltése a felhőtárhelyről

  • Ehhez hasonlóan először létre kell hoznunk egy WordsApi példányt, miközben személyre szabott hitelesítő adatokat adunk át argumentumként
  • Másodszor, hozzon létre egy GetDocumentWithFormatRequest objektumot, amely argumentumként veszi a bemeneti Word fájl nevét, MD formátumát és az eredményül kapott Markdown fájl nevét.
  • Végül hívja meg a getDocumentWithFormat(..) metódust, amely elindítja a Word to Markdown konverziós műveletet. Az eredményül kapott MD-fájlt a rendszer a felhőtárhelyen menti
// További kódrészletekért kérjük, látogasson el a https://github.com/aspose-words-cloud/aspose-words-cloud-java oldalra

try
    {
        String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
	String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
		    
	// ha a baseUrl értéke null, a WordsApi az alapértelmezett https://api.aspose.cloud címet használja
	WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);

        String format = "md";
        // most hozzon létre egy új GetDocumentWithFormatRequest objektumot 
        GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);

        // most hívja meg a metódust az átalakítási művelet elindításához
        // az eredményül kapott fájl felhőtárhelyen tárolódik
        wordsApi.getDocumentWithFormat(convertRequest);
      
    }catch(Exception ex)
    {
	System.out.println(ex);
    }

DOC a Markdownba a cURL parancsok használatával

A REST API-k azt a rugalmasságot is biztosítják, hogy a cURL parancsok segítségével bármilyen platformról elérhetők legyenek. Tehát ebben a részben megvitatjuk a Word-dokumentumok felhőalapú tárhelyről történő betöltésének, a DOCX-ből Markdown konvertálásának és a kapott MD-fájl helyi meghajtóra való mentésének részleteit. Most először létre kell hoznunk a JWT hozzáférési jogkivonatot (az ügyfél hitelesítő adatai alapján) a következő paranccsal, majd végre kell hajtanunk a DOCX-ből Markdown konverziót.

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"

A JWT létrehozása után hajtsa végre a következő parancsot a Word-dokumentum betöltéséhez a felhőtárhelyről, és hajtsa végre a Word-ből Markdown konvertálást. Az eredményül kapott MD-fájl ezután a helyi meghajtón tárolódik

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"

Következtetés

Elérkeztünk a cikk végéhez, ahol megtudtuk, hogyan konvertálhatjuk programozottan a Word-t Markdown-ra Java használatával. Hasonlóképpen megvizsgáltuk a DOCX-nek Markdown-ra konvertálásának lépéseit is cURL-parancsokkal.

Egy másik lehetőség az API képességeinek felfedezésére a SwaggerUI segítségével a webböngészőn belül. Azt is javasoljuk, hogy tekintse meg a Termékdokumentációt, amely csodálatos információforrás az egyéb izgalmas funkciók megismeréséhez. Abban az esetben, ha le kell töltenie és módosítania kell a Cloud SDK forráskódját, az elérhető a GitHub oldalon (MIT-licenc alatt jelent meg). Végül, ha bármilyen problémába ütközik az API használata során, megfontolhatja, hogy felkeressen minket egy ingyenes terméktámogatási fórumon található gyors megoldás érdekében.

kapcsolódó cikkek

Kérjük, látogasson el az alábbi linkekre, ha többet szeretne megtudni erről: