Java'da PDF Yer İşaretleri ve Çizelge Ekleme Nasıl Yapılır

Güncellendi:Şubat 1, 2026

Translated

View the article in English

IronPDF'in Java kutuphanesi, BookmarkManager sınıfını kullanarak programatik olarak PDF belgelerine yer imleri ve anahatlar eklemenizi sağlar; tek katmanlı ve çok katmanlı yer imi yapıları için özelleştirilebilir gezinme noktalarını destekler.

Hızlı Başlangıç: Java'da PDF Yer İşaretleri Ekle

IronPDF Java kütüphanesini kurun ve lisans anahtarınızı ayarlayın
PDF belgenizi PdfDocument.fromFile() ile yükleyin
BookmarkManager'i pdf.getBookmark() ile alın
addBookMarkAtEnd("Title", pageNumber) kullanarak yer imleri ekleyin
PDF'i pdf.saveAs() ile kaydedin

```java :title=Hızlı Başlangıç PdfDocument pdf = PdfDocument.fromFile(Path.of("document.pdf")); BookmarkManager bookmarks = pdf.getBookmark(); bookmarks.addBookMarkAtEnd("Bölüm 1", 0); pdf.saveAs(Path.of("bookmarked.pdf"));


PDF yer işaretleri, belgelerinizin kullanılabilirliğini ve gezinmesini önemli ölçüde artırır. Çizelgeler, kullanıcıların içerik tablosu gibi önemli bölümlere doğrudan atlamasını sağlayarak PDF'ler içinde yapılandırılmış gezinme sağlar. Bu işlevsellik, uzun belgeler, raporlar veya çok bölümlü PDF'lerle çalışırken düzenli dolaşımı gerektirdiği durumlarda hayati önem taşır.

IronPDF, Java uygulamalarında PDF manipülasyonunu basitleştirir. Yer işareti işlevselliği, PDF dosyalarında özel yer işaretleri oluşturmanın kolay yollarını sunar. Kütüphane, Java uygulamalarıyla sorunsuz bir şekilde entegre olur ve işaretleme, PDF'leri [birleştirme](https://ironpdf.com/java/how-to/java-merge-pdf-tutorial/), [formlar oluşturma](https://ironpdf.com/java/how-to/create-forms/) ve [özel filigran ekleme](https://ironpdf.com/java/how-to/custom-watermark/) dahil, çeşitli PDF manipülasyon özelliklerini destekler.

<div class="hsg-featured-snippet">
    <h2>PDF Yer İşaretleri ve Çizelge Ekleme Nasıl Yapılır</h2>
    <ol>
        <li><a href="https://ironpdf.com/java/#download-modal">Java kütüphanesini kurarak PDF'lere yer işaretleri ekleyin</a></li>
        <li>Utilize the <strong>`PdfDocument`</strong> class to load an existing PDF file in Java</li>
        <li>Create and customize the bookmarks with the <strong>`BookmarkManager`</strong> class</li>
        <li>Use `addBookMarkAtEnd` to add bookmarks to specific pages of the PDF</li>
        <li>Yeni çizelge ve yer işaretlerini içeren PDF belgesini kaydedin</li>
    </ol>
</div>

## Başlamadan Önce Ne Lazım?

PDF yer işaretlerini uygulamadan önce, IronPDF'nin Java projenizde doğru bir şekilde yapılandırıldığına emin olun. Kütüphane Java 8 veya daha yüksek gerektirir ve Maven ya da Gradle kullanılarak kolayca entegre edilebilir. Projenizin yapı dosyasına IronPDF bağımlılığını eklemeniz gerekecek. Ayrıntılı kurulum talimatları için [Başlangıç Kılavuzu](https://ironpdf.com/java/docs/)na göz atın.

Ayrıca lisans anahtarınızın doğru bir şekilde yapılandırıldığından emin olmalısınız, çünkü IronPDF geliştirime yönelik lisans gerektirir. Lisanslama seçenekleri ve uygulamaları hakkında kapsamlı bilgi için [lisans kılavuzu](https://ironpdf.com/java/get-started/license-keys/)nu ziyaret edin. IronPDF'nin herhangi bir işlevini kullanmadan önce uygulamanızın başında lisans anahtarını ayarlayın.

## PDF'ye Çizelge ve Yer İşaretleri Nasıl Eklerim?

Bu örnek için, Çizgeler ve yer işaretleri uygulamak için bu [örnek PDF](/static-assets/ironpdf-java/howto/bookmarks/NovelSample.pdf)yi kullanacağım. Süreç, mevcut bir PDF belgesinin yüklenmesini ve IronPDF'in `BookmarkManager`'sini kullanarak belge boyunca gezinme noktaları eklemeyi içerir.

### Tek Katmanlı Yer İşaretleri Nasıl Eklerim?

Bu PDF'i belirtilen dosya yolundan [`PdfDocument`.fromFile](https://ironpdf.com/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html) sınıfını kullanarak yükledikten sonra yer imleri eklemeye başlamak için [`BookmarkManager`](https://ironpdf.com/java/object-reference/api/com/ironsoftware/ironpdf/bookmark/BookmarkManager.html) nesnesini alın. `addBookMarkAtEnd` ve `addBookMarkAtStart` yöntemlerini kullanarak yer imi koleksiyonunun başlangıcına veya sonuna yer imleri ekleyebilirsiniz. Bu yöntemler, belgenizin yapısına göre yer işaretlerinizi düzenlerken esneklik sağlar.

İpuçlarıTüm sayfa dizinlerinin sıfır bazlı indeksleme kullandığını unutmayın.

```java
import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object to manage bookmarks
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end of the bookmark collection
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication Page", 2);
        bookmarks.addBookMarkAtEnd("First Page", 3);
        bookmarks.addBookMarkAtStart("Page 4", 6);

        // Save the modified PDF with bookmarks
        pdf.saveAs(Path.of("bookmarked.pdf"));
    }
}

