הכניסה
Aspose.TeX FOSS for Python exposes a concise engine API built around three concepts: נקודת כניסה (TeXJob• מכשיר תצוגה (PdfDevice, DviDevice, SvgDevice2 תוצאות חיפוש (FileInputSource, StringInputSource). מאמר זה מכסה כל מרכיב ומראה כיצד הם משולבים כדי לייצר PDF, DVI, תוצאות ה- SVG מ- TeX Markup.
טקסבוב - נקודת הכניסה
TeXJob הוא הכיתה העיקרית לנהיגה של מנוע TeX. זה מקבל מקור כניסה, מכשיר ייצוא, ואפשרויות TeXOptions,לאחר מכן, נכנסים לכיוון ה-Tipeline כאשר run() ערך ההחזר הוא באט הייצוא עבור סוגים של מכשירים המייצרים את תוצאה אחת (PDF, DVI); עבור תוצאות SVG, עמודים נלקחים מהאובייקט של המכשיר לאחר run() תוספת.
TeXOptions תנועת ה-CAT (התנהגות המנוע מתבצעת על ידי הגדרת התנהגויות)TeXOptions()) השתמש בהגדרות הסטנדרטיות של TeX המתאימות לרוב המסמכים.
מכשירים יוצאים
PdfDevice
PdfDevice כתיבת מסמך ה-typeet לתוך זרם PDF byte. מכשיר ייצוא לייצור ייצא נייד, הדפסה:
from aspose_tex import TeXJob, TeXOptions, PdfDevice, StringInputSource
pdf_bytes = TeXJob(StringInputSource("Hello, world!"), PdfDevice(), options=TeXOptions()).run()
with open("output.pdf", "wb") as f:
f.write(pdf_bytes)
לאחר run(), הוויטות שהוחזרו מכילים את המסמך PDF המלא.
DviDevice
DviDevice יצירת המכשיר עצמאי (DVI) פורמט ייצוא - האינדיבידואלי המקומי תצוגה של TeX. DVI יכול להיות נצרך על ידי כלי רדיואקטיבי למטרות רישום או עיבוד נוסף :
from aspose_tex import TeXJob, TeXOptions, DviDevice, StringInputSource
dvi_bytes = TeXJob(StringInputSource("Hello!"), DviDevice(), options=TeXOptions()).run()
with open("output.dvi", "wb") as f:
f.write(dvi_bytes)
SvgDevice
SvgDevice כל דף הוא גרפיקה וקטור SVG. לאחר העבודה עוברת, get_all_pages() החזיר את רשימת שורות ה-Bit SVG לפי דף:
from aspose_tex import TeXJob, TeXOptions, SvgDevice, StringInputSource
device = SvgDevice()
TeXJob(StringInputSource("Hello!"), device, options=TeXOptions()).run()
for i, svg in enumerate(device.get_all_pages()):
with open(f"page_{i}.svg", "wb") as f:
f.write(svg)
מקור הכנסה
FileInputSource
FileInputSource קרא את המותג של TeX מ- A .tex קובץ על דיסק - זהו מצב כניסה סטנדרטי בעת הצגת מסמכים קיימים:
from aspose_tex import TeXJob, TeXOptions, PdfDevice, FileInputSource
pdf_bytes = TeXJob(FileInputSource("document.tex"), PdfDevice(), options=TeXOptions()).run()
StringInputSource
StringInputSource מקבל את מארקופ TeX כסימן Python.המצב הזה הוא שימוש בגרסת סימנים דינמית – בניית TeX בתכנית ובאופן מתוכנן. להדפיס את זה בלי לכתוב על הדיסק:
from aspose_tex import TeXJob, TeXOptions, PdfDevice, StringInputSource
tex = "Hello, world!"
pdf_bytes = TeXJob(StringInputSource(tex), PdfDevice(), options=TeXOptions()).run()
שילוב מרכיבים
שלושת המרכיבים עובדים יחד כדי ליצור צינור מלא.בחרו את מקור ההכנסה המתאים זרימת הנתונים שלך ואת המכשיר המתאימה פורמט היציאה שלך:
from aspose_tex import TeXJob, TeXOptions, SvgDevice, FileInputSource
device = SvgDevice()
TeXJob(FileInputSource("report.tex"), device, options=TeXOptions()).run()
pages = device.get_all_pages()
print(f"{len(pages)} SVG pages produced")
טיפים ושיטות טובות
- שימוש
StringInputSourceעבור פריקים קצרים או גדלים דינמיות של TeX; שימושFileInputSourceכאשר עובדים עם קיים.texקבצים . PdfDeviceהוא פורמט היציאה הנייד ביותר; שימושSvgDeviceכאשר נכנסת תוצאות TeX בדפי אינטרנט או זרימת עבודה של גרפיקה וקטור.- שימוש חוזר
TeXOptions• מעבדות בין עובדים אם מתבצעת עיבוד של מספר מסמכים עם באותו הגדרה. - The
run()ערך ההחזר הואbytesעבור PDF ו- DVI; עבור SVG, הוויטות הן שוחרר מהSvgDevice.get_all_pages()לאחר שהעבודה תסתיים.
סיכום התייחסות API
| שיעור | תפקיד |
|---|---|
TeXJob | נקודת כניסה; מפעיל את צינור טייקס |
TeXOptions | הגדרת מנוע; הפסוקים עובדים עבור רוב המסמכים |
PdfDevice | מכשיר היציאה לייצר בייטים PDF |
DviDevice | מכשיר היציאה המייצר ביטים DVI |
SvgDevice | מכשיר היציאה המייצר SVG לפי דף באמצעות get_all_pages() |
FileInputSource | כניסה מ A .tex קובץ על דיסק |
StringInputSource | כניסה מתוך Python string |