1. IronPDF
  2. Nasıl Yapılır
  3. Yazı Tipleri (Web & İkon)
C# İçinde PDF'lerde Yazı Tipleri Nasıl Ayarlanır

Set Fonts in PDFs with IronPDF C

Curtis Chau
Curtis Chau
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF, C# geliştiricilerinin HTML'den özel web fontları ve ikon fontları kullanarak PDF'ler oluşturmalarına olanak tanır. Google Fonts gibi harici yazı tipi hizmetlerini ve yerel yazı tipi dosyalarını CSS @font-face kuralları aracılığıyla destekler, bu da oluşturulan tüm PDF'lerde tutarlı tipografi sağlar.

Webfont, web sitelerinde kullanılmak üzere özel olarak tasarlanmış bir fonttur. Bu fontlar, web sitelerinde tutarlı ve görsel olarak çekici metin işlemeyi sağlamak için web sunucularında barındırılır ve kullanıcının yerel font erişilebilirliğine bakılmaksızın web tarayıcıları tarafından indirilir. Buna ek olarak, semboller ve glifler kullanan ikon fontlar genellikle ölçeklenebilir, özelleştirilebilir ikonlar oluşturmak ve CSS manipülasyonu yoluyla görsel açıdan tutarlı bir kullanıcı arayüzü sağlamak için web tasarımında kullanılır. IronPDF'nin font yönetim imkanları ile geliştirişiciler, bu fontları PDF üretme iş akışlarına kolayca entegre edebilirler.

CSS, web fontlarını içererek, web sitenizin erişildiğinde indirilmesi için font dosyalarını belirtmenize olanak tanır. IronPDF, HTML'den PDF'ye font yükleme ve işlemesini destekler ve belirli marka veya tipografi standartları gerektiren belgeler oluşturmak için idealdir. Uluslararası içerikle çalışan geliştiriciler için, IronPDF UTF-8 ve uluslararası dil desteği de sağlar.

Hızlı Başlangıç: PDF Oluşturma İşleminde WebFontları Kullanma

IronPDF'in C# kütüphanesini kullanarak web ve simge yazı tiplerini PDF'lerinize entegre edin. Bu kılavuz, HTML içeriğini özel yazı tipleriyle nasıl render edeceğinizi gösterir, tutarlı ve görsel olarak çekici PDF'ler elde etmenizi sağlar. IronPDF ile HTML'yi basitçe render edin ve stilize edilmiş belgenizi saniyeler içinde kaydedin. Başlamadan önce, projenize IronPDF'i kurduğunuzdan emin olun.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin

    PM > Install-Package IronPdf

  2. Bu kod parçasını kopyalayıp çalıştırın.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { WaitFor = IronPdf.Rendering.WaitFor.AllFontsLoaded(2000) } }
    .RenderHtmlAsPdf("<link href=\"https://fonts.googleapis.com/css?family=Lobster\" rel=\"stylesheet\">" +
                     "<link href=\"https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css\" rel=\"stylesheet\">" +
                     "<p style=\"font-family:'Lobster', serif; font-size:30px;\">Hello Google Font</p>" +
                     "<i class=\"fa fa-coffee\" style=\"font-size:40px; color:#b00;\"></i>")
    .SaveAs("webfonts-icons.pdf");

  3. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronPDF kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Minimal Is Akisi (5 adimda)

  1. PDF'lerde yazı tiplerini ayarlamak için C# kütüphanesi IronPDF'i İndirin
  2. HTML kullanarak yazı tiplerini harici bir kaynaktan içe aktarın veya talep edin
  3. Yazı tipi yüklemesinin doğru gerçekleşmesini sağlamak için render işlemini geciktirin
  4. HTML'yi PDF'ye her zamanki gibi render edin
  5. Yazı tipi dosyasını CSS stilinde @font-face kuralını kullanarak içe aktarın

PDF'lerde WebFontları ve Simge Yazı Tiplerini Nasıl Kullanırım?

