Implémentation cadMasterCLI v2.0.0 :
- Interface bilingue FR/EN - Auto-mise à jour - Fenêtre unique avec logs intégrés - liste par badges - README bilingue
This commit is contained in:
@@ -19,12 +19,14 @@ cadMasterCLI est une interface graphique qui vous permet de **lancer des scripts
|
||||
|
||||
Il suffit de :
|
||||
1. Faire un clique-droit sur le fichier cadMasterCLI.ps1 et choisir "Exécuter avec Powershell"
|
||||
2. Sélectionner le script que vous souhaitez exécuter
|
||||
2. Sélectionner le script que vous souhaitez exécuter dans la liste à gauche
|
||||
3. Remplir les informations demandées (adresse IP, fichier CSV, etc.)
|
||||
4. Cliquer sur **Lancer le script**
|
||||
4. Cliquer sur **Lancer le script** et suivre le résultat dans le journal d'exécution intégré
|
||||
|
||||
Les scripts sont téléchargés automatiquement depuis un serveur centralisé (Gitea). Si vous n'avez pas accès au réseau, les scripts déjà utilisés restent disponibles en mode hors ligne.
|
||||
|
||||
L'interface est disponible en **français et en anglais**, et cadMasterCLI **vérifie et propose ses propres mises à jour** au démarrage.
|
||||
|
||||
---
|
||||
|
||||
## Prérequis
|
||||
@@ -94,28 +96,31 @@ Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||
|
||||
## Utilisation
|
||||
|
||||
### 1. Sélectionner un script
|
||||
cadMasterCLI tient dans **une seule fenêtre** : la liste des scripts à gauche, et un panneau à droite qui affiche la documentation, le formulaire et le journal d'exécution du script sélectionné.
|
||||
|
||||
Au démarrage, une fenêtre de sélection s'affiche avec la liste des scripts disponibles.
|
||||
### 1. Choisir la langue de l'interface
|
||||
|
||||
| Colonne | Signification |
|
||||
Un bouton **FR / EN** en haut à droite de la fenêtre permet de basculer l'interface entre français et anglais à tout moment. Au premier lancement, la langue de Windows est détectée automatiquement ; votre choix est ensuite mémorisé pour les prochaines fois.
|
||||
|
||||
### 2. Sélectionner un script
|
||||
|
||||
La liste à gauche affiche en permanence tous les scripts disponibles, avec pour chacun :
|
||||
|
||||
| Élément | Signification |
|
||||
|---|---|
|
||||
| Nom | Nom du script |
|
||||
| Description | Ce que fait le script |
|
||||
| Mis à jour | Date de la dernière mise à jour |
|
||||
| Cache local | Indique si le script a déjà été téléchargé |
|
||||
| MAJ dispo | `[NOUVEAU]` si une mise à jour est disponible |
|
||||
| Date | Date de la dernière mise à jour sur le serveur |
|
||||
| Badge vert **En cache** | Le script a déjà été téléchargé sur cet ordinateur |
|
||||
| Badge orange **Nouveau** | Une mise à jour est disponible pour ce script |
|
||||
|
||||
Double-cliquez sur le script souhaité, ou sélectionnez-le et cliquez sur **OK**.
|
||||
Cliquez sur un script pour afficher sa documentation et son formulaire de paramètres dans le panneau de droite.
|
||||
|
||||
> Pour fermer sans rien exécuter, fermez simplement la fenêtre.
|
||||
### 3. Remplir les paramètres
|
||||
|
||||
### 2. Remplir les paramètres
|
||||
|
||||
Une fenêtre s'ouvre avec :
|
||||
Le panneau de droite affiche :
|
||||
|
||||
- **À gauche** : la documentation du script (README), pour comprendre à quoi il sert et comment le remplir.
|
||||
- **À droite** : le formulaire de paramètres à remplir.
|
||||
- **À droite** : le formulaire de paramètres à remplir, ainsi que le journal d'exécution en dessous.
|
||||
|
||||
**Types de champs :**
|
||||
|
||||
@@ -134,27 +139,40 @@ Cliquez sur **[?] Voir l'aide** sous un champ pour afficher une description dét
|
||||
- Cliquez sur **Fermer README** pour masquer la documentation et agrandir le formulaire.
|
||||
- Cliquez sur **Ouvrir README** pour la réafficher.
|
||||
- Vous pouvez redimensionner le panneau README en faisant glisser la barre de séparation entre les deux zones.
|
||||
- Si le README du script propose une version française et anglaise, la section affichée suit automatiquement la langue choisie dans l'interface.
|
||||
|
||||
### 3. Lancer le script
|
||||
### 4. Lancer le script et suivre l'exécution
|
||||
|
||||
Une fois tous les champs obligatoires remplis :
|
||||
|
||||
- Cliquez sur **Lancer le script** (bouton vert).
|
||||
- Le script s'exécute dans le terminal. Attendez la fin de l'exécution.
|
||||
- Appuyez sur **Entrée** pour fermer.
|
||||
- Le script s'exécute en arrière-plan ; sa sortie s'affiche **en direct dans le journal d'exécution**, directement dans la fenêtre (plus de fenêtre de terminal séparée).
|
||||
- Pendant l'exécution, la liste des scripts et les boutons sont désactivés ; ils redeviennent disponibles à la fin.
|
||||
- Un message final indique si l'exécution s'est terminée avec succès ou en erreur.
|
||||
|
||||
> Cliquez sur **Annuler** pour revenir à la liste des scripts sans rien exécuter.
|
||||
Cliquez sur **Retour à la liste** pour revenir à la liste des scripts et en sélectionner un autre.
|
||||
|
||||
---
|
||||
|
||||
## Mise à jour automatique des scripts
|
||||
|
||||
Lorsqu'une nouvelle version d'un script est disponible sur le serveur, cadMasterCLI vous le signale avec `[NOUVEAU]` dans la liste et vous propose de télécharger la mise à jour.
|
||||
Lorsqu'une nouvelle version d'un script est disponible sur le serveur, cadMasterCLI le signale avec un badge **Nouveau** dans la liste et vous propose de télécharger la mise à jour au moment où vous sélectionnez ce script.
|
||||
|
||||
Les scripts sont stockés localement dans le sous-dossier `scripts\` à côté de `cadMasterCLI.ps1`.
|
||||
|
||||
---
|
||||
|
||||
## Mise à jour automatique de cadMasterCLI lui-même
|
||||
|
||||
À chaque démarrage, cadMasterCLI vérifie s'il existe une version plus récente de lui-même sur le serveur.
|
||||
|
||||
- Si c'est le cas, une fenêtre vous propose de l'installer.
|
||||
- En acceptant, la nouvelle version est téléchargée, remplace automatiquement le fichier `cadMasterCLI.ps1` actuel, et l'application redémarre toute seule.
|
||||
- En refusant, l'application continue de démarrer normalement avec la version actuelle (la question sera reposée au prochain lancement).
|
||||
- Si le serveur est inaccessible, aucune vérification n'est possible : cadMasterCLI démarre normalement, sans message d'erreur.
|
||||
|
||||
---
|
||||
|
||||
## Mode hors ligne
|
||||
|
||||
Si le serveur Gitea est inaccessible (pas de réseau), cadMasterCLI utilise automatiquement les scripts déjà téléchargés. Un message vous prévient que vous êtes en mode hors ligne.
|
||||
@@ -177,9 +195,13 @@ Si le serveur Gitea est inaccessible (pas de réseau), cadMasterCLI utilise auto
|
||||
```
|
||||
cadMasterCLI/
|
||||
├── cadMasterCLI.ps1 ← fichier principal à lancer
|
||||
├── version.txt ← version de référence pour l'auto-mise à jour
|
||||
├── cadmastercli.config.json ← préférence de langue (créé automatiquement)
|
||||
├── README.md ← cette documentation
|
||||
├── CONTRIBUTING_SCRIPTS.md ← guide pour créer de nouveaux scripts
|
||||
├── _template_script.ps1 ← modèle de script
|
||||
├── doc_contribution/
|
||||
│ ├── CONTRIBUTING_SCRIPTS.md ← guide pour créer de nouveaux scripts
|
||||
│ ├── _template_script.ps1 ← modèle de script
|
||||
│ └── _template_script.README.md ← modèle de README bilingue FR/EN
|
||||
└── scripts/ ← scripts téléchargés (créé automatiquement)
|
||||
└── NomDuScript/
|
||||
└── NomDuScript.ps1
|
||||
|
||||
+883
-328
File diff suppressed because it is too large
Load Diff
@@ -55,7 +55,40 @@ cadMasterCLI détecte automatiquement un paramètre comme **fichier** et affiche
|
||||
|
||||
Si le nom contient `Csv` ou `Input`, une zone de collage d'IPs avec conversion automatique en CSV est également proposée.
|
||||
|
||||
### 4. Structure du dépôt Gitea
|
||||
### 4. README bilingue FR/EN
|
||||
|
||||
Depuis cadMasterCLI v2, l'interface peut s'afficher en français ou en anglais. Pour que la documentation du script (panneau de gauche) suive la langue active, le `README.md` du dépôt peut contenir les deux versions dans un seul fichier, séparées par des marqueurs HTML :
|
||||
|
||||
```markdown
|
||||
<!-- FR -->
|
||||
# Nom du script
|
||||
|
||||
Description en français...
|
||||
|
||||
## Paramètres
|
||||
|
||||
- `MonParam` : ce que fait ce paramètre.
|
||||
|
||||
<!-- EN -->
|
||||
# Script name
|
||||
|
||||
Description in English...
|
||||
|
||||
## Parameters
|
||||
|
||||
- `MonParam`: what this parameter does.
|
||||
```
|
||||
|
||||
Règles :
|
||||
|
||||
- Les marqueurs `<!-- FR -->` et `<!-- EN -->` doivent être seuls sur leur ligne.
|
||||
- L'ordre des sections n'a pas d'importance.
|
||||
- Si une seule des deux langues est présente, cadMasterCLI l'affiche quelle que soit la langue active (pas d'erreur).
|
||||
- **Rétro-compatibilité** : un `README.md` sans aucun marqueur continue de s'afficher tel quel dans les deux langues (comportement identique aux versions précédentes de cadMasterCLI).
|
||||
|
||||
Voir `_template_script.README.md` dans ce dépôt pour un exemple complet.
|
||||
|
||||
### 5. Structure du dépôt Gitea
|
||||
|
||||
Le dépôt doit contenir à sa racine :
|
||||
|
||||
@@ -88,6 +121,6 @@ MonScript/
|
||||
|
||||
## Exemple minimal conforme
|
||||
|
||||
Voir `_template_script.ps1` dans ce dépôt pour un squelette prêt à l'emploi.
|
||||
Voir `_template_script.ps1` (script) et `_template_script.README.md` (documentation bilingue) dans ce dépôt pour un squelette prêt à l'emploi.
|
||||
|
||||
Pour un exemple complet et fonctionnel, voir le script **DaliACLI**.
|
||||
|
||||
@@ -0,0 +1 @@
|
||||
2.0.0
|
||||
Reference in New Issue
Block a user