Yukarıdaki PDF görüntüleyici ile içindekiler tablosunu çoğu tarayıcının sol üst köşesinde kontrol ederek eklenen tüm yer işaretlerini görebilirsiniz. Bu tek katmanlı yer işareti yapısı, basit organizasyonel ihtiyaçları olan belgeler için basit bir gezinme sağlar.

Birden Çok Katmanlı Yer İşaretleri Nasıl Oluştururum?

Bu örnekte yer işaretleri eklemeye, bir katman oluşturuyormuş gibi başlayın. Sonra, yeni bir katmanda yeni bir yer imi eklemek için insertBookmark yöntemini kullanın. İlk parametre yer işareti ismini, ikinci parametre ise yer işaretinin bağlandığı sayfayı belirler. Yeni bir katman oluşturmak için, yeni yer işaretini var olan bir yer işaretinin "çocuğu" yapın. Bu hiyerarşik yapı, bölümler, sekmeler ve alt sekmeler içeren belgeler için uygundur.

import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second layer bookmarks
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with multiple layer bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

import java.io.IOException;
import java.nio.file.Path;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file
        PdfDocument pdf = PdfDocument.fromFile(Path.of("NovelSample.pdf"));

        // Get BookmarkManager object
        BookmarkManager bookmarks = pdf.getBookmark();

        // Add bookmarks at the end
        bookmarks.addBookMarkAtEnd("Title Page", 0);
        bookmarks.addBookMarkAtEnd("Table of Contents", 1);
        bookmarks.addBookMarkAtEnd("Dedication", 2);

        // Insert second layer bookmarks
        bookmarks.insertBookmark("First Page", 3, "Table of Contents", null);
        bookmarks.insertBookmark("Second Page", 4, "Table of Contents", "First Page");
        bookmarks.insertBookmark("End of Sample", 7, "Title Page", null);
        bookmarks.insertBookmark("Fourth page", 6, "Table of Contents", "Second Page");

        // Save the modified PDF with multiple layer bookmarks
        pdf.saveAs(Path.of("multiLayer.pdf"));
    }
}

JAVA