IronPDF, WebFontları (örneğin Google Fonts ve Adobe web font API'si) ve Bootstrap ve FontAwesome gibi simge yazı tiplerini destekler. Bu destek, IronPDF'i, basit belgelerden markalı öğeleri olan karmaşık raporlara kadar karmaşık tipografi gerektiren projeler için uygun hale getirir.

Yazı tipleri genellikle doğru yüklenmesi için render işlemi sırasında bir gecikme gerektirir. Bir yazı tipi doğru yüklenmezse, yazısız bir boş sayfaya sebep olabilir. Maksimum bekleme süresini atayarak tüm yazı tiplerinin yüklendiğinden emin olmak için WaitFor.AllFontsLoaded yöntemini kullanabilirsiniz. Varsayılan maksimum bekleme süresi 500ms. JavaScript veya dinamik içerikle ilgili daha karmaşık senaryolar için, gelişmiş render tekniklerini ele alan HTML'den PDF'ye eğitimimizi keşfedin.

Projelerinizde 'Lobster' adlı bir WebFont'u nasıl kullanacağınız hakkında küçük bir örnek.

:path=/static-assets/pdf/content-code-examples/how-to/webfonts-webicons-render-webfont.cs
using IronPdf;

// HTML contains webfont
var html = @"<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">
<p style=""font-family: 'Lobster', serif; font-size:30px;"" > Hello Google Fonts</p>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Wait for font to load
renderer.RenderingOptions.WaitFor.AllFontsLoaded(2000);

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("font-test.pdf");
Imports IronPdf

' HTML contains webfont
Private html = "<link href=""https://fonts.googleapis.com/css?family=Lobster"" rel=""stylesheet"">
<p style=""font-family: 'Lobster', serif; font-size:30px;"" > Hello Google Fonts</p>"

Private renderer As New ChromePdfRenderer()

' Wait for font to load
renderer.RenderingOptions.WaitFor.AllFontsLoaded(2000)

' Render HTML to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export the PDF
pdf.SaveAs("font-test.pdf")
$vbLabelText   $csharpLabel

Yazı tipleri, JavaScript, HTML öğeleri ve ağ boşta gibi daha fazla WaitFor seçeneğini 'WaitFor' Sınıf Belgelerinde keşfedin](/how-to/waitfor/).' Ekran boyutuna bağlı olarak yazı tiplerini uyarlayan duyarlı tasarımlar için PDF oluşturmada duyarlı CSS üzerindeki kılavuzumuza göz atın](/how-to/html-to-pdf-responsive-css/).

Neden Yazı Tipi Yükleme Süresi Önemlidir?

Bir yazı tipi doğru yüklenmezse, yazısız bir boş sayfaya sebep olabilir. Maksimum bekleme süresini atayarak tüm yazı tiplerinin yüklendiğinden emin olmak için WaitFor.AllFontsLoaded yöntemini kullanabilirsiniz. Varsayılan maksimum bekleme süresi 500ms. Bu zamanlama önemli, özellikle karmaşık web uygulamalarıyla çalışırken veya WebGL içeriğini PDF'ye render ettiğinizde, birden fazla kaynağın ardışık olarak yüklenmesi gerektiğinde.

Yazı tipi yükleme gecikmeleri, ağ hızı, yazı tipi dosya boyutu ve sunucu yanıt süresi gibi birçok faktöre bağlı olarak değişebilir. Birden fazla özel yazı tipi veya simge kütüphanesi ile çalışıyorsanız, tüm tipografinin doğru şekilde render edilmesini sağlamak için bekleme süresini artırmanız önerilir. Bu, özellikle profesyonel belgelerde önemlidir, çünkü eksik yazı tipleri okunabilirliği ve marka tutarlılığını etkileyebilir.

Hangi Yazı Tipi Servisleri Destekleniyor?

