Sync to latest WFRP release
This commit is contained in:
146
tools/README-copy-new-scripts.md
Normal file
146
tools/README-copy-new-scripts.md
Normal file
@@ -0,0 +1,146 @@
|
||||
# Script de copie des nouveaux scripts WFRP4E
|
||||
|
||||
## Description
|
||||
|
||||
Ce script permet d'identifier et de copier automatiquement les nouveaux scripts du système WFRP4E vers le module de traduction française, sans toucher aux scripts déjà présents.
|
||||
|
||||
## Fonctionnalités
|
||||
|
||||
- **Liste** les nouveaux scripts présents dans WFRP4E mais absents du module FR
|
||||
- **Simule** la copie (dry-run) pour voir ce qui serait fait avant de copier
|
||||
- **Copie** les nouveaux scripts automatiquement
|
||||
- Génère un fichier de log (`copy-new-scripts.log`) avec les détails de l'opération
|
||||
|
||||
## Utilisation
|
||||
|
||||
### 1. Lister les nouveaux scripts
|
||||
|
||||
Pour voir combien de nouveaux scripts il y a et leur liste :
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js --list
|
||||
```
|
||||
|
||||
ou
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js -l
|
||||
```
|
||||
|
||||
### 2. Simuler la copie (recommandé)
|
||||
|
||||
Avant de copier, il est conseillé de faire une simulation pour vérifier ce qui sera fait :
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js --dry-run
|
||||
```
|
||||
|
||||
ou
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js -d
|
||||
```
|
||||
|
||||
### 3. Copier les nouveaux scripts
|
||||
|
||||
Pour copier effectivement les nouveaux scripts :
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js --copy
|
||||
```
|
||||
|
||||
ou
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js -c
|
||||
```
|
||||
|
||||
### 4. Afficher l'aide
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js --help
|
||||
```
|
||||
|
||||
ou
|
||||
|
||||
```bash
|
||||
node tools/copy-new-scripts.js -h
|
||||
```
|
||||
|
||||
## Workflow recommandé
|
||||
|
||||
1. **Lister** d'abord pour savoir combien de scripts il y a :
|
||||
```bash
|
||||
node tools/copy-new-scripts.js --list
|
||||
```
|
||||
|
||||
2. **Simuler** pour vérifier que tout est correct :
|
||||
```bash
|
||||
node tools/copy-new-scripts.js --dry-run
|
||||
```
|
||||
|
||||
3. **Copier** une fois que vous êtes sûr :
|
||||
```bash
|
||||
node tools/copy-new-scripts.js --copy
|
||||
```
|
||||
|
||||
4. **Vérifier** le log généré dans `tools/copy-new-scripts.log`
|
||||
|
||||
## Fichiers générés
|
||||
|
||||
- `tools/copy-new-scripts.log` : JSON contenant les détails de la dernière opération de copie
|
||||
- Date de l'opération
|
||||
- Statistiques (total, nombre copiés, erreurs)
|
||||
- Liste des fichiers copiés
|
||||
|
||||
## Notes importantes
|
||||
|
||||
- ✅ Le script ne touche **jamais** aux scripts déjà présents dans le module FR
|
||||
- ✅ Seuls les **nouveaux** scripts (présents dans WFRP4E mais absents du FR) sont copiés
|
||||
- ✅ Les scripts copiés devront ensuite être traduits manuellement
|
||||
- ⚠️ Le script copie les scripts tels quels, sans traduction
|
||||
|
||||
## Complémentarité avec d'autres scripts
|
||||
|
||||
Ce script peut être utilisé en complément de :
|
||||
|
||||
- `sync-scripts.js` : Compare les scripts existants et génère un rapport détaillé
|
||||
- Les autres outils de traduction dans le dossier `tools/`
|
||||
|
||||
## Exemple de sortie
|
||||
|
||||
```
|
||||
📊 Statistiques:
|
||||
- Scripts dans WFRP4E: 1983
|
||||
- Scripts dans FR: 1538
|
||||
- Nouveaux scripts à copier: 445
|
||||
|
||||
📋 Copie des nouveaux scripts...
|
||||
|
||||
✓ [1/445] 0FNOq4J1AdPd2A0q.js
|
||||
✓ [2/445] 0J1yHP1jkGR9y89H.js
|
||||
...
|
||||
|
||||
============================================================
|
||||
📝 Résumé de l'opération:
|
||||
============================================================
|
||||
✅ Fichiers copiés avec succès: 445
|
||||
📄 Log sauvegardé dans: /path/to/tools/copy-new-scripts.log
|
||||
============================================================
|
||||
```
|
||||
|
||||
## Dépannage
|
||||
|
||||
### Le script ne trouve aucun nouveau fichier
|
||||
|
||||
Vérifiez que :
|
||||
- Les chemins dans le script sont corrects (WFRP4E_SCRIPTS et FR_SCRIPTS)
|
||||
- Le système WFRP4E a bien été mis à jour
|
||||
- Les scripts n'ont pas déjà été copiés
|
||||
|
||||
### Erreurs de copie
|
||||
|
||||
Si certains fichiers ne se copient pas :
|
||||
- Vérifiez les permissions des dossiers
|
||||
- Vérifiez l'espace disque disponible
|
||||
- Consultez le log pour les détails des erreurs
|
||||
Reference in New Issue
Block a user