= UbuntuGames script (UGS) =
'''UGS''' è uno script in [[Programmazione/Python|Python]] realizzato per automatizzare l'inserimento delle nuove voci all'interno del [[Giochi|Portale Giochi]] del [[Documentazione/Indice|Wiki]] di Ubuntu-it. In particolare, lo script si occupa di facilitare la compilazione della tabella informativa relativa ad ogni gioco, oltre a svolgere altre varie funzioni. 
Lo script è rilasciato sotto licenza GPL v3.

== Utilità ==
Lo script permette di evitare errori comuni durante la scrittura delle pagine di wiki nel Portale Giochi:
 * permette anche ai meno esperti della formattazione wiki di poter completare la tabella descrittiva senza difficoltà;
 * permette anche ai meno esperti di ottenere facilmente il codice da inserire nelle pagine di lista ([[Giochi/Azione]], [[Giochi/RpgMmorpg|RpgMmorpg]], ecc.);
 * evita che si possa creare una nuova pagina con un NomeWiki errato (controllo NomeWiki sia sul nome del gioco che su quello dell'utente);
 * evita che si dimentichi di inserire la licenza;
 * evita che vengano caricate immagini con lo stesso nome, o con nomi non significativi;
 * evita che si dimentichi la Category in fondo alla pagina;

== Download e Avvio ==
 0. La versione più aggiornata dello script è attualmente scaricabile con il comando da terminale{{{
cd
wget http://fradeve.altervista.org/ugs-0.8.8.zip}}}
 0. Al termine del download, [[AmministrazioneSistema/FormatiDiCompressione|estrarre]] il pacchetto; è possibile anche farlo da terminale, con il comando{{{
cd
unzip ugs-*.zip}}}
 0. Eliminare l'archivio, ormai inutile, con il comando{{{
rm ugs-*.zip}}}
 0. Entrare nella cartella dello script ed eseguirlo, con i comandi{{{
cd ugs
python ugs.py}}}

== Rilasci e versioni ==
'''0.8.8'''
 * aggiunto supporto per tutti i browser (Firefox, Konqueror, Lynx, Netscape); dovrebbe supportare anche Internet Explorer;
 * supportato l'inserimento di "qualsiasi" nei campi Processore, RAM  e Scheda video (automaticamente convertito in minuscolo nel caso si scriva "Qualsiasi");
 * aggiunta la pulizia dei file dalla cartella `ugs/risultati`, ed eliminati eventuali messaggi d'errore legati all'assenza del file opzionale `lista.txt`;
 * è stato pulito un bel pò il codice, e create le funzioni "def" per snellire il processo del NomeWiki e della pulizia dei file.
'''0.8'''
 * aggiunto controllo su quantità di RAM (MiB, GiB);
 * aggiunto controllo sulla grandezza del download (KiB, MiB);
 * aggiunto controllo sull'indirizzo del sito (supporto per "http://", "www" e "ftp://");
 * migliorata leggibilità e pulizia dello script; ordinate sequenze delle azioni.
'''0.7'''
 * aggiunta funzione di creazione della voce per i menù di sezione;
 * ottimizzato e ridotto il comando di avvio;
 * inserita funzione che controlla automaticamente la maiuscola all'inizio della descrizione della voce di lista;
 * sistemate cartelle dello script ed eliminati file inutili;
 * eliminata opzione non funzionante "modifica dati";
'''0.6'''
 * trasformazione di qualsiasi nome del gioco inserito dall'utente in un NomeWiki;
 * inserimento veloce di Categoria, N° Giocatori, Download, Sito Ufficiale, Requisiti Minimi;
 * selezione assistita della Licenza;
 * rinomina automaticamente l'immagine del gioco con il nome del gioco stesso;
 * inserimento della !CategoryGiochi solo se la guida è completa;
 * apertura diretta (in modalità ''edit'') della pagina Prove dell'utente (se la guida è incompleta) o direttamente della pagina del gioco (se la guida è completa); se il [[NomeWiki|NomeUtente]] digitato alla richiesta non è corretto (per esempio, se scrivo ''Francesco de virgilio'' al posto di ''!FrancescoDeVirgilio''), viene automaticamente corretto dallo script.

== Note ==
 * Il risultato dell'esecuzione dello script è visbile nei file `risultato.txt` e `lista.txt`, generati ''temporaneamente'' all'interno della cartella `usg/risultati`, ma copiati nella propria '''Home'''.
 * La cartella `ugs/non_modificare` contiene file essenziali per ottenere risultati corretti, quindi non vanno modificati nè rinominati.
 * Lo script attualmente supporta tutti i browser per GNU/Linux e dovrebbe funzionare anche su Windows con Internet Explorer.
 * Per il corretto funzionamento dello script, non bisogna rimuovere nessuno dei file dalla cartella `ugs`.
 * Alcune opzioni presenti nello script permettono di entrare nel Wiki di Ubuntu-it direttamente in modalità ''edit'', per cui, prima di utilizzarlo, è consigliabile essere iscritti al Wiki.
--------------
<<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>><<BR>>
= In lavorazione =
----
CategoryHomepage