מילה לסימון

המרת Word ל-Markdown ב-Java

Microsoft Word נמצא בשימוש נרחב ליצירה, עריכה והפיכה של מסמכי Word (DOC/DOCX) לפורמטים שונים. באופן דומה, Markdown היא שפת סימון קלת משקל שבה אתה יכול להשתמש כדי להוסיף רכיבי עיצוב למסמכי טקסט רגיל. זהו מסמך טקסט רגיל שיהיה קריא בלי שתגיות יטענו את הכל, אבל עדיין צריכות להיות דרכים להוסיף שינויי טקסט כמו רשימות, מודגשות, נטוי וכו’. אז אם יש לנו מסמך וורד ואנחנו צריכים ליצור קובץ שווה ערך בתחביר Markdown, קשה ליצור אותו באופן ידני. עם זאת, פתרון פרוגרמטי יכול לפתור בעיה. מאמר זה הולך להסביר את כל הפרטים כיצד לפתח ממיר מילה לסימון באמצעות Java Cloud SDK.

Word to Markdown Conversion API

ה-API מבוסס REST שלנו בשם Aspose.Words Cloud הוא פתרון מדהים ליישם פעולות יצירה, מניפולציה והמרה של מסמכי MS Word למגוון פורמטים נתמכים. כעת על מנת ליישם את אותן יכולות המרה ועיבוד של מסמכים באפליקציית Java, עלינו להשתמש ב-Aspose.Words Cloud SDK עבור Java שהוא מעטפת סביב REST API. אז בשלב הראשון של ניצול SDK, עלינו להוסיף את ההתייחסות שלו לפרויקט Java שלנו על ידי הכללת המידע הבא ב-pom.xml (פרויקט מסוג maven build).

<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. אחרת, תחילה עליך לרשום חשבון בחינם תוך שימוש בכתובת דוא"ל חוקית.

Word ל-MD ב-Java

סעיף זה מסביר את השלבים והפרטים הקשורים כיצד אנו יכולים להמיר Word לפורמט MD באמצעות קטע קוד Java. אנו הולכים להשתמש בשתי אפשרויות לטעינת מסמך Word הקלט, כלומר אחסון ענן או כונן מקומי, ולאחר מכן להפוך אותו לפורמט Markdown.

טען מסמך Word מהכונן המקומי

  • קודם כל, צור מופע של WordsApi והעבר אישורים מותאמים אישית כטיעונים
  • שנית, קרא את התוכן של מסמך Word הקלט באמצעות שיטת Files.readAllBytes(…) וקבל ערך מוחזר במערך byte[]
  • שלישית, צור אובייקט של ConvertDocumentRequest אשר לוקח את קובץ הקלט של Word, פורמט MD ושם קובץ Markdown כתוצאה מכך כארגומנטים
  • כעת, קרא לשיטת convertDocument(…) עבור המרה של Word ל-MD. ה-Markdown שנוצר מוחזר כזרם תגובה, כדי להישמר במופע byte[]
  • לבסוף, על מנת לשמור את ה-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);
			
        // טען מסמך וורד מהמערכת המקומית
        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);
    }
מילה ל-Markdown

תמונה: - תצוגה מקדימה של המרת Word to Markdown

אתה יכול לשקול להוריד את מסמך Word הקלט מ-sampleEmbeddedOLE.docx.

טען מסמך Word מ-Cloud Storage

  • באופן דומה, ראשית עלינו ליצור מופע של WordsApi תוך העברת אישורים מותאמים אישית כטיעונים
  • שנית, צור אובייקט של GetDocumentWithFormatRequest אשר לוקח את שם קובץ Word, פורמט MD ושם קובץ Markdown שהתקבל כארגומנטים
  • לבסוף, קרא למתודה getDocumentWithFormat(..) אשר מפעילה את פעולת ההמרה Word to 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 ל-Markdown באמצעות פקודות 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 באופן תוכניתי באמצעות Java. באופן דומה, חקרנו גם את השלבים להמרת DOCX ל-Markdown באמצעות פקודות cURL.

אפשרות נוספת לחקור את היכולות של API היא באמצעות SwaggerUI בדפדפן אינטרנט. אנו ממליצים גם לחקור את תיעוד המוצר שהוא מקור מדהים למידע כדי ללמוד על תכונות מרגשות אחרות. במקרה שאתה צריך להוריד ולשנות את קוד המקור של Cloud SDK, הוא זמין ב-GitHub (פורסם ברישיון MIT). לבסוף, במקרה שאתה נתקל בבעיות כלשהן במהלך השימוש ב-API, תוכל לשקול לפנות אלינו לפתרון מהיר דרך פורום תמיכת מוצרים בחינם.

מאמרים קשורים

אנא בקר בקישורים הבאים כדי ללמוד עוד על: