Python'da Sunum Bilgilerini Al ve Güncelle

Bu sayfa ne hakkında

Python kullanarak PowerPoint ve OpenDocument sunumlarında slaytları, yapıyı ve meta verileri keşfedin, daha hızlı içgörüler ve akıllı içerik denetimleri elde edin.

Genel Bakış

Aspose.Slides, bir sunumun biçimini tanımlayabilir ve tam bir sunum nesne modelini oluşturmadan belge meta verilerini okuyabilir. Bu, dosyaları sınıflandırmanız, bir envanter oluşturmanız veya sunum içeriğini yükleyip işlemeye karar vermeden önce özellikleri incelemeniz gerektiğinde kullanışlıdır.

Bu makale, PresentationFactory ve PresentationInfo aracılığıyla hafif denetimi, ayrıca DocumentProperties aracılığıyla hedeflenmiş güncellemeleri gösterir.

Sunum Biçimini Kontrol Et

Zaten yüklü bir sunumunuz varsa, yükleme sonrasında tespit için Orijinal Sunum Biçimini Belirle ve eski PPT, PPS ve POT akışlarının sınırlamaları bölümüne bakınız.

PresentationFactory.get_presentation_info kullanarak bir dosyayı Presentation örneği oluşturmadan inceleyebilirsiniz. PresentationInfo.load_format özelliği, PPTX, PPT veya ODP gibi tespit edilen biçimi raporlar.

import aspose.slides as slides

file_names = ["pres.pptx", "pres.ppt", "pres.odp"]

for file_name in file_names:
    presentation_info = slides.PresentationFactory.instance.get_presentation_info(file_name)
    print(f"{file_name}: {presentation_info.load_format}")

Hafif Sunum Envanteri Oluştur

Birçok sunum dosyasını işlerken, doğrulama, indeksleme veya belge yönetim sistemi için kompakt bir envantere ihtiyaç duyabilirsiniz. Bu senaryoda, PresentationFactory.get_presentation_info kullanarak bir PresentationInfo nesnesi elde edin ve ardından belge meta verilerini okumak için PresentationInfo.read_document_properties çağırın. Bu yaklaşım bir Presentation örneği oluşturmaz ve tam sunum nesne modelini dolaşmanız gerekmez.

DocumentProperties tarafından sunulan genişletilmiş özellikler aşağıdaki envanter değerlerini sağlar:

Özellik	Envanter değeri
slaytlar	Toplam slayt sayısı.
gizli_slaytlar	Gizli slaytların sayısı.
notlar	Not içeren slaytların sayısı.
paragraflar	Mevcut olduğunda toplam paragraf sayısı.
kelimeler	Toplam kelime sayısı.
multimedya_klipleri	Toplam ses ve video klip sayısı.

Aşağıdaki örnek bu değerleri bir Presentation nesnesi oluşturmadan okur ve kompakt bir envanter yazdırır. Ayrıca heading_pairs ile titles_of_parts birleştirilerek yazı tipleri, temalar ve slayt başlıkları gibi içerik grupları gösterilir.

import os
import aspose.slides as slides

file_path = "sample.pptx"
presentation_info = slides.PresentationFactory.instance.get_presentation_info(file_path)
document_properties = presentation_info.read_document_properties()

print(f"File: {os.path.basename(file_path)}")
print(f"Format: {presentation_info.load_format}")
print(f"Title: {document_properties.title}")
print(f"Author: {document_properties.author}")
print("Statistics:")
print(f"  Slides: {document_properties.slides}")
print(f"  Hidden slides: {document_properties.hidden_slides}")
print(f"  Slides with notes: {document_properties.notes}")
print(f"  Paragraphs: {document_properties.paragraphs}")
print(f"  Words: {document_properties.words}")
print(f"  Multimedia clips: {document_properties.multimedia_clips}")

heading_pairs = document_properties.heading_pairs or []
titles_of_parts = document_properties.titles_of_parts or []
part_index = 0

if not heading_pairs or not titles_of_parts:
    print("Content groups: not available")
else:
    print("Content groups:")

    for heading_pair in heading_pairs:
        print(f"  {heading_pair.name} ({heading_pair.count})")

        for _ in range(heading_pair.count):
            if part_index >= len(titles_of_parts):
                break

            print(f"    - {titles_of_parts[part_index]}")
            part_index += 1

    if part_index < len(titles_of_parts):
        print("  Other parts:")

        while part_index < len(titles_of_parts):
            print(f"    - {titles_of_parts[part_index]}")
            part_index += 1

Her HeadingPair bir grup adı ve o grup içindeki öğe sayısını sağlar. DocumentProperties.titles_of_parts düz, sıralı bir koleksiyondur; bu nedenle her başlık çiftinin belirttiği ardışık başlık sayısı tüketilir.

Depolanmış Meta Veriler ve Biçim Sınırlamaları

PresentationInfo.read_document_properties tarafından döndürülen envanter özellikleri, kaynak belgede mevcut meta verilere dayanır. Aspose.Slides bu çağrı için bu değerleri yeniden hesaplamak amacıyla sunum nesne modelini yüklemez ve dolaşmaz. Eksik özellikler varsayılan değerlerle temsil edilir ve saklanan değerler, dosyayı en son kaydeden uygulama belge özelliklerini güncellememişse eski olabilir.