İşte yer işaretlerinin yeni ağaç yapısını içeren PDF'yi görebilirsiniz. Anahatı kontrol ederek insertBookmark özelliğinin nasıl yeni bir yer imi katmanı eklediğini görebilirsiniz. Bu çok katmanlı yaklaşım, teknik belgeler, akademik makaleler veya detaylı bir dolaşım yapısı gerektiren herhangi bir belge için uygundur.

Mevcut Yer İşaretlerini PDF'den Nasıl Alırım?

IronPDF'nin yer işareti aracı, yeni yer işaretleri eklemenin yanı sıra mevcut olanları geri alır ve görüntüler. Bu işlevsellik, mevcut PDF'leri değiştirirken veya yapısını analiz ederken oldukça önemlidir. Yer imleri arasında gezinmek için önce PDF'i PdfDocument.fromFile yöntemi ile yükleyin. Daha sonra BookmarkManager nesnesine erişin ve tüm yer imlerini, çocuk yer imlerini içerecek şekilde almak için getBookmarks yöntemini kullanın. Son olarak, listede belirtilen indeksle bir yer imi almak için get yöntemini kullanın. Bu yetenek, mevcut PDF gezinme yapılarını programatik olarak incelemek ve değiştirmek için imkan sağlar.

import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Retrieve a specific bookmark by its index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if(bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF file with bookmarks
        PdfDocument pdf = PdfDocument.fromFile(Path.of("bookmarked.pdf"));

        // Retrieve the bookmark manager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve list of all bookmarks
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Retrieve a specific bookmark by its index
        Bookmark bookmark = bookmarkList.get(2);

        // Print bookmark details
        System.out.println("Bookmark Title: " + bookmark.getText());
        System.out.println("Page Number: " + bookmark.getPageIndex());

        // Check if bookmark has children
        if(bookmark.getChildren() != null && !bookmark.getChildren().isEmpty()) {
            System.out.println("Number of child bookmarks: " + bookmark.getChildren().size());
        }
    }
}

JAVA

Belirli Bir Dizeye Yer İşareti Nasıl Eklerim?

Elde edilen yer işaretleri ile belgede belirli dizinlerde yeni yer işaretleri ekleyebilirsiniz. Bu özellik, yeni bölümlerle mevcut PDF'leri güncellerken veya belge yapısını yeniden düzenlerken yardımcı olur. Bunu başarmak için hedeflenen yer imini seçin ve ardından addNextBookmark yöntemini kullanarak bu yerine yeni bir yer imi ekleyin. Örneğin, 'Birden Çok Katmanlı Yer İşaretleri Ekle' bölümünden PDF'yi alın ve üçüncü sayfa yer işaretinin ardından bir yer işareti ekleyin. Ayrıca, belgenizin gezinme hiyerarşisi üzerinde hassas kontrol sağlamak amacıyla addChildBookmark yöntemini kullanarak daha derin bir katman olarak bir alt yer imi ekleyebilirsiniz.

import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF we modified earlier
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the list of bookmarks
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Retrieve a specific bookmark by its index
        Bookmark bookmark = bookmarkList.get(5);

        // Add a new bookmark after the specified bookmark
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add another layer to 'Third page' bookmark
        bookmark.addChildBookmark("Section 1", 7);

        // Save the modified PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

import java.io.IOException;
import java.nio.file.Path;
import java.util.List;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.bookmark.Bookmark;
import com.ironsoftware.ironpdf.bookmark.BookmarkManager;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

        // Load the PDF we modified earlier
        PdfDocument pdf = PdfDocument.fromFile(Path.of("multiLayer.pdf"));

        // Get the BookmarkManager
        BookmarkManager bookmarks = pdf.getBookmark();

        // Retrieve the list of bookmarks
        List<Bookmark> bookmarkList = bookmarks.getBookmarks();

        // Retrieve a specific bookmark by its index
        Bookmark bookmark = bookmarkList.get(5);

        // Add a new bookmark after the specified bookmark
        bookmark.addNextBookmark("Fourth Page", 6);

        // Add another layer to 'Third page' bookmark
        bookmark.addChildBookmark("Section 1", 7);

        // Save the modified PDF
        pdf.saveAs(Path.of("specificIndex.pdf"));
    }
}

JAVA

