foundryvtt-wh4-lang-fr-fr/tools/README-copy-new-scripts.md

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 :

node tools/copy-new-scripts.js --list

ou

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 :

node tools/copy-new-scripts.js --dry-run

ou

node tools/copy-new-scripts.js -d

3. Copier les nouveaux scripts

Pour copier effectivement les nouveaux scripts :

node tools/copy-new-scripts.js --copy

ou

node tools/copy-new-scripts.js -c

4. Afficher l'aide

node tools/copy-new-scripts.js --help

ou

node tools/copy-new-scripts.js -h

Workflow recommandé

1. Lister d'abord pour savoir combien de scripts il y a :

   node tools/copy-new-scripts.js --list
   

2. Simuler pour vérifier que tout est correct :

   node tools/copy-new-scripts.js --dry-run
   

3. Copier une fois que vous êtes sûr :

   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