source: spip-zone/_plugins_/trad-lang/trunk/salvatore/README.md @ 119613

Last change on this file since 119613 was 119613, checked in by Cerdic, 2 years ago

Mise a jour du Readme et de l'aide en ligne

  • Property svn:eol-style set to native
File size: 3.2 KB
Line 
1#Salvatore : Robot de gestion de traductions
2
3##Les outils fournis :
4
5Salvatore s'utilise via des fonctions spip-cli.
6
7* ```spip salvatore:tirer``` :
8        va chercher et met à jour les repositories et link les sous-repertoires contenant les modules de langue décrits dans le fichier traductions
9        Les depots sont checkout/update dans salvatore/depots/,
10        et leurs repertoires contenant les modules de langue sont ciblés par des liens symboliques placés dans modules/
11        On peut avoir plusieurs fois le même module extrait de plusieurs repositories differents ou de plusieurs repertoires du meme repository
12* ```lecteur.php``` :
13        prend les fichiers de référence dans sa copie locale (des SVN), et met à jour la base de données (Voir le plugin tradlang)
14* ```ecriveur.php``` :
15        exporte les traductions (à partir du plugin tradlang) sous forme de fichiers traduits, dans une copie locale (idem export SVN)
16* ```pousseur.php``` :
17        commit SVN les différents fichiers de langue
18* ```inc_tradlang.php``` :
19        librairie commune aux outils  précédents
20
21##Installation et fonctionnement de tradlang
22
23Ces scripts nécessitent pour fonctionner :
241. SPIP v3.2.x
252. Trad-lang v3.0.x
263. créer le repertoire `salvatore/` a la racine du site avec les sous-dossiers `depots/` `modules/` et `tmp/`
274. créer également le sous-répertoire ```salvatore/traductions/``` dans le répertoire des scripts
28et 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)
29<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```
30        1. Cette commande ne crée qu'un répertoire SVN vide, puis lancer cette commande ```cd traductions && svn up traductions.txt```
31        2. Cette dernière commande ne récupère que le fichier traductions.txt
325. récupérer les fichiers de langue indiqués dans le fichier traductions.txt, dans le répertoire des scripts lancer : ```spip salvatore:tirer```
33
348. import dans la base des modules de langue et de leur contenu, dans le répertoire des scripts, lancer : ```php lecteur.php```
359. exporter le contenu de la base de donnée, dans le répertoire des scripts, lancer : ```php ecriveur.php```
3610. envoyer les modifications sur le SVN, pour ceci, vous devez pouvoir écrire sur le serveur SVN.
37        1. Créer (s'il n'existe pas déjà) et modifier le fichier ```config/salvatore_passwd.inc```
38        2. Dans ce fichier, ajouter les deux variables suivantes:
39                * ```$SVNUSER = 'user@svn.tld';``` correspondant au nom d'utilisateur du serveur SVN qui enverra les fichiers.
40                * ```$SVNPASSWD = 'mot de passe';``` correspondant au mot de passe de l'utilisateur du serveur SVN qui enverra les fichiers.
41        3. Lancer ensuite la commande : ```php pousseur.php```
42
43
44##Options possibles
45
46Plusieurs options peuvent être définies dans le fichier config/mes_options.php du site par exemple.
47
48```define('_EMAIL_ERREURS','nom@domaine.tld');```
49
50```define('_EMAIL_SALVATORE','salvatore@domaine.tld');```
51
52```define('_ID_AUTEUR_SALVATORE','23');```
53
54```define('_SPAM_ENCRYPT_NAME',true);```
Note: See TracBrowser for help on using the repository browser.