Navigasyon yapılabilir bir içindekiler tablosu oluşturmak, kullanıcıların hızlıca göz atması gereken büyük Word raporları veya kılavuzlar oluştururken esastır. Conholdate.Total for Java güçlü bir SDK sağlar ve Java uygulamalarından doğrudan DOCX dosyalarıyla çalışmayı basitleştirir. Bu adım‑adım rehberde, Java’da bir Word belgesine içindekiler tablosu eklemeyi, kurulum, kod açıklaması ve en iyi uygulamaları öğreneceksiniz.

Java’da Word Belgesine İçindekiler Tablosu Eklemek İçin Tam Çalışan Örnek

Aşağıdaki örnek, Conholdate.Total for Java kullanarak mevcut bir DOCX dosyasına içindekiler tablosu eklemeyi göstermektedir.

import com.groupdocs.words.Document;
import com.groupdocs.words.DocumentBuilder;
import com.groupdocs.words.TableOfContentsOptions;
import com.groupdocs.words.SaveFormat;
import com.groupdocs.words.TabLeader;

public class AddTableOfContentsExample {
    public static void main(String[] args) throws Exception {
        // Paths to the source and destination Word documents
        String inputPath = "input.docx";
        String outputPath = "output.docx";

// Load the existing document, add a TOC, and save the result
        try (Document doc = new Document(inputPath)) {
            DocumentBuilder builder = new DocumentBuilder(doc);

// Move cursor to the beginning of the document where the TOC will be inserted
            builder.moveToDocumentStart();

// Configure TOC options
            TableOfContentsOptions tocOptions = new TableOfContentsOptions();
            tocOptions.setUpperHeadingLevel(1);          // Include headings from level 1
            tocOptions.setLowerHeadingLevel(3);          // up to level 3
            tocOptions.setRightAlignPageNumbers(true);  // Align page numbers to the right
            tocOptions.setUseHyperlinks(true);           // Make entries clickable
            tocOptions.setTabLeader(TabLeader.DOTS);     // Use dotted leader

// Insert the Table of Contents
            builder.insertTableOfContents(tocOptions);

// Save the modified document
            doc.save(outputPath, SaveFormat.DOCX);
        }
    }
}

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input.docx, output.docx, vb.) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

Java Kodunda Word Belgesine İçindekiler Tablosu Eklemeyi Anlamak

Aşağıda örnek kod tarafından gerçekleştirilen ana adımların bir özeti bulunmaktadır:

  1. Kaynak belgeyi yükle - Document sınıfı mevcut DOCX dosyasını okur.
try (Document doc = new Document(inputPath)) {
  1. DocumentBuilder Oluşturun - DocumentBuilder belge içeriğini düzenlemek için yöntemler sağlar.
DocumentBuilder builder = new DocumentBuilder(doc);

  1. İmleci konumlandırın - moveToDocumentStart() ekleme noktasını dosyanın en başına taşır, böylece TOC herhangi bir içerikten önce görünür.

    builder.moveToDocumentStart();

  2. TOC seçeneklerini yapılandırın - TableOfContentsOptions başlık seviyelerini, sayfa‑numarası hizalamasını, köprü kullanımını ve sek lider stilini tanımlamanıza olanak tanır.

TableOfContentsOptions tocOptions = new TableOfContentsOptions();
tocOptions.setUpperHeadingLevel(1);
tocOptions.setLowerHeadingLevel(3);
tocOptions.setRightAlignPageNumbers(true);
tocOptions.setUseHyperlinks(true);
tocOptions.setTabLeader(TabLeader.DOTS);

Ayrıntılı API referansı, API Reference sayfasında mevcuttur.

  1. İçindekiler Tablosunu Ekle ve Kaydet - insertTableOfContents alanı ekler ve doc.save güncellenmiş dosyayı DOCX formatında yazar.
builder.insertTableOfContents(tocOptions);
doc.save(outputPath, SaveFormat.DOCX);

Conholdate.Total for Java’yı Kurma ve Yapılandırma

Conholdate Maven deposunu ve SDK bağımlılığını pom.xml dosyanıza ekleyin:

<repositories>
    <repository>
        <id>conholdate-repo</id>
        <name>Conholdate Maven Repository</name>
        <url>https://repository.conholdate.com/repo/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.conholdate</groupId>
    <artifactId>conholdate-total</artifactId>
    <version>24.9</version>
    <type>pom</type>
</dependency>

En son SDK paketini indirme sayfasından indirin. SDK, Java 8 veya daha üst bir sürüm gerektirir ve herhangi bir standart JVM’de çalışır. Ek bir çalışma zamanı bileşeni gerekmez.

Java ile Word TOC Oluşturma için En İyi Uygulamalar

  • Tutarlı başlık stilleri kullanın - TOC, yerleşik başlık seviyeleri (Başlık 1, Başlık 2, vb.) ile biçimlendirilmiş paragrafları algılar. Kaynak belgenizin güvenilir giriş oluşturması için bu stilleri kullandığından emin olun.
  • Başlık derinliğini sınırlayın - Çok fazla seviyenin eklenmesi TOC’yi yönetilmesi zor hale getirebilir. Tipik raporlar örnekte gösterildiği gibi 1‑3 seviyelerini kullanır.
  • Köprüleri etkinleştirin - setUseHyperlinks(true) ayarını yapmak tıklanabilir girişler oluşturur, son belgede gezinmeyi iyileştirir.
  • Eklemeden sonra doğrulayın - Oluşturulan DOCX’i açın ve alanları (Ctrl +A, F9) güncelleyerek sayfa numaralarının doğru olduğunu, özellikle sonraki düzenlemelerden sonra, teyit edin.
  • TOC seçenekleri nesnesini yeniden kullanın - Bir toplu işlemde birden fazla belge oluşturuyorsanız, seçenekleri bir kez yapılandırın ve nesne oluşturma yükünü azaltmak için yeniden kullanın.

Sonuç

Java’da bir Word belgesine içindekiler tablosu eklemek, Conholdate.Total for Java ile oldukça basit hale gelir. Bir DOCX dosyasını yükleyerek, TableOfContentsOptions yapılandırarak ve alanı ekleyerek, profesyonel raporlar ve kılavuzlar oluşturmayı otomatikleştirebilirsiniz. SDK’yı kurmayı, en iyi uygulama önerilerini takip etmeyi ve oluşturulan içindekiler tablosunu hedef ortamınızda test etmeyi unutmayın. Üretim dağıtımları için lisanslı bir kopyaya ihtiyacınız olacak; fiyatlandırma detayları fiyatlandırma sayfasında mevcuttur ve geçici bir lisans geçici lisans sayfasından alınabilir.

SSS

  • Java’da bir Word belgesine içindekiler tablosu eklemenin en basit yolu nedir?
    DocumentBuilder.moveToDocumentStart() ardından insertTableOfContents ile yapılandırılmış bir TableOfContentsOptions nesnesi kullanın, kod örneğinde gösterildiği gibi.

  • TOC’de hangi başlık seviyelerinin görüneceğini nasıl kontrol edebilirim?
    İstenen seviyeleri yalnızca içerecek şekilde TableOfContentsOptions örneğinde setUpperHeadingLevel ve setLowerHeadingLevel ayarlayın.

  • Daha sonra doldurulacak bir Word şablonu için bir TOC (İçindekiler Tablosu) oluşturmak mümkün mü?
    Evet. Dinamik içeriği doldurmadan önce TOC’yi şablon dosyasına ekleyin; TOC, daha sonra eklenen başlıklara otomatik olarak referans verecektir.

  • Bu SDK’yı kullanmak için internet bağlantısına ihtiyacım var mı?
    Hayır. Conholdate.Total for Java, sunucunuzda veya masaüstünüzde dış hizmet çağrıları olmadan çalışan yerel bir kütüphanedir.

Daha Fazla