מניפולציה של קבצי HTML באופן תכנותי היא חיונית לבניית כלי ועורכי תוכן אינטרנט דינאמיים. Aspose.HTML for Python via .NET מספק מימוש DOM מבוסס תקנים המאפשר לבנות מסמכים מאפס, לבדוק סימון קיים ולשכתב אותו — כל זאת ללא דפדפן וללא ביטויים רגולריים. מדריך זה מחלק את העבודה לשלושה חלקים ממוקדים: create, read, ו-edit, שלכל אחד מהם דוגמה ניתנת להרצה. בסיום יהיה לכם זרימת עבודה שניתנת לשימוש חוזר שניתן לשלב בכל צינור תוכן מבוסס Python.

לפני שאתה מתחיל: דרישות קדם והתקנה

כדי לעקוב אחרי המדריך הזה אתה צריך:

  • Python 3.8 או גרסה חדשה יותר מותקן במכונת הפיתוח שלך.
  • מערכת הפעלה 64‑ביט (Windows, Linux או macOS) — החבילה כוללת קבצי בינאריים מקומיים של .NET.
  • רישיון חוקי של Aspose.HTML for Python via .NET (רישיונות זמניים זמינים).

התקן את ה‑SDK באמצעות pip:

pip install aspose-html-net

אתה יכול גם להוריד את הקבצים הבינאריים העדכניים ישירות מדף ההורדה. לאחר ההתקנה, ייבא את הסוגים שאתה צריך:

from aspose.html import HTMLDocument
from aspose.html.saving import HTMLSaveOptions

אם יש לך קובץ רישיון, יש להחיל אותו פעם אחת בעת הפעלת היישום כך שהפלט יהיה חופשי ממגבלות הערכה:

from aspose.html import License

license = License()
license.set_license("Aspose.HTML.Python.lic")

כאשר ה‑SDK מוכן, בואו נעבור על שלוש הפעולות המרכזיות.

בנייה שלב אחר שלב: יצירת קריאה ועריכת HTML בפייתון

יצירת מסמך HTML ב-Python

מסמך HTMLDocument ריק כבר מכיל את שלד ה-html, head ו-body, כך שניתן להתחיל לצרף צמתים מיד. אלמנטים נוצרים באמצעות create_element(), צמתים של טקסט באמצעות create_text_node(), ושניהם מצורפים לעץ באמצעות append_child().

from aspose.html import HTMLDocument

# An empty document already has <html>, <head>, and <body>
document = HTMLDocument()
document.title = "Sample Document"

# <h1 id="mainHeader">Welcome to Aspose.HTML</h1>
header = document.create_element("h1")
header.set_attribute("id", "mainHeader")
header.append_child(document.create_text_node("Welcome to Aspose.HTML"))
document.body.append_child(header)

# <p>This document was generated programmatically.</p>
paragraph = document.create_element("p")
paragraph.text_content = "This document was generated programmatically."
document.body.append_child(paragraph)

document.save("created.html")

מכיוון שכל צומת נוצר דרך המסמך, הסימון המתקבל תמיד תקין — ללא איזון ידני של תגיות וללא חיבור מחרוזות.

קריאת מסמך HTML קיים באמצעות Python

העבר נתיב קובץ לבנאי HTMLDocument ו‑Aspose.HTML מנתח את הקובץ לעץ DOM חי. משם אתה מבצע שאילתות בדיוק כפי שהיית עושה בדפדפן: לפי מזהה, לפי שם תג, או עם בורר CSS.

from aspose.html import HTMLDocument

document = HTMLDocument("created.html")
print("Title:", document.title)

# Look up a single element by its id
header = document.get_element_by_id("mainHeader")
if header is not None:
    print("Header:", header.text_content)

# Iterate over every paragraph in the document
paragraphs = document.get_elements_by_tag_name("p")
for index in range(paragraphs.length):
    print(f"Paragraph {index}:", paragraphs[index].text_content)

# CSS selectors work too
for link in document.query_selector_all("a[href]"):
    print("Link:", link.get_attribute("href"))

# Serialize the whole tree back to markup when you need the raw HTML
print(document.document_element.outer_html)

אתה יכול גם לנתח סימון שכבר נמצא בזיכרון על‑ידי העברת התוכן יחד עם כתובת בסיס (URI), מה שמועיל כאשר ה‑HTML מגיע מתגובה של API:

content = "<html><body><p>Loaded from a string.</p></body></html>"
document = HTMLDocument(content, ".")

ערוך מסמך HTML קיים ב-Python

העריכה היא רק שינוי של DOM: הקצה ל-text_content או inner_html, שנה תכונות עם set_attribute(), הוסף צמתים עם append_child(), והסר צמתים עם remove_child(). שמור את התוצאה כשסיימת.

from aspose.html import HTMLDocument

document = HTMLDocument("created.html")
# 1. Update the document title
document.title = "Edited Document Title"

# 2. Replace the header text
header = document.get_element_by_id("mainHeader")
if header is not None:
    header.text_content = "Edited Header via Aspose.HTML"

# 3. Insert a highlighted notice block
notice = document.create_element("div")
notice.set_attribute("class", "highlight")
notice.inner_html = "<strong>Important notice:</strong> This div was inserted at runtime."
document.body.append_child(notice)

# 4. Remove the first paragraph
paragraphs = document.get_elements_by_tag_name("p")
if paragraphs.length > 0:
    obsolete = paragraphs[0]
    obsolete.parent_node.remove_child(obsolete)

document.save("edited.html")

שלוש הפעולות הללו מתארגנות בצורה נקייה: ליצור פעם אחת, לקרוא מתי שאתה צריך לבדוק, ולערוך בתדירות שהתוכן משתנה.

הערה: דוגמת קוד זו מדגימה את הפונקציונליות המרכזית. לפני השימוש בפרויקט שלך, ודא שאתה מעדכן את נתיבי הקבצים (created.html, edited.html, וכו’) כך שיתאימו למיקומי הקבצים האמיתיים שלך, מאמת שכל התלויות הדרושות מותקנות כראוי, ובודק באופן יסודי בסביבת הפיתוח שלך. אם אתה נתקל בבעיות, אנא הפנה לתיעוד הרשמי או פנה לצוות תמיכה.

סיכום

יצירת, קריאה ועריכת קבצי HTML ב‑Python הופכת לפשוטה עם Aspose.HTML for Python via .NET. כל פעולה ממופה לאידיומה מוכרת של DOM: בנו צמתים עם create_element(), חפשו אותם עם get_element_by_id() ו‑query_selector_all(), שנו אותם דרך text_content, inner_html, ו‑set_attribute(), ואז שמרו עם save(). זכרו לרכוש רישיון מתאים לשימוש בייצור; פרטי התמחור זמינים בדף המוצר, ורישיון זמני ניתן לקבל מדף דף רישיון זמני. עם ה‑SDK ביד, אתם יכולים כעת לבנות כלי מניפולציה חזקים ל‑HTML שמתאימים בצורה חלקה לכל יישום מבוסס Python.

שאלות נפוצות

  • איך אני יוצר קובץ HTML בפייתון עם Aspose.HTML? צור מופע של HTMLDocument ריק, בנה צמתים עם create_element() ו-create_text_node(), חבר אותם עם append_child(), וקרא ל-document.save("created.html"). הדוגמה למעלה מציגה את הרצף המלא.

  • איך אני קורא את תוכן של קובץ HTML קיים? העבר את נתיב הקובץ לבנאי HTMLDocument, ואז בצע שאילתות על ה‑DOM באמצעות get_element_by_id(), get_elements_by_tag_name() או query_selector_all(). הערכים זמינים דרך text_content, inner_html ו‑get_attribute().

  • איך לערוך מסמך HTML ולשמור את השינויים? טען את המסמך, הקצה ל-text_content או inner_html, שנה תכונות עם set_attribute(), הוסף צמתים עם append_child(), והסר אותם עם remove_child(). לאחר מכן קרא ל-document.save(), באופן אופציונלי העבר מופע של HTMLSaveOptions.

  • היכן ניתן למצוא עוד דוגמאות, תיעוד ותמיכה? התיעוד הרשמי מספק מדריכים מפורטים, רפרנס ה-API מציג את כל המחלקות והחברים, והקהילה ניתנת להשגה דרך פורום Aspose.HTML.

קרא עוד