docfx C# (Geliştiriciler için Nasıl Çalışır)

DocFX Nasıl Kullanılır

1. .NET SDK 6.0+ yükleyin
2. PowerShell'i açın.
3. DocFX Kütüphanesini yüklemek için scripti tek tek çalıştırın.
4. Kurulumdan sonra JSON dosyasını çalıştırın.
5. Bu, dokümantasyon sitesini 8080 portunda açar.

DocFX'e Giriş

Microsoft, DocFX adlı açık kaynaklı statik site oluşturucu ve doküman üretim aracını geliştirmiştir. Markdown dosyaları ve kaynak kod yardımıyla geliştiriciler, profesyonel görünümlü doküman siteleri üretebilirler. DocFX, çok sayıda işaretleme formatını ve programlama dilini desteklediği için, çeşitli projelerde geniş bir uygulama olanağı sunar.

Geliştiriciler, DocFX'i kullanarak dokümantasyonlarında öğreticiler, kavramsal makaleler ve API referansları oluşturabilirler. Esnek yapısı sayesinde, ekipler özelleştirip genişletilebilir, böylece eşsiz gereksinimlerini karşılayabilirler. DocFX ayrıca çapraz referanslar, düzenlenebilir şablonlar ve HTML ve Markdown dahil olmak üzere çeşitli çıktı formatları için destek gibi özellikler sunar. DocFX'in iç işleyişi ve yöntemleri hakkında daha ayrıntılı bir açıklama için lütfen DocFX Dokümantasyonu ziyaret ediniz.

DocFX ile Başlarken

Yeni Bir DocFX Web Sitesi Oluşturun

Bu aşamada yerel bilgisayarınıza basit bir dokümantasyon web sitesi oluşturacağız.

• Komut satırı işlemleri hakkında temel bir anlayış gereklidir. *.NET SDK 6.0 veya daha yeni bir sürüm gereklidir.

DocFX'in en son sürümünü yüklemek için .NET SDK yüklendiğinden emin olun, ardından bir terminal komut satırı aracını açın ve aşağıdaki komutu yazın:

dotnet tool update -g docfx

Yeni bir docset başlatmak için çalıştırın:

docfx init

docfx init

Tüm yapılandırmaların JSON dosyasını oluşturur. Bu komut yardımıyla mevcut çalışma dizininde yeni bir DocFX projesi oluşturabilirsiniz. Docset'i oluşturmak için çalıştırın:

docfx docfx.json --serve

docfx docfx.json --serve

Bu web sayfası artık http://localhost:8080 üzerinde ön izlenebilir.

Değişikliklerinizi kaydedin. DocFX, JSON Yapılandırma dosyası kullanılarak yapılandırılır. Şimdi, yeni bir terminal kullanarak bu komutu çalıştırarak web sitesini yeniden oluşturmak ve yerel değişikliklerinizi önizlemek için çalıştırıyoruz:

docfx docfx.json

docfx docfx.json

DocFX Özellikleri

DocFX ile IronPDF Entegrasyonu

DocFX ile IronPDF birleştirildiğinde, geliştiriciler her iki aracın avantajlarını kullanarak belgeleme süreçlerini geliştirebilirler. IronPDF'yi kullanarak DocFX tarafından oluşturulan HTML belgelerini PDF formatına dönüştürerek, geliştiriciler tutarlı bir şekilde cihazlar arası görüntüleme sağlayabilir, çevrimdışı erişim için belgeler oluşturabilir ve paylaşım ve dağıtımı kolaylaştırabilirler. IronPDF Dokümantasyonuna başvurunuz.

IronPDF'i Kurun

• Visual Studio projesini başlatın.
• "Araçlar" > "NuGet Paket Yöneticisi" > "Paket Yöneticisi Konsolu" seçeneğini tercih edin.
• Visual Studio Paket Yöneticisi Konsolu'nda, (bu satırı doğru bir paket yükleme komutuna düzeltin) aşağıdaki komutu yazın:

Install-Package IronPdf

• Alternatif olarak, IronPDF'i Çözümler için NuGet Paket Yöneticisi'ni kullanarak da yükleyebilirsiniz.

