Introduction
Aspose.TeX FOSS for Python exposes a concise engine API built around three concepts: Birleşik Giriş Noktası (TeXJob• Çıkışlı çıkış cihazları (PdfDevice, DviDevice, SvgDevice2 adet kaynak (FileInputSource, StringInputSource). Bu makalede her bileşeni kapsamaktadır ve PDF, DVI, Teks markup’dan gelen SVG çıkışı.
TeXJob - Giriş Noktası
TeXJob TeX motorunu çalıştırmak için ana sınıf. bir giriş kaynağı kabul eder, bir çıkış cihazı ve seçmeli TeXOptions,Bu nedenle, tipikleştirme boru hattı çalıştırılır. run() Geri dönüş değeri, ürettiği cihaz türleri için çıkış baytlarıdır. tek bir çıkış (PDF, DVI); SVG çıkışı için sayfalar cihaz nesnesinden alınır sonra run() tamamlayın .
TeXOptions Bu nedenle, motorun performansını belirlemek için (TeXOptions()) Çoğu belge için uygun standart TeX ayarlarını kullanın.
çıkış cihazları
PdfDevice
PdfDevice PDF byte akışına tip set belgesini yazar. standart olarak Taşınabilir, basılabilir çıkış üretimi için çıkıştırma cihazı:
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)
After run(), iade edilen byte tam PDF belgesini içerir.
DviDevice
DviDevice Device Independent (DVI) format çıkışı - yerli ortağı DVI çıkışı, rendering için downstream araçları tarafından tüketilebilir veya Daha fazla işleme:
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)
SGKDevice
SvgDevice her tip set sayfası SVG vektor grafik olarak sunar. iş çalışmasından sonra, get_all_pages() sayfa başına SVG byte çubukları listesini geri getirir:
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)
Giriş Kaynakları
FileInputSource
FileInputSource TeX markup’u A’dan okuyor .tex bu ilanı beğen Eki 14 This is the Mevcut belgelerin tipikleştirilmesi için standart giriş modu:
from aspose_tex import TeXJob, TeXOptions, PdfDevice, FileInputSource
pdf_bytes = TeXJob(FileInputSource("document.tex"), PdfDevice(), options=TeXOptions()).run()
StringInputSource
StringInputSource TeX işaretlemeyi Python çubuğu olarak kabul eder. bu giriş modu dinamik markup üretimi için kullanılır - TeX’i programlı ve Disk yazmadan yapıştırın:
from aspose_tex import TeXJob, TeXOptions, PdfDevice, StringInputSource
tex = "Hello, world!"
pdf_bytes = TeXJob(StringInputSource(tex), PdfDevice(), options=TeXOptions()).run()
bileşenleri birleştirmek
Üç bileşen, tam bir tipleştirme boru hattı oluşturmak için birlikte çalışır. veri akışınıza uygun giriş kaynağını ve çıkış biçiminize uygun cihazı seçin:
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")
İpuçları ve En İyi Uygulamalar
- Kullanım
StringInputSourcekısa veya dinamik olarak üretilen TeX parçaları için; kullanımıFileInputSourceMevcut ile çalıştığınızda.texDosya ile. PdfDeviceen çok kullanılan formattır; kullanımıSvgDeviceİçeri girdiğinde Web sayfalarında veya vektor grafik çalışma akışlarında TeX çıkışı.- Reuse
TeXOptionsİş yerinde, çok sayıda belgeyi işleme alarak Aynı ayarları yapıyor. - O zamanlar
run()Geri dönüş değeribytesPDF ve DVI için; SVG için, byte İndirilmişSvgDevice.get_all_pages()İş bittikten sonra.
API Referans Özetleri
| Class | Role |
|---|---|
TeXJob | Giriş Noktası; TeX Tiplendirme Pipeline’yi Çalıştırır |
TeXOptions | Motor konfigürasyonu; çoğu belge için varsayılanlar çalışır |
PdfDevice | PDF byte üreten çıkış cihazı |
DviDevice | DVI byte üreten çıkış cihazı |
SvgDevice | Çıkış cihazı, SVG sayfasında üretir get_all_pages() |
FileInputSource | Giriş A .tex Disk dosyası |
StringInputSource | Python string ile giriş yapın |