BlazorStatic

Nutzen Sie die Leistungsfähigkeit von Blazor, um statische Websites zu erstellen.

Verwandeln Sie Ihre Blazor-App in eine statische Site.

? Wie funktioniert es?

BlazorStatic soll für die meisten Entwickler, die mit Front-End-Frameworks jeglicher Art gearbeitet haben, intuitiv und einfach zu bedienen sein, insbesondere wenn Sie bereits mit Blazor arbeiten.

Die Site für BlazorStatic ist ein funktionsreiches Beispiel der Bibliothek. Überprüfen Sie den Quellcode.

Beim Ausführen Ihrer App ruft BlazorStatic den HTML-Code der Seiten mit HttpClient ab, gibt HTML-Dateien und Assets in den output aus und von dort aus können Sie die App auf jedem Standard-HTTP-Server oder Hosting-Dienst bereitstellen.

Es gibt viele Standardeinstellungen, um die Verwendung einfach zu halten, Sie können sie jedoch umfassend konfigurieren. Beispielsweise können Sie Ihr YAML-Titelthema in Markdown-Dateien abgleichen (die von anderen statischen Site-Generatoren wiederverwendet werden können).

Erste Schritte

Sie können BlazorStatic je nach Einrichtung und beabsichtigter Verwendung auf drei Arten verwenden. Zum Einstieg benötigen Sie .NET SDK 8 oder höher.

? Empfohlener Weg

Installieren Sie die BlazorStatic-Vorlagen:

dotnet new install BlazorStatic.Templates

Dadurch werden Ihrer dotnet new -Vorlagenliste neue Optionen hinzugefügt. Erstellen Sie dann ein neues Projekt mit:

dotnet new BlazorStaticMinimalBlog -o MyBlazorStaticApp

Dadurch werden ein MyBlazorStaticApp Ordner und ein MyBlazorStaticApp-Projekt erstellt. Es handelt sich um eine Standard-.NET-Blazor-App mit installiertem BlazorStatic-Paket, einschließlich einiger vordefinierter Komponenten, Stile und eines Blogbeitrags mit Beispielinhalten.

Führen Sie die App mit dotnet watch aus. Dadurch wird die App gestartet, sodass Sie sie live ansehen und gleichzeitig statische HTML-Dateien im output generieren können.

Von hier aus können Sie das Projekt erkunden, Inhalte hinzufügen, neue Seiten erstellen und vieles mehr.

• Markdown-Dateien befinden sich im Ordner Content/Blog .
• Eine .gitignore Datei ist in den standardmäßigen .NET-Empfehlungen enthalten und ignoriert den output .
• Die Vorlage enthält außerdem einen .github Ordner mit einer GitHub-Aktion zum Erstellen und Bereitstellen auf GitHub-Seiten. Weitere Informationen finden Sie im Abschnitt „Bereitstellen“ weiter unten.
• Sie können alles anpassen. Weitere Einzelheiten finden Sie in diesem Dokument, in dem alles ausführlicher erklärt wird.

?‍➡️ Schnellster Weg

Verwenden Sie BlazorStaticMinimalBlog als Vorlage (der große grüne Knopf).

Es kopiert den gesamten Inhalt und führt die GitHub-Aktion für Sie aus. Gehen Sie nach der Ausführung zu den Einstellungen und aktivieren Sie die GitHub-Seiten:

Ihre Seite ist jetzt fertig!

Benutzerdefinierter Weg

Wenn Sie vollständig verstehen möchten, wie BlazorStatic funktioniert, oder wenn Sie ein bestehendes Projekt haben, in das Sie die BlazorStatic-Bibliothek integrieren möchten, beginnen Sie ganz von vorne. Sehen Sie sich dieses Dokument als Orientierungshilfe an.

? Merkmale

• Nutzen Sie Ihre bestehende Blazor-Erfahrung.
• Einfaches Analysieren und Nutzen von Markdown-Dateien.
• Unterstützung für benutzerdefinierte YAML-Frontangelegenheiten.
• Erkennt automatisch Seiten in Razor-Dateien.
• Möglichkeit, Seiten nach Bedarf hinzuzufügen/zu entfernen.
• Funktioniert mit allen CSS-Frameworks und Themes.
• Einfache Bereitstellung mit CI/CD-Pipeline.
• Unterstützt HotReload
• Hat dotnet new Vorlage

? Bereitstellen

Sie können den output für jeden statischen Hostingdienst bereitstellen, z. B. GitHub Pages, Netlify, Vercel, Azure Static Web Apps usw.

Detaillierte Anweisungen finden Sie hier.

Proben

Beschreibung	Quelle	Live
Seite über BlazorStatic (dieses Repo enthält den Code selbst)	Quelle	live
Minimaler Blog	Quelle	live
Zodoc – Beispiel für Bildverarbeitung und Deep Learning	Quelle	live
❓ Fügen Sie Ihre Seite hier hinzu!!!

? Beiträge

Beiträge sind sehr erwünscht und willkommen. Wenn Sie feststellen, dass etwas fehlt oder unklar ist oder ein Problem mit dem Code auftritt, freue ich mich sehr über Ihre Eingabe. Fühlen Sie sich frei:

• Erstellen Sie eine neue Ausgabe oder reichen Sie eine PR ein.
• Kontaktieren Sie uns per E-Mail: [email protected]
• Kontaktieren Sie mich direkt für Fragen oder Anregungen.
• Stellen Sie Fragen oder starten Sie eine Diskussion auf dem Blazor Community Discord-Server.