• Arama sonuçlarından IronPDF paketini seçebilir ve ardından "Install" seçeneğine tıklayabilirsiniz. Visual Studio, indirme ve kurulum işlemlerini sizin adınıza halledecektir.

  

• NuGet, projeniz için gerekli olan herhangi bir bağımlılık ile birlikte IronPDF paketini yükleyecektir.
• Kurulumdan sonra, IronPDF projenizde kullanılabilir.

Lojiği Uygulamak

Entegrasyon sürecinde aşağıdaki mantık uygulanır:

1. DocFX ile Dokümantasyon Oluşturun: İlk adım, dokümantasyonunuzu DocFX kullanarak oluşturmaktır. Bu, projenizin kaynak kodu ve Markdown dosyalarında DocFX yapı sürecini yürütmeyi içermektedir.
2. IronPDF'yi HTML Dokümantasyonunu PDF'ye Dönüştürmek için Kullanma: HTML dokümantasyonu oluşturulduktan sonra, programatik olarak PDF formatına dönüştürmek için IronPDF'yi kullanın. IronPDF'nin HTML'den PDF'ye dönüşüm özelliklerini kullanarak, HTML metinlerini yazdırılabilir PDF belgelere dönüştürmek kolaydır.
3. Dönüşüm Sürecini Otomatikleştirin: İş akışını optimize etmek için C# kodu veya scriptler kullanarak dönüşüm sürecini otomatikleştirin. Bu, belgelerin kolayca güncellenip yeniden oluşturulmasını sağlar ve manuel müdahale gerektirmez.

using IronPdf;

class Program
{
    static void Main()
    {
        // Create a new HtmlToPdf Renderer
        var Renderer = new HtmlToPdf();

        // Render the webpage as PDF
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");

        // Save PDF to a file
        PDF.SaveAs("output.pdf");

        // Inform the user of successful PDF creation
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Create a new HtmlToPdf Renderer
        var Renderer = new HtmlToPdf();

        // Render the webpage as PDF
        var PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html");

        // Save PDF to a file
        PDF.SaveAs("output.pdf");

        // Inform the user of successful PDF creation
        Console.WriteLine("PDF generated successfully!");
        Console.ReadKey();
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Create a new HtmlToPdf Renderer
		Dim Renderer = New HtmlToPdf()

		' Render the webpage as PDF
		Dim PDF = Renderer.RenderUrlAsPdf("http://localhost:8080/index.html")

		' Save PDF to a file
		PDF.SaveAs("output.pdf")

		' Inform the user of successful PDF creation
		Console.WriteLine("PDF generated successfully!")
		Console.ReadKey()
	End Sub
End Class

Kod örneği hakkında daha fazla bilgi için, bu örnek kullanım kılavuzuna bakın. Çalıştırma çıktısı aşağıda gösterilmiştir:

Sonuç

Sonuç olarak, geliştiriciler DocFX ile IronPDF'i C#'da entegre ederek PDF formatında mükemmel belgeler oluşturmak ve dağıtmak için güçlü bir seçeneğe sahiptir. DocFX ve IronPDF'in PDF üretim yeteneklerini belge üretiminde birleştirerek, geliştiriciler kapsamlı, çevrimdışı okuma için hazır belgeler üretebilir ve bunları kolayca paylaşabilirler. Bu entegrasyon, belge iş akışını geliştirir, proje belgelerinin okunabilirliğini ve erişilebilirliğini artırır ve yazılım projesinin başarı şansını artırır.

Bu makalede yer alan önerileri uygulayarak ve DocFX ile IronPDF'in yeteneklerini kullanarak, geliştiriciler belgeleme prosedürlerini optimize edebilir, ekip çalışmasını ve iletişimi geliştirebilir ve kullanıcılar ve paydaşlar için daha iyi belge deneyimleri sağlayabilirler.

$999 Lite paketi, süresiz lisans, bir yıl yazılım bakımı ve kütüphane için yükseltme içerir. IronPDF, yeniden dağıtım ve süre sınırlamalarına sahip ücretsiz lisanslama sunar. Kullanıcılar, deneme süresi boyunca çözümü bir filigran görmeden değerlendirebilir. Fiyat ve lisans hakkında daha fazla bilgi için IronPDF'nin lisanslama detaylarına bakınız.