Bien démarrer
Prérequis
- .NET 8
- Script de configuration des variables d'environnement (ps1)
Mise en place
Aucune configuration de domaine n'est requise pour la v4.
Variables d'environnement
Configurer la connexion à la base de données via le script .\cake\Set-EnvironmentVariable.ps1 :
- Modifier le fichier
.\cake\Set-EnvironmentVariable.ps1afin qu'il corresponde à votre configuration - Exécuter le script en tant qu'administrateur :
powershell
.\cake\Set-EnvironmentVariable.ps1Configuration de la base de données
Adapter le fichier appsettings.Development.json si nécessaire afin de configurer la connexion SQL utilisée par Umbraco.
Lancer l'application
Le starter kit v4 utilise directement dotnet-cake au lieu de .\build.ps1.
Cibles disponibles
Mode Watch
Applique automatiquement les changements :
bash
dotnet-cake --target="Watch"Run
Exécute dotnet run :
bash
dotnet-cake --target="Run"Review-App
Installation complète (création de la base de données, configuration, etc.) :
bash
dotnet-cake --target="Review-App"Démarrage rapide
- Configurer et exécuter en tant qu'administrateur :
.\cake\Set-EnvironmentVariable.ps1 - Adapter la connexion SQL dans
appsettings.Development.jsonsi nécessaire - Lancer l'installation complète :
dotnet-cake --target="Review-App" - Pour le développement :
dotnet-cake --target="Watch"
Informations sur le projet
Framework frontend
Le projet utilise Bootstrap 5.
Widgets Umbraco
Tous les widgets du site Umbraco suivent le pattern des composants ASP.NET en utilisant la méthode InvokeAsync.
Structure du projet
src\Nanoxi\Custom\Umbraco\App_Plugins: extensions du backoffice Umbraco (App_Plugins)src\Nanoxi\TypeScript: fichiers TypeScript compilés en JavaScript pour le sitesrc\Nanoxi\Design: fichiers de styles (.scss) (dart est utilisé pour la compilation en CSS)data\01.Scratch: base de données permettant d'initialiser Umbraco avec l'ensemble des widgets/pages, y compris les langues et contenus existants
Contributors
Clément Favre