IronPDF, WebFontları (örneğin Google Fonts ve Adobe web font API'si) ve Bootstrap ve FontAwesome gibi simge yazı tiplerini destekler. Ek olarak, IronPDF şunları destekler:

  • Google Fonts (tüm katalog)
  • Adobe Fonts (Typekit)
  • Font Awesome simgeleri (tüm sürümler)
  • Bootstrap Simgeleri
  • Material Design Simgeleri
  • CSS @import veya link etiketleri aracılığıyla özel web yazı tipi servisleri
  • Çeşitli formatlardaki yerel barındırılan yazı tipi dosyaları (TTF, OTF, WOFF, WOFF2)

Yazı Tipleri Doğru Yüklenmezse Ne Olur?

Yazı tipleri genellikle doğru yüklenmesi için render işlemi sırasında bir gecikme gerektirir. Bir yazı tipi doğru yüklenmezse, yazısız bir boş sayfaya sebep olabilir. Bu tür durumlarda, tarayıcılar genellikle sistem varsayılan yazı tiplerine geri döner, bu da belgenizin görsel tutarlılığını bozabilir. IronPDF, yazı tipleri yüklemede karşılaşılan arızalarla başa çıkmak için çeşitli mekanizmalar sağlar:

  1. Yedek yazı tipi zincirleri: CSS font-family bildiriminde birden çok yazı tipi tanımlayın
  2. Genişletilmiş bekleme süreleri: Daha yavaş bağlantılar için AllFontsLoaded zaman aşımını artırın
  3. Yerel yazı tipi yerleştirme: Garantili kullanılabilirlik için base64 kodlanmış yazı tipleriyle @font-face kullanın
  4. Yazı Tipi ön Yükleme: Yazı tipi yüklemeyi önceliklendirmek için HTML ön yükleme etiketlerini kullanın

Yazı Tipi Dosyalarını Doğrudan Nasıl İçe Aktarırım?

Mevcut bir yazı tipi dosyasını kullanmak için CSS stilinde @font-face kuralını uygulayın. Base64 kodlanmış woff dosyalarını ve @font-face kuralını birleştirerek de çalışır. Aşağıdaki örnekte, Pixelify Sans Fontu'nu kullanacağım.

:path=/static-assets/pdf/content-code-examples/how-to/webfonts-webicons-custom-font.cs
using IronPdf;

// Import custom font
string html = @"<!DOCTYPE html>
<html>
<head>
<style>
@font-face {font-family: 'Pixelify';
src: url('fonts\PixelifySans-VariableFont_wght.ttf');
}
p {
    font-family: 'Pixelify';
    font-size: 70px;
}
</style>
</head>
<body>
<p>Custom font</p>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("customFont.pdf");
Imports IronPdf

' Import custom font
Private html As String = "<!DOCTYPE html>
<html>
<head>
<style>
@font-face {font-family: 'Pixelify';
src: url('fonts\PixelifySans-VariableFont_wght.ttf');
}
p {
    font-family: 'Pixelify';
    font-size: 70px;
}
</style>
</head>
<body>
<p>Custom font</p>
</body>
</html>"

Private renderer As New ChromePdfRenderer()

' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export the PDF
pdf.SaveAs("customFont.pdf")
$vbLabelText   $csharpLabel

Hangi Yazı Tipi Dosya Formatlarını Kullanabilirim?

Mevcut bir yazı tipi dosyasını kullanmak için CSS stilinde @font-face kuralını uygulayın. Base64 kodlanmış woff dosyalarını ve @font-face kuralını birleştirerek de çalışır. IronPDF aşağıdaki yazı tipi dosya formatlarını destekler:

  • TTF (TrueType Font): Yaygın olarak desteklenir, hem ekran hem de yazıcı için idealdir
  • OTF (OpenType Font): Gelişmiş tipografi özellikleri, profesyonel belgeler için uygundur
  • WOFF (Web Open Yazı Tip Formatı): Web kullanımı için optimize edilmiş sıkıştırılmış format
  • WOFF2: WOFF üzerine iyileştirilmiş sıkıştırma, daha küçük dosya boyutları
  • EOT (Embedded OpenType): Eski tarayıcılar için eski bir format
  • SVG yazı tipleri: Bazı platformlarda sınırlamaları olan vektör tabanlı yazı tipleri

Yerel Yazı Tiplerini ne Zaman Kullanmalıyım ve Ne Zaman Web Yazı Tiplerini Kullanmalıyım?

Mevcut bir yazı tipi dosyasını kullanmak için CSS stilinde @font-face kuralını uygulayın. Yerel yazı tipleri ile web yazı tipleri arasındaki seçim, birkaç faktöre bağlıdır:

Yerel Yazı Tiplerini Kullanınız:

  • Çevrimdışı çalışılan veya sınırlı ağ ortamlarında
  • Erişilebilirliği garantili yazı tipi gerektiğinde
  • Tescilli veya lisanslı yazı tipleriyle çalışırken
  • Ağ gecikmeleri olmadan daha hızlı render optimize edilirken
  • Belirli uygunluk gereksinimleri olan belgeler oluştururken

Web Yazı tiplerini Kullanınız:

  • Google Fonts gibi büyük yazı tipi kütüphanelerini kullanırken
  • Yazı tipi dosyalarına otomatik güncellemeler gerektiğinde
  • Uygulama paket boyutunu minimumda tutarak
  • Sürekli değişen tipografi gereksinimleriyle çalışırken
  • İnternet bağlantısına önceden bağlı olan uygulamalar oluştururken

Azure Kullanırken Sınırlamalar Nelerdir?

Azure barındırma platformu, SVG yazı tiplerini düşük paylaşılan web uygulaması katmanlarında yükleyen sunucuları desteklemez. Ancak, Azure'un VPS ve Web Rolü aynı şekilde sandbox edilmemiştir ve web yazı tipi renderlemesini destekler. Detaylı Azure dağıtım rehberi için, tüm katmana özel kısıtlamalar ve çözümleri kapsayan Azure dağıtım rehberimize bakın.

Hangi Azure Katmanları Yazı Tipi renderlemesini Destekler?

Ancak, Azure'un VPS ve Web Rolü aynı şekilde sandbox edilmemiştir ve web yazı tipi renderlemesini destekler. İşte Azure katman desteğinin bir dökümü:

Tam Yazı Tipi Desteği:

  • Azure Virtual Machines (tüm boyutlar)
  • Azure Web Rolleri
  • Uygulama Servisi Premium katmanları (P1v2, P2v2, P3v2)
  • Uygulama Hizmeti İzoleli katmanlar

Sınırlı Yazı Tipi Desteği:

  • Uygulama Servisi Temel katmanı (B1, B2, B3) - Sadece web yazı tipleri
  • Uygulama Servisi Standart katmanı (S1, S2, S3) - Bazı SVG yazı tipi kısıtlamaları

Özel Yazı Tipi Desteği Yok:

  • Uygulama Servisi Ücretsiz katman (F1)
  • Uygulama Servisi Paylaşılan katman (D1)

Neden Daha Düşük Azure Katmanlarında Yazı Tipi Kısıtlamaları Var?

Azure barındırma platformu, sandıklama kısıtlamaları ve kaynak sınırlamaları nedeniyle, düşük paylaşılan web uygulaması katmanlarında SVG yazı tiplerini yükleyen sunucuları desteklemez. Düşük katmanlar, özel yazı tipi renderlemesini gerektiren belirli sistem düzeyi işlemleri önleyen sıkı güvenlik sınırları uygular. Bu kısıtlamalar, Azure'un çoklu kiracı izolasyonunu sürdürmesine ve paylaşılan ortamlarda kaynak istismarını önlemesine yardımcı olur.

Bu kısıtlamaların üstesinden gelmek için şunları göz önünde bulundurun:

  1. CSS'inizde base64 kodlu dizeler olarak yazı tiplerini gömme
  2. Yalnızca CDNs'den web yazı tiplerini kullanma
  3. Desteklenen bir ortamda PDF'leri ön-render etme
  4. Tam yazı tipi desteğine sahip daha yüksek bir Azure katmanına yükseltme

Sıkça Sorulan Sorular

PDF belgelerimde Google Yazı Tiplerini nasıl kullanabilirim?

IronPDF, HTML oluşturma yoluyla Google Yazı Tiplerini destekler. Baş kısmında Google Yazı Tipleri bağlantısını ekleyerek ve CSS'de font-family uygularak yapabilirsiniz. IronPDF, bu yazı tiplerini indirip PDF oluşturduklarında doğru bir şekilde görüneceğinden emin olur.

Oluşturulan PDF'de web yazı tiplerim neden doğru şekilde görünmüyor?

Web yazı tipleri genellikle oluşturulmadan önce yükleme süresi gerektirir. IronPDF, PDF oluşturmayı tamamlamadan önce yazı tiplerinin tam olarak yüklendiğinden emin olmak için RenderingOptions içinde WaitFor.AllFontsLoaded() seçeneği sunar. Bu, eksik veya yanlış render edilmiş yazı tiplerini önler.

PDF'lerimde FontAwesome simgelerini kullanabilir miyim?

Evet, IronPDF, FontAwesome ve diğer simge yazı tiplerini tamamen destekler. HTML'inize FontAwesome CSS'yi dahil edin ve uygun simge sınıflarını kullanın. IronPDF, bu simge yazı tiplerini PDF'nizde vektör grafikleri olarak render eder, ölçeklenebilirlik ve görsel kaliteyi korur.

@font-face ile yerel yazı tipi dosyalarını nasıl kullanabilirim?

IronPDF, yerel yazı tipi dosyalarını yüklemek için CSS @font-face kurallarını destekler. CSS'nizde @font-face kuralınızı tanımlayın, yazı tipi dosyası yolunu belirleyin ve ardından font-family'i HTML öğelerinize uygulayın. IronPDF, bu özel yazı tiplerini render ederken doğrudan PDF'ye gömer.

PDF oluşturma için hangi yazı tipi formatları desteklenir?

IronPDF, CSS @font-face kuralları veya harici yazı tipi hizmetleri kullanıldığında WOFF, WOFF2, TTF ve OTF dosyaları dahil olmak üzere standart web yazı tipi formatlarını destekler. Bu, bugün mevcut olan en modern web ve simge yazı tipleriyle uyumluluğu sağlar.

Farklı sistemler arasında tutarlı tipografi nasıl sağlayabilirim?

IronPDF, web yazı tiplerini doğrudan oluşturulan PDF dosyalarına gömer, böylece özel tipografinizin görüntüleyicinin sisteminde kurulu olan yazı tiplerinden bağımsız olarak tutarlı şekilde görüntülenmesini sağlar. Bu, dağıtılmış belgelerde marka tutarlılığını korumak için idealdir.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget Indirmeler 18,332,619 | Sürüm: 2026.4 yeni yayınlandı
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizin PDF olduğunu izleyin.