PPTX: Biçim, slayt, not, gizli‑slayt, paragraf, kelime ve multimedya sayımları ile başlık çiftleri ve bölüm başlıkları için genişletilmiş belge özellikleri sağlar. Kullanılabilirlik, belge üreticisinin hangi özellikleri yazdığına bağlıdır.
PPT: İkili biçim, karşılık gelen belge‑özet özelliklerini depolayabilir. Bir özellik eksikse veya belge üreticisi tarafından yenilenmemişse, Aspose.Slides bu değeri slaytlardan hesaplamak yerine saklanan ya da varsayılan değeri döndürür.
ODP: OpenDocument meta verileri, sayfa, paragraf ve kelime sayısı gibi genel belge istatistikleri sunar, ancak bu değerler her PowerPoint‑özel genişletilmiş özellik ile eşleşmez. Gizli‑slayt, not‑slayt, multimedya, başlık‑çifti ve bölüm‑başlığı meta verileri mevcut olmayabilir ve envanter özellikleri varsayılan değer döndürebilir. Sıfır değeri veya boş bir koleksiyonu, ilgili içeriğin yok olduğunun kesin kanıtı olarak değerlendirmeyin.

Envanter ve ön kontrol amaçları için hafif meta veri yaklaşımını kullanın. Sonucun bellek içi değişiklikleri yansıtması gerektiğinde veya gerçek sunum içeriğini doğrulamanız gerektiğinde sunumu yükleyin ve canlı nesne modelini inceleyin.

Sunum Özelliklerini Güncelle

PresentationInfo.read_document_properties tarafından döndürülen özellikler, bir Presentation örneği oluşturmadan da değiştirilebilir. Değişiklikleri PresentationInfo.update_document_properties ile uygulayın ve ardından bağlanmış sunumu PresentationInfo.write_binded_presentation ile yazın.

Aşağıdaki görsel PowerPoint sunumunun orijinal belge özelliklerini gösterir.

PowerPoint sunumunun orijinal belge özellikleri

Aşağıdaki örnek başlığı ve son‑kaydedilme zamanını değiştirir ve sonucu yeni bir dosyaya yazar:

import datetime
import aspose.slides as slides

source_file = "sample.pptx"
output_file = "sample_with_updated_properties.pptx"
presentation_info = slides.PresentationFactory.instance.get_presentation_info(source_file)
document_properties = presentation_info.read_document_properties()

document_properties.title = "Quarterly sales report"
document_properties.last_saved_time = datetime.datetime.now(datetime.timezone.utc)

presentation_info.update_document_properties(document_properties)

with open(output_file, "wb") as output_stream:
    presentation_info.write_binded_presentation(output_stream)

Aşağıdaki görsel PowerPoint sunumunun güncellenmiş belge özelliklerini gösterir.

PowerPoint sunumunun güncellenmiş belge özellikleri

Faydalı Bağlantılar

İlgili güvenlik kontrolleri ve koruma ayarları için aşağıdaki makalelere bakınız:

SSS

Yazı tiplerinin gömülü olup olmadığını ve hangileri olduğunu nasıl kontrol edebilirim?

Sunumu yükleyin ve Presentation.fonts_manager kullanın. Gömülü yazı tiplerini almak için FontsManager.get_embedded_fonts ve sunumda kullanılan yazı tiplerini almak için FontsManager.get_fonts çağırın. İki sonucu karşılaştırarak render için gerekli ancak gömülmemiş yazı tiplerini bulun.

Dosyanın gizli slaytları olup olmadığını ve kaç tane olduğunu hızlıca nasıl öğrenebilirim?

Saklanan belge meta verileri yeterli olduğunda, PresentationFactory.get_presentation_info ve PresentationInfo.read_document_properties aracılığıyla DocumentProperties.hidden_slides okuyun. Bu, hafif bir envanter için uygundur. Sunum bellek içinde değiştirilmişse, saklanan meta veriler eksik ya da eski olabilir veya canlı değerleri doğrulamanız gerekiyorsa, Presentation.slides üzerinden döngü kurarak her slaytın Slide.hidden özelliğini inceleyin.

Özel slayt boyutu ve yönünün kullanılıp kullanılmadığını ve varsayılanlardan farklı olup olmadığını tespit edebilir miyim?

Evet. Sunumu yükleyin ve Presentation.slide_size özelliğini okuyun. Mevcut ayarları beklenen ön ayar ve boyutlarla karşılaştırmak için SlideSize.type, SlideSize.size ve SlideSize.orientation özelliklerini inceleyin.

Grafiklerin dış veri kaynaklarına başvurup başvurmadığını hızlıca gösteren bir yol var mı?

Evet. Her bir Chart bulun ve ChartData.data_source_type özelliğini inceleyin. Dış bir çalışma kitabı için ChartData.external_workbook_path okun. Veri kaynağı türü ve yolu dış referansı belirler, ancak hedefin mevcut olup olmadığını doğrulamak ayrı bir kaynak kontrolü gerektirir.

Render veya PDF dışa aktarımını yavaşlatabilecek ‘ağır’ slaytları nasıl değerlendirebilirim?

Tek bir karmaşıklık özelliği yoktur. Presentation.slides ve her slaytın BaseSlide.shapes koleksiyonunu dolaşın. Şekil sayısı ve büyük görüntüler, efektler, animasyonlar veya multimedya varlığı gibi sinyalleri tarama göstergeleri olarak kullanın ve bir slaytı kesin bir performans darboğazı olarak değerlendirmeden önce temsilî bir render veya dışa aktarma ölçümü yapın.

Python'da Sunum Açma Python'da Orijinal Sunum Formatını Belirleme