Lütfen dikkate alinEğer yer işaretleri aynı isimlere sahip iki PDF belgeyi birleştirirseniz, bu yer işareti listesini bozabilir.

Karmaşık PDF iş akışlarında yer işaretleriyle çalışırken, IronPDF'nin diğer özelliklerini keşfetmeyi düşünün, örneğin PDF'leri bölmek kendi yer işareti yapılarına sahip daha küçük belgeler oluşturmak için veya yer işareti navigasyonu sağlam olarak PDF'leri yazdırmak. Daha gelişmiş örnekler ve tamamlanmış kod demoları için, örnekler bölümümüzdeki yer işareti kod örneğine göz atın.

Sıkça Sorulan Sorular

Java'da bir PDF belgesine nasıl yer işareti eklerim?

IronPDF'nin BookmarkManager sınıfını kullanarak PDF belgelerine yer işaretleri ekleyebilirsiniz. İlk olarak, PdfDocument.fromFile() kullanarak PDF'inizi yükleyin, ardından pdf.getBookmark() ile BookmarkManager'e erişin ve yer işaretleri eklemek için addBookMarkAtEnd() yöntemini kullanarak yer işareti başlığını ve sayfa numarasını belirtin.

PDF yer işaretlerini programmatic olarak eklemek için ön koşullar nelerdir?

IronPDF ile PDF yer işaretleri eklemek için, Java 8 veya daha yüksek bir sürüm, Maven veya Gradle aracılığıyla entegre edilmiş IronPDF kütüphanesi ve uygulamanızda yapılandırılmış geçerli bir lisans anahtarı gerekmektedir. Kütüphane, tek katmanlı ve çok katmanlı yer işaret yapısı destekler.

PDF'lerde çok seviyeli yer işareti hiyerarşileri oluşturabilir miyim?

Evet, IronPDF hem tek katmanlı hem de çok katmanlı yer işaret yapıları oluşturmayı destekler. Karmaşık PDF belgelerini organize etmek için parent ve child yer işaretleriyle hiyerarşik gezinme oluşturabilirsiniz.

PDF yer işaretlerinin ve anahatların amacı nedir?

PDF yer işaretleri ve anahatları, yapılandırılmış gezinme sağlayarak belge kullanılabilirliğini önemli ölçüde artırır. Kullanıcıların özellikle uzun belgeler, raporlar veya çok bölümlü PDF'ler için değerli olan ana bölümlere, örneğin bir içerik tablosuna doğrudan atlamalarına olanak tanır. IronPDF, bu gezinme özelliklerini programlı bir şekilde uygulamayı kolaylaştırır.

Yer işaretlemeye ek olarak hangi PDF düzenleme özellikleri mevcuttur?

Yer işareti eklemenin ötesinde, IronPDF, PDF birleştirme, form oluşturma, filigran ekleme ve diğer çeşitli belge işleme özelliklerini içeren kapsamlı PDF manipülasyon yetenekleri sunar. Bu işlevler, Java uygulamalarıyla sorunsuz bir şekilde entegre olarak eksiksiz bir PDF yönetimi sağlar.

Yer işaretleri ekledikten sonra bir PDF'i nasıl kaydederim?

IronPDF'nin BookmarkManager'ini kullanarak yer işaretleri ekledikten sonra, pdf.saveAs() yöntemini PdfDocument nesnenizde çağırarak, yer işaretli PDF'i saklamak istediğiniz çıktı dosya yolunu belirterek değiştirilmiş PDF belgesini kaydedin.

Darrius Serrant

Mühendislik takımıyla şimdi sohbet edin

Tam Yığın Yazılım Mühendisi (WebOps)

Darrius Serrant, Miami Üniversitesi'nden Bilgisayar Bilimleri lisans derecesine sahiptir ve Iron Software'de Tam Yığın WebOps Pazarlama Mühendisi olarak çalışmaktadır. Küçük yaşlardan itibaren kodlamaya ilgi duyan Darrius, bilişimi hem gizemli hem de erişilebilir buldu ve onu yaratıcılık ve problem çö...

Daha Fazlasını Oku

Başlamaya Hazır mısınız?

Sürüm: 2026.4 yeni yayınlandı