Microsoft Word به طور گسترده برای ایجاد، ویرایش و تبدیل اسناد Word (DOC/DOCX) به فرمتهای مختلف استفاده میشود. به طور مشابه، Markdown یک زبان نشانه گذاری سبک وزن است که می توانید از آن برای افزودن عناصر قالب بندی به اسناد متنی ساده استفاده کنید. این یک سند متنی ساده است که باید بدون برچسبها قابل خواندن باشد، اما هنوز باید راههایی برای اضافه کردن اصلاحکنندههای متن مانند لیستها، بولد، مورب و غیره وجود داشته باشد. بنابراین اگر یک سند Word داریم و باید یک فایل معادل ایجاد کنیم. در نحو Markdown، ایجاد دستی آن دشوار می شود. با این حال، یک راه حل برنامه ای می تواند مشکل را حل کند. این مقاله قصد دارد تمام جزئیات را در مورد نحوه توسعه مبدل word به markdown با استفاده از Java Cloud SDK توضیح دهد.
API تبدیل Word به Markdown
API مبتنی بر REST ما با نام Aspose.Words Cloud یک راه حل شگفت انگیز برای اجرای عملیات ایجاد، دستکاری و تبدیل سند MS Word به انواع فرمت های پشتیبانی شده است. اکنون برای پیادهسازی قابلیتهای تبدیل سند و پردازش مشابه در برنامه جاوا، باید از Aspose.Words Cloud SDK برای جاوا استفاده کنیم که یک پوشش در اطراف REST API است. بنابراین در اولین مرحله استفاده از SDK، باید مرجع آن را با گنجاندن اطلاعات زیر در pom.xml (پروژه نوع ساخت maven) در پروژه جاوا خود اضافه کنیم.
<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>
هنگامی که مرجع SDK به پروژه اضافه شد، گام مهم بعدی دریافت اعتبار مشتری خود از Cloud Dashboard است. در غیر این صورت، ابتدا باید با استفاده از یک آدرس ایمیل معتبر، یک حساب کاربری رایگان ثبت کنید.
کلمه به MD در جاوا
این بخش مراحل و جزئیات مربوط به نحوه تبدیل Word به فرمت MD را با استفاده از قطعه کد جاوا توضیح می دهد. ما قصد داریم از دو گزینه برای بارگیری سند Word ورودی استفاده کنیم، یعنی از فضای ذخیره سازی ابری یا درایو محلی، و سپس آن را به فرمت Markdown تبدیل کنیم.
سند Word را از درایو محلی بارگیری کنید
- اول از همه، یک نمونه از WordsApi ایجاد کنید و اعتبار شخصی سازی شده را به عنوان آرگومان ارسال کنید
- در مرحله دوم، محتوای سند ورد ورودی را با استفاده از روش Files.readAllBytes(…) بخوانید و مقدار بازگشتی را در یک آرایه بایت[] دریافت کنید.
- سوم، یک شی از ConvertDocumentRequest ایجاد کنید که فایل ورد ورودی، فرمت MD و نام فایل Markdown حاصل را به عنوان آرگومان می گیرد.
- اکنون، متد convertDocument(…) را برای تبدیل Word به MD فراخوانی کنید. Markdown حاصل به عنوان جریان پاسخ برگردانده می شود تا در نمونه بایت[] ذخیره شود
- در نهایت، برای ذخیره Markdown حاصل در درایو محلی، یک شی از FileOutputStream ایجاد کنید و از روش نوشتن (…) آن استفاده کنید.
// برای کدهای بیشتر لطفاً https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// اگر baseUrl null باشد، WordsApi از https://api.aspose.cloud پیش فرض استفاده می کند
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
// سند word را از سیستم محلی بارگیری کنید
File file1 = new File("sample_EmbeddedOLE.docx");
// محتوای سند word ورودی را بخوانید
byte[] documentStream = Files.readAllBytes(file1.toPath());
// فرمت فایل حاصل
String format = "md";
// درخواست تبدیل سند را ایجاد کنید که در آن نام فایل حاصل را ارائه می دهیم
ConvertDocumentRequest convertRequest = new ConvertDocumentRequest(documentStream,format, null,null, null, null);
// تبدیل کلمه به علامت گذاری را انجام دهید و خروجی را در آرایه بایت ذخیره کنید
byte[] resultantFile = wordsApi.convertDocument(convertRequest);
// اسناد علامت گذاری حاصل را در درایو محلی ذخیره کنید
FileOutputStream fos = new FileOutputStream("/Users/nayyer/Documents/" + "resultant.md");
fos.write(resultantFile);
fos.close();
}catch(Exception ex)
{
System.out.println(ex);
}
میتوانید سند Word ورودی را از sampleEmbeddedOLE.docx دانلود کنید.
بارگیری سند Word از فضای ذخیرهسازی ابری
- به طور مشابه، ابتدا باید یک نمونه از WordsApi ایجاد کنیم، در حالی که اعتبار شخصی سازی شده را به عنوان آرگومان ارسال می کنیم.
- در مرحله دوم، یک شی از GetDocumentWithFormatRequest ایجاد کنید که نام فایل Word، فرمت MD و نام فایل Markdown حاصل را به عنوان آرگومان می گیرد.
- در نهایت، متد getDocumentWithFormat(..) را فراخوانی کنید که عملیات تبدیل Word به Markdown را راه اندازی می کند. فایل MD حاصل در فضای ذخیره سازی ابری ذخیره می شود
// برای کدهای بیشتر لطفاً https://github.com/aspose-words-cloud/aspose-words-cloud-java
try
{
String clientId = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
String clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
// اگر baseUrl null باشد، WordsApi از https://api.aspose.cloud پیش فرض استفاده می کند
WordsApi wordsApi = new WordsApi(clientId, clientSecret, null);
String format = "md";
// اکنون یک شی جدید از GetDocumentWithFormatRequest ایجاد کنید
GetDocumentWithFormatRequest convertRequest = new GetDocumentWithFormatRequest("sample_EmbeddedOLE.docx",format,null, null, null,null,null,"Converted.md",null);
// اکنون متد را برای شروع عملیات تبدیل فراخوانی کنید
// فایل حاصل در فضای ذخیره سازی ابری ذخیره می شود
wordsApi.getDocumentWithFormat(convertRequest);
}catch(Exception ex)
{
System.out.println(ex);
}
DOC برای علامت گذاری با استفاده از دستورات cURL
API های REST همچنین انعطاف پذیری را برای دسترسی از هر پلتفرمی با کمک دستورات cURL فراهم می کنند. بنابراین در این بخش، ما قصد داریم در مورد نحوه بارگیری سند Word از فضای ذخیره سازی ابری، انجام تبدیل DOCX به Markdown و ذخیره فایل MD حاصل در درایو محلی بحث کنیم. اکنون ابتدا باید توکن دسترسی JWT را با استفاده از دستور زیر تولید کنیم (بر اساس اعتبار مشتری) و سپس تبدیل DOCX به 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"
پس از تولید JWT، لطفاً دستور زیر را برای بارگیری سند Word از فضای ذخیرهسازی ابری و انجام تبدیل Word به Markdown اجرا کنید. سپس فایل MD حاصل در درایو محلی ذخیره می شود
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"
نتیجه
ما به انتهای این مقاله رسیدهایم که در آن جزئیات نحوه تبدیل برنامهنویسی Word به Markdown را با استفاده از جاوا آموختیم. به طور مشابه، ما مراحل تبدیل DOCX به Markdown را از طریق دستورات cURL نیز بررسی کرده ایم.
گزینه دیگری برای بررسی قابلیت های API از طریق SwaggerUI در یک مرورگر وب است. همچنین توصیه میکنیم [مستندات محصول11 را کاوش کنید که منبع شگفتانگیزی از اطلاعات برای یادگیری سایر ویژگیهای هیجانانگیز است. در صورت نیاز به دانلود و تغییر کد منبع Cloud SDK، در GitHub (منتشر شده تحت مجوز MIT) در دسترس است. در نهایت، اگر در هنگام استفاده از API با مشکلی مواجه شدید، ممکن است از طریق [تالار گفتمان پشتیبانی محصول] رایگان به ما برای حل و فصل سریع مراجعه کنید.
مقالات مرتبط
لطفا برای کسب اطلاعات بیشتر به لینک های زیر مراجعه کنید: