docfx C# (Funktionsweise für Entwickler)

Wie man DocFX benutzt

1. Installieren Sie .NET SDK 6.0+
2. Öffnen Sie PowerShell.
3. Führen Sie das Skript nacheinander aus, um die DocFX-Bibliothek zu installieren.
4. Nach der Installation führen Sie die JSON-Datei aus.
5. Dadurch wird die Dokumentationsseite auf Port 8080 geöffnet.

Einführung in DocFX

Microsoft hat den Open-Source-Generator für statische Webseiten und das Dokumentationserstellungstool DocFX erstellt. Mit Hilfe von Markdown-Dateien und Quellcode können Entwickler professionelle Dokumentations-Webseiten erstellen. DocFX ist anpassungsfähig und weitgehend auf eine Vielzahl von Projekten anwendbar, da es eine Vielzahl von Markup-Formaten und Programmiersprachen unterstützt.

Entwickler können Tutorials, konzeptionelle Artikel und API-Referenzen in ihrer Dokumentation erstellen, indem sie DocFX verwenden. Aufgrund seiner anpassungsfähigen Architektur können Teams es an ihre einzigartigen Anforderungen anpassen und erweitern. DocFX bietet auch Funktionen wie Querverweise, editierbare Vorlagen und Unterstützung für mehrere Ausgabeformate, einschließlich HTML und Markdown. Für eine detailliertere Beschreibung der Funktionsweise und Methoden von DocFX besuchen Sie bitte die DocFX-Dokumentation.

Einstieg mit DocFX

Erstellen Sie eine neue DocFX-Website

In diesem Schritt erstellen wir eine einfache Dokumentations-Webseite auf Ihrem lokalen Computer.

• Ein grundlegendes Verständnis der Befehlszeilenoperationen ist notwendig.
• Eine Version von .NET SDK 6.0 oder später ist erforderlich.

Um die neueste Version von DocFX zu installieren, stellen Sie sicher, dass Sie das .NET SDK installiert haben, dann öffnen Sie ein Terminal-Befehlszeilen-Tool und geben den folgenden Befehl ein:

dotnet tool update -g docfx

Um ein neues Docset zu starten, führen Sie aus:

docfx init

docfx init

Es erstellt eine JSON-Datei mit allen Konfigurationen. Mit diesem Befehl können Sie ein neues DocFX-Projekt im aktuellen Arbeitsverzeichnis erstellen. Um das Docset zu erstellen, führen Sie aus:

docfx docfx.json --serve

docfx docfx.json --serve

Die Webseite kann nun auf http://localhost:8080 angesehen werden.

Änderungen speichern. DocFX wird mit der JSON-Konfigurationsdatei konfiguriert. Nun verwenden wir ein neues Terminal, um diesen Befehl auszuführen, um die Webseite neu zu erstellen und Ihre lokalen Änderungen anzuzeigen:

docfx docfx.json

docfx docfx.json

Funktionen von DocFX

Integration von DocFX mit IronPDF

Durch die Kombination von DocFX mit IronPDF können Entwickler die Vorteile jedes Tools nutzen und ihren Dokumentationsprozess verbessern. Entwickler können durch die Nutzung von IronPDF zum Konvertieren von DocFX-generierter HTML-Dokumentation in PDF-Format ein einheitliches Rendering auf verschiedenen Geräten sicherstellen, offline-fertige Dokumentationen erstellen und das Teilen und die Verteilung erleichtern. Um mehr über IronPDF zu erfahren, lesen Sie bitte die IronPDF-Dokumentation.

IronPDF installieren

• Starten Sie das Visual Studio-Projekt.
• Wählen Sie "Tools" > "NuGet-Paket-Manager" > "Paket-Manager-Konsole".
• Geben Sie in die Visual Studio-Paket-Manager-Konsole den folgenden Befehl ein (korrigieren Sie diese Zeile zu einem korrekten Paketinstallationsbefehl):

Install-Package IronPdf

• Alternativ können Sie IronPDF verwenden, indem Sie den NuGet-Paket-Manager für Lösungen nutzen.
• Sie können das IronPDF-Paket aus den Suchergebnissen auswählen und dann die Option "Installieren" anklicken. Visual Studio kümmert sich um den Download und die Installation in Ihrem Namen.

• NuGet wird das IronPDF-Paket zusammen mit allen für Ihr Projekt erforderlichen Abhängigkeiten installieren.
• Nach der Installation kann IronPDF in Ihrem Projekt genutzt werden.

Implementierung von Logik

Der folgende Ablauf ist in den Integrationsprozess involviert:

1. Erstellen Sie Dokumentation mit DocFX: Um zu beginnen, verwenden Sie DocFX, um Ihre Dokumentation zu erstellen. Um HTML-Dokumentation zu generieren, bedeutet dies, den DocFX-Build-Prozess auf dem Quellcode und den Markdown-Dateien für Ihr Projekt auszuführen.
2. Verwenden Sie IronPDF zur Umwandlung der HTML-Dokumentation in PDF: Nachdem die HTML-Dokumentation erstellt wurde, verwenden Sie IronPDF, um sie programmatisch in das PDF-Format umzuwandeln. Die Konvertierung von HTML-Text in druckbare PDF-Dokumente ist einfach mit IronPDFs HTML-zu-PDF-Konvertierungsfunktionen.
3. Automatisieren Sie den Umwandlungsprozess: Verwenden Sie C#-Code oder Skripte, um den Umwandlungsprozess zur Optimierung der Arbeitsabläufe zu automatisieren. Dies garantiert, dass die Dokumentation einfach aktualisiert und neu generiert werden kann, wenn ein manueller Eingriff nicht erforderlich ist.

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();
    }
}

Um mehr über das Codebeispiel zu lesen, sehen Sie diesen Beispielnutzungsleitfaden. Das Ausführungsergebnis ist unten gezeigt:

Abschluss

Schließlich haben Entwickler die Möglichkeit, durch die Integration von DocFX mit IronPDF in C# hervorragende Dokumentationen im PDF-Format zu erstellen und zu verbreiten. Entwickler können umfangreiche, offline-fertige Dokumentationen erstellen, die leicht erreichbar und teilbar sind, indem sie die DocFX- und IronPDF-PDF-Erstellungsmöglichkeiten zur Dokumentationserstellung kombinieren. Diese Integration verbessert den Dokumentations-Workflow, erhöht die Lesbarkeit und Zugänglichkeit von Projektdokumentationen und erhöht die Erfolgschancen von Softwareprojekten.

Entwickler können ihre Dokumentationsprozesse optimieren, die Teamarbeit und Kommunikation verbessern und bessere Dokumentationserfahrungen für Benutzer und Stakeholder bieten, indem sie die Empfehlungen in diesem Artikel umsetzen und die Fähigkeiten von DocFX und IronPDF nutzen.

Das $799 Lite-Paket enthält eine dauerhafte Lizenz, ein Jahr Softwarewartung und ein Upgrade auf die Bibliothek. IronPDF bietet kostenlose Lizenzen mit Einschränkungen bei der Weiterverbreitung und Zeit. Benutzer können die Lösung während der Testphase ohne Sichtbarkeit eines Wasserzeichens bewerten. Für zusätzliche Informationen zu Preis und Lizenz, sehen Sie die Lizenzdetails von IronPDF.