1. Traduttori di KDE
  2. Sito dei traduttori italiani di KDE
  3. aggiornamento_kdeit

Overview

HTTPS SSH
Questo deposito contiene gli script di aggiornamento della banca dati delle traduzioni italiane di KDE come usato dal [sito dei traduttori italiani di KDE](http://kdeit.softwarelibero.it).

# Requisiti #
Per installare localmente gli script di aggiornamento è necessario innanzi tutto installare MySQL 5.x e PHP; se non viene fatto automaticamente dal sistema di gestione dei pacchetti, è necessario installare l'estensione MySQL per PHP.

Nel seguito viene spiegato come installare una copia locale del sito su un sistema Kubuntu; nota che i percorsi indicati, sul tuo sistema, potrebbero essere leggermente diversi.

# Configurazione di MySQL #
Devi creare una banca dati, un utente con password e dargli accesso alla banca dati.

Collegati quindi a mysql come utente *root* (nota che l'utente root di MySQL non ha niente a che fare con l'utente root del sistema!), e digita i comandi:

```
#!mysql
  CREATE DATABASE i18n_it;
  CREATE USER utente@localhost IDENTIFIED BY 'password';
  GRANT ALL PRIVILEGES ON i18n_it.* TO utente;

```

Dove *utente* e *password* possono essere quello che vuoi, basta che mantieni la consistenza nel seguito.

Rimane da copiare la struttura del database del sito: questa viene a volte modificata (per esempio quando abbiamo passato la soglia dei 256 iscritti...), e puoi scaricare quella attuale [da qui](http://kdeit.softwarelibero.it/databasestructure.php).  Il file non contiene nessun dato (sia per sicurezza che per ridurre le dimensioni del file da scaricare), e per importare la struttura devi eseguire:

```
#!bash
mysql i18n_it < struttura.sql -uutente -ppassword
```

# Usare nome utente e password #
Il sistema ha bisogno di sapere come identificarsi rispetto alla banda dati MySQL per chiedere accesso alle sue tabelle. Bisogna pertanto creare un file, chiamato ``wallet.php``, da inserire sia nella cartella del sistema di aggiornamento e contenente quanto segue:

```
#!php
<?php

$DB_user     = "utente";
$DB_password = "password";

?>
```
Insieme ad un ulteriore file, ``wallet`` (senza estensione ``.php``):
```
#!bash
DB_USERNAME="utente"
DB_PASSWORD="password"
```

Questi file non vanno mai caricati sui depositi, per motivi di sicurezza; il deposito sul sito centrale, ovviamente, ha le sue copie locali con il nome utente e la password usate dal sito.

# Primo avvio #
Per elaborare le statistiche delle traduzioni devi eseguire, solo la prima volta, lo script ``ritiraDeposito``.
Ci vorrà un po' per scaricare tutte le traduzioni italiane di KDE e tutti gli originali in inglese.

Una volta che i file sono stati scaricati, potrai avviare lo script di aggiornamento vero e proprio, ``update-stats``, che sul sito viene eseguito automaticamente. Anche questo ci metterà il suo tempo, ma puoi velocizzarne significativamente l'esecuzione commentando la riga che richiama ``inserisciTraduzioni``, l'istruzione più pesante perché estrae tutte le traduzioni e le inserisce nella banca dati.