פורמט HTML הוא אחד הפורמטים העיקריים של אתרי אינטרנט מכיוון שרוב הדפדפנים תומכים בתקן זה. בעוד שקובץ Markdown הוא קובץ טקסט שנוצר באמצעות אחד מכמה דיאלקטים אפשריים של שפת Markdown. הוא משתמש בעיצוב טקסט רגיל אך מכיל סמלי טקסט מוטבעים המציינים כיצד לעצב את הטקסט (למשל, \bold\ עבור טקסט מודגש, או סימונים אחרים עבור נטוי, הזחה, כותרות וכו’). אנא שים לב שקובצי Markdown עשויים להשתמש בסיומת .MD, .MARKDN ו-.MDOWN, כאשר הסיומות “.markdown” ו-".md" הן הפופולריות ביותר. אז במאמר זה, אנו הולכים לדון בפרטים של המרת HTML ל-Markdown באמצעות REST API.
HTML ל-Markdown Conversion API
Aspose.HTML Cloud הוא API מוביל לעיבוד קבצי HTML המספק את היכולות לתפעל קבצי HTML. הוא תומך גם בתכונה להמרת HTML ל-PDF, JPG, TIFF, XPS ושאר פורמטים נתמכים. זה גם תומך בתכונה להמרת HTML לפורמט MD. כעת על מנת לפתח ממיר HTML ל-Markdown באמצעות שפת Java, ראשית עלינו להוסיף תחילה Aspose.HTML Cloud SDK להתייחסות ל-Java בקובץ pom.xml מסוג maven build.
<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.8.0</version>
</dependency>
</dependencies>
לאחר ההתקנה, אנא צור חשבון מנוי בחינם בשירותי הענן שלנו באמצעות מרכז השליטה של Aspose.Cloud באמצעות GitHub או חשבון Google. לחלופין, פשוט צור חשבון חדש וקבל את פרטי אישורי הלקוח שלך.
המרת HTML ל-Markdown ב-Java
אנא עקוב אחר ההוראות המפורטות להלן כדי להמיר HTML ל-Markdown.
- ראשית, העבירו אישורי לקוח מול שיטות Configuration.setAPPSID ו-Configuration.setAPIKEY.
- שנית, הגדר פרטים עבור setBasePath(..), setAuthPath(..) וציין את setUserAgent(…) בתור WebKit.
- שלישית, העבר אמת לשיטת setDebug(..).
- לאחר הגדרת התצורה, נא ליצור אובייקט ממחלקת ConversionApi.
- לבסוף, קרא לשיטה PutConvertDocumentToMarkdown(…) כדי להמיר HTML ל-Markdown ולשמור את הפלט באחסון בענן.
// לדוגמאות נוספות, בקר בכתובת https://github.com/aspose-html-cloud/aspose-html-cloud-java
try
{
// קבל ClientID ו-ClientSecret מ-https://dashboard.aspose.cloud/
String clientId = "bbf94a2c-6d7e-4020-b4d2-b9809741374e";
String clientSecret = "1c9379bb7d701c26cc87e741a29987bb";
// פרטים להזמנת Api
com.aspose.html.Configuration.setAPP_SID(clientId);
com.aspose.html.Configuration.setAPI_KEY(clientSecret);
com.aspose.html.Configuration.setBasePath("https://api.aspose.cloud/v3.0");
com.aspose.html.Configuration.setAuthPath("https://api.aspose.cloud/connect/token");
com.aspose.html.Configuration.setUserAgent("WebKit");
com.aspose.html.Configuration.setDebug(true);
// צור אובייקט של Aspose.HTML Cloud API
com.aspose.html.api.ConversionApi htmlApi = new ApiClient().createService(ConversionApi.class);
// מסמך ה-html מאחסון ענן
String name = "list.html";
String folder = null; // The folder in the storage. Should exist.
String storage = "Internal"; // Name of the storage. null
// הכן ביצוע שיחה
retrofit2.Call<okhttp3.ResponseBody> call = htmlApi.PutConvertDocumentToMarkdown(name, "Converted.md", true, folder, storage);
System.out.println("HTML to Markdown conversion sucessfull !");
}catch(Exception ex)
{
System.out.println(ex);
}
HTML ל-MD באמצעות פקודות cURL
מכיוון ש-Aspose.HTML Cloud מבוסס על ארכיטקטורת REST, כך שניתן לגשת אליו בקלות באמצעות פקודות cURL. כעת, כתנאי מוקדם, עלינו ליצור אסימון גישה ל-JWT בהתבסס על אישורי לקוח שצוינו מול חשבונך בלוח המחוונים בענן. כעת, אנא בצע את הפקודה הבאה כדי ליצור את אסימון JWT:
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
ברגע שיש לנו את אסימון JWT, אנא בצע את הפקודה הבאה ל-HTML ל-MD.
curl -v -X PUT "https://api.aspose.cloud/html/list.html/convert/md?outPath=Converted.md&useGit=false" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
סיכום
מאמר זה סיפק מקור מצוין ללימוד השלבים לפיתוח ממיר HTML ל-Markdown באמצעות Java Cloud SDK. ראינו שעם פחות שורות קוד, הצלחנו להמיר HTML לפורמט MD. אתה יכול גם לשקול לחקור את ממשקי ה-API דרך Swagger UI בדפדפן אינטרנט. אם יש לך שאלות קשורות כלשהן, או שאתה נתקל בבעיות כלשהן, אנא אל תהסס לפנות אלינו דרך [פורום התמיכה הטכנית] החינמית 12.
מאמרים קשורים
אנו ממליצים בחום לעבור על המאמרים הבאים כדי ללמוד עליהם יותר: