HTML ფორმატი არის ვებსაიტების ერთ-ერთი ძირითადი ფორმატი, რადგან ბრაუზერების უმეტესობა მხარს უჭერს ამ სტანდარტს. მაშინ როცა, Markdown ფაილი არის ტექსტური ფაილი, რომელიც შექმნილია Markdown ენის რამდენიმე შესაძლო დიალექტის გამოყენებით. იგი იყენებს უბრალო ტექსტის ფორმატირებას, მაგრამ შეიცავს ტექსტის შიდა სიმბოლოებს, რომლებიც აკონკრეტებენ ტექსტის ფორმატირებას (მაგ., \bold\ თამამი ტექსტისთვის, ან სხვა მარკირება დახრილი, ჩაღრმავება, სათაურები და ა.შ.). გთხოვთ გაითვალისწინოთ, რომ Markdown ფაილებმა შეიძლება გამოიყენონ .MD, .MARKDN და .MDOWN გაფართოებები, სადაც “.markdown” და “.md” გაფართოებები ყველაზე პოპულარულია. ამრიგად, ამ სტატიაში ჩვენ განვიხილავთ HTML-ის Markdown-ში გადაქცევის დეტალებს REST API-ის გამოყენებით.
- HTML to Markdown Conversion API
- გადაიყვანეთ HTML Markdown-ად Java-ში
- HTML-დან MD-მდე cURL ბრძანებების გამოყენებით
HTML to Markdown Conversion API
Aspose.HTML Cloud არის წამყვანი HTML ფაილების დამუშავების API, რომელიც უზრუნველყოფს HTML ფაილების მანიპულირების შესაძლებლობებს. ის ასევე მხარს უჭერს HTML-ის გარდაქმნის ფუნქციას PDF, JPG, TIFF, XPS და სხვა მხარდაჭერილ ფორმატებში. ის ასევე მხარს უჭერს HTML-ის MD ფორმატში გადაყვანის ფუნქციას. ახლა იმისათვის, რომ განვავითაროთ HTML to markdown კონვერტორი Java ენის გამოყენებით, ჯერ უნდა დავამატოთ Aspose.HTML Cloud SDK Java-ს მითითებისთვის Maven build ტიპის pom.xml ფაილში.
<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 dashboard-ის მეშვეობით 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>"
დასკვნა
ეს სტატია შესანიშნავი წყაროა Java Cloud SDK-ის გამოყენებით HTML-ის Markdown-ის კონვერტორის განვითარების საფეხურების შესასწავლად. ჩვენ დავინახეთ, რომ ნაკლები კოდის ხაზებით, ჩვენ მოვახერხეთ HTML-ის MD ფორმატში გადაყვანა. თქვენ ასევე შეგიძლიათ განიხილოთ API-ების შესწავლა Swagger UI-ის მეშვეობით ვებ ბრაუზერში. თუ თქვენ გაქვთ რაიმე დაკავშირებული შეკითხვა, ან რაიმე პრობლემა შეგექმნათ, გთხოვთ, ნუ მოგერიდებათ დაგვიკავშირდეთ უფასო [ტექნიკური მხარდაჭერის ფორუმის] მეშვეობით.
დაკავშირებული სტატიები
ჩვენ გირჩევთ გაეცნოთ შემდეგ სტატიებს მათ შესახებ მეტის გასაგებად: