Defnyddir Microsoft Word yn eang i greu, golygu a thrawsnewid dogfennau Word (DOC/DOCX) i fformatau amrywiol. Yn yr un modd, mae Markdown yn iaith farcio ysgafn y gallwch ei defnyddio i ychwanegu elfennau fformatio at ddogfennau testun plaen. Mae’n ddogfen testun plaen a fydd yn ddarllenadwy heb dagiau yn synfyfyrio popeth, ond dylai fod ffyrdd o hyd o ychwanegu addaswyr testun fel rhestrau, print trwm, italig, ac ati. Felly os oes gennym ddogfen Word a bod angen i ni greu ffeil gyfatebol yng nghystrawen Markdown, mae’n mynd yn anodd ei greu â llaw. Fodd bynnag, gall datrysiad rhaglennol ddatrys problem. Mae’r erthygl hon yn mynd i esbonio’r holl fanylion ar sut i ddatblygu trawsnewidydd gair i farcio gan ddefnyddio Java Cloud SDK.
API Trosi Word i Markdown
Mae ein API seiliedig ar REST o’r enw Aspose.Words Cloud yn ddatrysiad anhygoel i weithredu gweithrediadau creu, trin a throsi dogfennau MS Word i amrywiaeth o fformatau a gefnogir. Nawr er mwyn gweithredu’r un galluoedd trosi a phrosesu dogfennau mewn cymhwysiad Java, mae angen i ni ddefnyddio Aspose.Words Cloud SDK ar gyfer Java sy’n ddeunydd lapio o amgylch REST API. Felly yn y cam cyntaf o ddefnyddio SDK, mae angen i ni ychwanegu ei gyfeirnod yn ein prosiect Java trwy gynnwys y wybodaeth ganlynol yn pom.xml (prosiect math adeiladu maven).
<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>
Unwaith y bydd y cyfeirnod SDK wedi’i ychwanegu yn y prosiect, y cam pwysig nesaf yw cael eich tystlythyrau cleient o Dangosfwrdd Cwmwl. Fel arall, mae angen i chi gofrestru cyfrif am ddim yn gyntaf wrth ddefnyddio cyfeiriad e-bost dilys.
Gair i MD yn Java
Mae’r adran hon yn esbonio’r camau a’r manylion cysylltiedig ar sut y gallwn drosi fformat Word i fformat MD gan ddefnyddio pyt cod Java. Rydyn ni’n mynd i ddefnyddio dau opsiwn ar gyfer llwytho’r ddogfen Word mewnbwn hy o storfa Cloud neu yriant lleol, ac yna ei drawsnewid i fformat Markdown.
Llwytho Dogfen Word o yriant lleol
- Yn gyntaf oll, crëwch enghraifft o WordsApi a phasio tystlythyrau personol fel dadleuon
- Yn ail, darllenwch gynnwys dogfen mewnbwn Word gan ddefnyddio dull Files.readAllBytes(…) a chael gwerth dychwelyd mewn arae beit[]
- Yn drydydd, creu gwrthrych o ConvertDocumentRequest sy’n cymryd ffeil Word mewnbwn, fformat MD ac enw’r ffeil Markdown canlyniadol fel dadleuon
- Nawr, ffoniwch ddull convertDocument (…) ar gyfer trosi Word i MD. Mae’r Markdown canlyniadol yn cael ei ddychwelyd fel ffrwd ymateb, i’w gadw mewn enghraifft beit[]
- Yn olaf, er mwyn arbed y Markdown canlyniadol i yriant lleol, crëwch wrthrych o FileOutputStream a defnyddiwch ei ddull ysgrifennu (…)
// Am fwy o bytiau cod, os gwelwch yn dda https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// os yw baseUrl yn null, mae WordsApi yn defnyddio https://api.aspose.cloud diofyn
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// llwytho dogfen Word o'r system leol
File file1 = new File("sample_EmbeddedOLE.docx");
// darllen cynnwys dogfen mewnbwn Word
byte[] documentStream = Files.readAllBytes(file1.toPath());
// fformat ffeil canlyniadol
String format = "md";
// creu cais trosi Dogfen lle rydym yn darparu enw ffeil canlyniadol
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// perfformio trosi gair i markdown ac arbed allbwn yn Array beit
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// Cadw dogfennau marcio i lawr canlyniadol i yriant lleol
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
Efallai y byddwch yn ystyried lawrlwytho’r ddogfen mewnbwn Word o sampleEmbeddedOLE.docx.
Llwytho Dogfen Word o Cloud Storage
- Yn yr un modd, yn gyntaf mae angen i ni greu enghraifft o WordsApi wrth basio tystlythyrau personol fel dadleuon
- Yn ail, creu gwrthrych o GetDocumentWithFormatRequest sy’n cymryd enw ffeil Word, fformat MD ac enw ffeil Markdown canlyniadol fel dadleuon
- Yn olaf, ffoniwch y dull getDocumentWithFormat (..) sy’n sbarduno gweithrediad trosi Word to Markdown. Mae’r ffeil MD canlyniadol yn cael ei chadw yn storfa Cloud
// Am fwy o bytiau cod, os gwelwch yn dda https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// os yw baseUrl yn null, mae WordsApi yn defnyddio https://api.aspose.cloud diofyn
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// nawr creu gwrthrych newydd o GetDocumentWithFormatRequest
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// nawr ffoniwch y dull i gychwyn y gweithrediad trosi
// mae'r ffeil canlyniadol yn cael ei storio mewn storfa cwmwl
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC i Markdown gan ddefnyddio Gorchmynion cURL
Mae’r APIs REST hefyd yn darparu’r hyblygrwydd i gael mynediad o unrhyw lwyfan gyda chymorth gorchmynion cURL. Felly yn yr adran hon, rydyn ni’n mynd i drafod y manylion ar sut i lwytho dogfen Word o storfa Cloud, perfformio trosi DOCX i Markdown ac arbed y ffeil MD canlyniadol ar yriant lleol. Nawr yn gyntaf mae angen i ni gynhyrchu tocyn mynediad JWT (yn seiliedig ar gymwysterau cleient) gan ddefnyddio’r gorchymyn canlynol ac yna perfformio trosi DOCX i 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"
Unwaith y bydd y JWT wedi’i gynhyrchu, gweithredwch y gorchymyn canlynol i lwytho dogfen Word o storfa Cloud a pherfformio trosi Word i Markdown. Yna caiff y ffeil MD ddilynol ei storio ar yriant lleol
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"
Casgliad
Rydym wedi cyrraedd diwedd yr erthygl hon lle rydym wedi dysgu’r manylion ar sut y gallwn drosi Word i Markdown yn rhaglennol gan ddefnyddio Java. Yn yr un modd, rydym hefyd wedi archwilio’r camau ar gyfer trosi DOCX i Markdown trwy orchmynion cURL.
Opsiwn arall i archwilio galluoedd API yw trwy SwaggerUI o fewn porwr gwe. Rydym hefyd yn argymell archwilio’r Dogfennaeth Cynnyrch sy’n ffynhonnell anhygoel o wybodaeth i ddysgu am nodweddion cyffrous eraill. Rhag ofn bod angen i chi lawrlwytho ac addasu cod ffynhonnell Cloud SDK, mae ar gael ar GitHub (cyhoeddwyd o dan drwydded MIT). Yn olaf, rhag ofn y byddwch chi’n dod ar draws unrhyw broblemau wrth ddefnyddio’r API, efallai y byddwch chi’n ystyried cysylltu â ni i gael datrysiad cyflym trwy [fforwm cymorth cynnyrch] rhad ac am ddim 9.
Erthyglau Perthnasol
Ewch i’r dolenni canlynol i ddysgu mwy am: