va chercher et met à jour les repositories et link les sous-repertoires contenant les modules de langue décrits dans le fichier traductions
va chercher et met à jour les repositories et link les sous-repertoires contenant les modules de langue décrits dans le fichier traductions
Les depots sont checkout/update dans salvatore/depots/,
Les depots sont checkout/update dans salvatore/depots/,
et leurs repertoires contenant les modules de langue sont ciblés par des liens symboliques placés dans modules/
et leurs repertoires contenant les modules de langue sont ciblés par des liens symboliques placés dans modules/
On peut avoir plusieurs fois le même module extrait de plusieurs repositories differents ou de plusieurs repertoires du meme repository
On peut avoir plusieurs fois le même module extrait de plusieurs repositories differents ou de plusieurs repertoires du meme repository
*```spip salvatore:lire``` :
*`spip salvatore:lire` :
prend les fichiers de référence dans chaque dossier modules/xxx, et met à jour la base de données
prend les fichiers de référence dans chaque dossier modules/xxx, et met à jour la base de données
*```spip salvatore:ecrire``` :
*`spip salvatore:ecrire` :
exporte les traductions depuis la base donnees dans chaque dossier modules/xxx, et prépare un fichier .json avec les infos de commit
exporte les traductions depuis la base donnees dans chaque dossier modules/xxx, et prépare un fichier .json avec les infos de commit
*```spip salvatore:pousser``` :
*`spip salvatore:pousser` :
commit et pousse sur chaque repo (git|svn) les différents fichiers de langue de chaque module modifie
commit et pousse sur chaque repo (git|svn) les différents fichiers de langue de chaque module modifie
*```inc/savlatore.php``` :
*`inc/savlatore.php` :
librairie commune aux outils précédents
librairie commune aux outils précédents
## Installation et fonctionnement de tradlang
## Installation et fonctionnement de tradlang
Ces scripts nécessitent pour fonctionner :
Ces scripts nécessitent pour fonctionner :
1. SPIP v3.2.x
1. SPIP v4.2.x
2. Trad-lang v3.0.x
2. Trad-lang v4.0.x
3. créer le repertoire `salvatore/` a la racine du site avec les sous-dossiers `depots/``modules/` et `tmp/`
3. créer le repertoire `salvatore/` a la racine du site avec les sous-dossiers `depots/``modules/` et `tmp/`
4. créer également le sous-répertoire ```salvatore/traductions/``` dans le répertoire des scripts
4. créer également le sous-répertoire `salvatore/traductions/`
et y placer un ou des fichiers traductions.txt comportant les descriptions des modules à importer [comme cet exemple](http://zone.spip.org/trac/spip-zone/browser/traductions.txt)
et y placer un ou des fichiers traductions.txt comportant les descriptions des modules à importer [comme cet exemple](https://git.spip.net/spip-contrib-outils/archivelists/src/branch/master/traductions.txt)
<br/>Pour récupérer ce fichier par svn, et uniquement celui-ci, se placer dans le répertoire `salvatore/` et lancer : ```svn co svn://zone.spip.org/spip-zone/ traductions --depth empty```
<br/>Pour récupérer ce fichier, se placer dans le répertoire `salvatore/` et lancer : `git clone https://git.spip.net/spip-contrib-outils/archivelists.git`
1. Cette commande ne crée qu'un répertoire SVN vide, puis lancer cette commande ```cd traductions && svn up traductions.txt```
2. Cette dernière commande ne récupère que le fichier traductions.txt
1. récupérer les fichiers de langue indiqués dans le fichier traductions.txt
5. récupérer les fichiers de langue indiqués dans le fichier traductions.txt
1. Créer (s'il n'existe pas déjà) et modifier le fichier `config/salvatore_passwd.inc`
1. Créer (s'il n'existe pas déjà) et modifier le fichier ```config/salvatore_passwd.inc```
2. Dans ce fichier, ajouter les variables suivantes:
2. Dans ce fichier, ajouter les variables suivantes:
*```
```php
$SVNUSER = 'user@svn.tld'; // correspondant au nom d'utilisateur du serveur SVN qui enverra les fichiers.
$GITUSER='user@git.tld';// correspondant au nom d'utilisateur du serveur GIT qui enverra les fichiers.
$SVNPASSWD = 'mot de passe'; // correspondant au mot de passe de l'utilisateur du serveur SVN qui enverra les fichiers.
$GITPASSWD='mot de passe';// correspondant au mot de passe de l'utilisateur du serveur GIT qui enverra les fichiers.
$domaines_exceptions = array('git.spip.net');
$domaines_exceptions=array('git.spip.net');
$domaines_exceptions_credentials = array(
$domaines_exceptions_credentials=array(
'git.spip.net' => array('user' => 'user git','pass'=>'mot de passe'),
'git.spip.net'=>array('user'=>'user git','pass'=>'mot de passe'),
);
);
```
```
3. Lancer ensuite la commande : ```spip salvatore:tirer```
3. Lancer ensuite la commande : `spip salvatore:tirer`
6. import dans la base des modules de langue et de leur contenu, dans le répertoire des scripts, lancer : ```spip salvatore:lire```
2. import dans la base des modules de langue et de leur contenu, dans le répertoire des scripts, lancer : `spip salvatore:lire`
7. exporter le contenu de la base de donnée, dans le répertoire des scripts, lancer : ```spip salvatore:ecrire```
3. exporter le contenu de la base de donnée, dans le répertoire des scripts, lancer : `spip salvatore:ecrire`
8. envoyer les modifications sur le SVN ou GIT,
4. envoyer les modifications sur le SVN ou GIT,
1. pour ceci, vous devez pouvoir écrire sur les repositories grace aux logins/pass renseignés dans le fichier ```config/salvatore_passwd.inc```
1. pour ceci, vous devez pouvoir écrire sur les repositories grace aux logins/pass renseignés dans le fichier `config/salvatore_passwd.inc`
2. Lancer ensuite la commande : ```spip salvatore:pousser```
2. Lancer ensuite la commande : `spip salvatore:pousser`
## Options possibles
## Options possibles
Plusieurs options peuvent être définies dans le fichier config/mes_options.php du site par exemple.
Plusieurs options peuvent être définies dans le fichier config/mes_options.php du site par exemple.