MagiCum S.r.l. Progetto Inno-School
Area Web Autore: Davide Revisione: 1.2 Data: 23/5/2013 Titolo: Innopedia File: Documentazione_tecnica Sito: http://inno-school.netsons.org/
Indice: 1. Presentazione Innopedia 2 2. I requisiti per l installazione 2 3. DBMS e Database 2 4. Markup Language di Mediawiki 3 5. Browser & OS vs Mediawiki 5 1
Documentazione tecnica 1. Presentazione Innopedia Innopedia, piattaforma in grado di raccogliere documenti ipertestuali e modificabile dai suoi utenti, è stata realizzata con il software MediaWiki, software in grado di realizzare con un proprio markup language un wiki. Un wiki è un prodotto web che permette ai propri utenti di aggiungere, modificare o cancellare i contenuti attraverso un browser web. Si tratta in altre parole di una raccolta di documenti ipertestuali che viene aggiornata dai suoi stessi utilizzatori e i cui contenuti sono sviluppati in collaborazione da tutti coloro che vi hanno accesso (contenuto generato dagli utenti). 2. I requisiti per l installazione I requisiti minimi di MediaWiki sono: - l'interprete PHP, necessario per eseguire il software; - un database manager, cioè il software che permette a MediaWiki di leggere e scrivere su database; - un web server, cioè il software che indirizza a MediaWiki le richieste inviate al computer in uso. - MediaWiki richiede PHP 5. 1 + e MySQL, o PostgreSQL o SQLite (PHP 5.3.1 ha in esso un bug e non è supportato da MediaWiki. È consigliabile utilizzare PHP 5.3.0 o PHP 5.3.2+. Tuttavia, a causa di un problema di sicurezza con PHP, è fortemente consigliato utilizzare PHP 5.2.17+ o PHP 5.3.5+). Essa offre: Numero di utenze Capacità di memoria File Caricati Immagini Illimitate illimitata (png, gif, jpg, jpeg) 3. DBMS e Database Le archiviazioni di dati e dei relativi contenuti in modo tale da consentire la gestione/organizzazione efficiente dei dati stessi avvengono grazie a particolari applicazioni software dedicati (DBMS o database manager). Il DBMS open source usato per la gestione del database è MySQL. MySQL è un DBMS relazionale che viene distribuito con una doppia licenza: una licenza commerciale (a pagamento), che consente di includere le funzionalità di MySQL nello sviluppo di un proprio software e vendere tale software con licenza commerciale. Una licenza libera 2
(GNU General Public License, GPL), che consente si scaricare liberamente i sorgenti e gli eseguibili, modificare i sorgenti e ridistribuirli a patto che il prodotto creato sia distribuito con la licenza GPL. MySQL funziona su diverse piattaforme, in particolare, Linux, Mac OS X e MS Windows. La gestione delle aree in oggetto provvede: - Creazione di pagine del progetto - Modifica delle pagine - Caricamento delle immagini per utilizzarle nel progetto - L applicazione in front-end presenta una semplice interfaccia grafica sviluppata in HTML, XML e con lo specifico Markup di Wiki. In back-end la piattaforma presenta una base di dati che alla creazione del progetto genera automaticamente delle tabelle, le più importanti sono: - Tabella per la memorizzazione delle immagini - Tabella per la memorizzazione dei dati degli utenti come il nome, cognome, Nome utente, password e email - Tabella per la gestione dei collegamenti tra le diverse pagine create degli utenti. 4. Markup language di Mediawiki Ogni utente per poter modificare i contenuti non è necessario che sappia i linguaggi come HTML, XML ma può modificarli cliccando sulla scritta modifica una volta registrati (Fig. 1). I pochi comandi per la sintassi sono: - Per fare i collegamenti ipertestuali: [[parola]] risultato: parola - Per le parole in grassetto: parola risultato: parola - Per le parole in corsivo: parola risultato: parola - Per le parole in corsivo-grassetto: parola risultato: parola - Per inserire un immagine: [[image:esempio.jpg]] - Per una galleria di immagini: <gallery> [[image:esempio.jpg descrizione]] [[image:esempio.jpg descrizione]] [[image:esempio.jpg descrizione]] </gallery> 3
Un utente che conosce il linguaggio HTML può implementarlo nelle pagine per la creazione di tabelle o altre strutture che migliorano l aspetto grafico delle pagine. Se si vuole caricare un file o un immagine di deve cliccare nella sidebar a sinistra della pagina su carica un file (Fig. 1). Fig.1 Infine se si vuole cambiare il logo del sito si deve aprire con il blocco note il file LocalSetting.php presente nella cartella del progetto e andare a modificare il nome della foto presente nella variabile $wglogo (Fig. 2) e mettere la foto nel seguente percorso: nomeprogetto/skins/common/images/nomefoto.jpg. Fig.2 4
5. Browser & OS vs Mediawiki Mediawiki è supportata dai seguenti sistemi operativi: Windows XP Service Pack2 Windows Vista Windows 7 Service Pack1 (x32- x64) Mac OS X Famiglia Linux Innopedia è possibile visualizzarla con i seguenti browser: Internet Explorer 7+ Opera e Opera Mobile Google Chrome ( per la versione mobile non è il font delle pagine non si adatta) Mozilla Firefox 4+ Safari Browser di Android. 5