BlazorStatic

Exploitez la puissance de Blazor pour créer des sites Web statiques.

Transformez votre application Blazor en un site statique.

? Comment ça marche ?

BlazorStatic se veut intuitif et facile à utiliser pour la plupart des développeurs ayant travaillé avec tout type de framework front-end, surtout si vous travaillez déjà avec Blazor.

Le site de BlazorStatic est un exemple riche en fonctionnalités de la bibliothèque. Vérifiez le code source.

Lors de l'exécution de votre application, BlazorStatic récupère le code HTML des pages avec HttpClient , génère les fichiers et les ressources HTML dans le dossier output , et à partir de là, vous pouvez déployer sur n'importe quel serveur HTTP ou service d'hébergement standard.

Il existe de nombreux paramètres par défaut pour simplifier l'utilisation, mais vous pouvez le configurer de manière approfondie. Par exemple, vous pouvez faire correspondre votre présentation YAML dans des fichiers markdown (qui peuvent être réutilisés à partir d'autres générateurs de sites statiques).

Commencer

Vous pouvez commencer à utiliser BlazorStatic de trois manières, en fonction de votre configuration et de l'utilisation prévue. Vous aurez besoin du .NET SDK 8 ou supérieur pour commencer.

? Méthode recommandée

Installez les modèles BlazorStatic :

dotnet new install BlazorStatic.Templates

Cela ajoute de nouvelles options à votre dotnet new . Créez ensuite un nouveau projet en utilisant :

dotnet new BlazorStaticMinimalBlog -o MyBlazorStaticApp

Cela crée un dossier et un projet MyBlazorStaticApp . Il s'agit d'une application .NET Blazor standard avec le package BlazorStatic installé, comprenant quelques composants, styles et un article de blog prédéfinis avec un exemple de contenu.

Exécutez l'application à l'aide de dotnet watch . Cela lancera l'application, vous permettant de la visualiser en direct, tout en générant également des fichiers HTML statiques dans le dossier output .

À partir de là, vous êtes prêt à explorer le projet, à ajouter du contenu, à créer de nouvelles pages et bien plus encore.

• Les fichiers Markdown se trouvent dans le dossier Content/Blog .
• Un fichier .gitignore est inclus avec les recommandations .NET standard et ignore le dossier output .
• Le modèle comprend également un dossier .github avec une action GitHub pour la création et le déploiement sur les pages GitHub. Voir la section Déploiement ci-dessous.
• Vous pouvez tout personnaliser. Pour plus de détails, consultez ce document, qui explique tout plus en profondeur.

?‍➡️ Le moyen le plus rapide

Utilisez BlazorStaticMinimalBlog comme modèle (le gros bouton vert).

Il copiera tout le contenu et exécutera l'action GitHub pour vous. Une fois l'exécution terminée, accédez aux paramètres et activez les pages GitHub :

Votre page est prête maintenant !

Manière personnalisée

Si vous souhaitez bien comprendre le fonctionnement de BlazorStatic ou si vous avez un projet existant dans lequel vous souhaitez intégrer la bibliothèque BlazorStatic, repartez de zéro. Consultez ce document pour obtenir des conseils.

? Caractéristiques

• Tirez parti de votre expérience Blazor existante.
• Analysez et consommez facilement des fichiers markdown.
• Prise en charge des sujets frontaux YAML personnalisés.
• Détecte automatiquement les pages parmi les fichiers Razor.
• Possibilité d'ajouter/supprimer des pages selon les besoins.
• Fonctionne avec tous les frameworks et thèmes CSS.
• Facile à déployer avec le pipeline CI/CD.
• Prend en charge le rechargement à chaud
• A dotnet new

? Déploiement

Vous pouvez déployer le dossier output sur n'importe quel service d'hébergement statique, tel que GitHub Pages, Netlify, Vercel, Azure Static Web Apps, etc.

Des instructions détaillées sont ici.

Échantillons

Description	Source	En direct
Page sur BlazorStatic (ce dépôt contient le code lui-même)	source	en direct
Blog minimal	source	en direct
Zodoc - exemple de traitement d'image et d'apprentissage profond	source	en direct
❓Ajoutez votre page ici !!!

? Cotisations

Les contributions sont fortement encouragées et appréciées. Si vous trouvez quelque chose de manquant, de peu clair ou si vous rencontrez un problème avec le code, j'apprécie chaleureusement votre contribution. N'hésitez pas à :

• Créez un nouveau problème ou soumettez un PR.
• Contactez-nous par e-mail : [email protected]
• Contactez-moi directement pour toute question ou suggestion.
• Posez des questions ou démarrez une discussion sur le serveur Blazor Community Discord.