Difference between revisions of "Score:Ubuntu Roadmap"
Line 14: | Line 14: | ||
#'''Ottimizzazione del server e del database''' | #'''Ottimizzazione del server e del database''' | ||
#'''Testing e debugging''' | #'''Testing e debugging''' | ||
==='''APPROFONDIMENTO PER OGNI FASE'''=== | ==='''APPROFONDIMENTO PER OGNI FASE'''=== | ||
Line 52: | Line 54: | ||
==== '''3. Creazione della struttura del sito e menu principale''' ==== | |||
* '''Cosa fare''': | |||
*# Vai su <code>MediaWiki:Sidebar</code> per configurare il menu principale. | |||
*# Aggiungi le voci principali e i sotto-menu. Esempio: | |||
*# * navigation ** mainpage|Home ** scientific-community|Scientific Community ** book-index|Index of the Book ** donate|Donate ** contact|Contact | |||
* '''Approfondimenti''': | |||
** Ogni voce del menu deve puntare a una pagina esistente. Creale prima di aggiungerle al menu. | |||
* '''Output atteso''': | |||
** Un menu principale funzionante e ben organizzato. | |||
==== '''4. Gestione dei permessi degli utenti''' ==== | |||
* '''Cosa fare''': | |||
* Configura i permessi degli utenti nel database o nel file <code>LocalSettings.php</code>. | |||
* Aggiungi l’utente amministratore: | |||
php maintenance/createAndPromote.php --bureaucrat --sysop NomeUtente | |||
* Imposta ruoli specifici, ad esempio per caricare file o modificare l’interfaccia: | |||
$wgGroupPermissions['sysop']['editinterface'] = true; | |||
$wgGroupPermissions['user']['upload'] = true; | |||
* '''Output atteso''': | |||
** Gli utenti hanno i permessi appropriati per le loro funzioni. | |||
==== '''5. Configurazione delle immagini e dei file multimediali''' ==== | |||
* '''Cosa fare''': | |||
*# Crea la directory <code>/images</code> e assicurati che sia scrivibile: | |||
sudo chmod -R 755 /var/www/html/mediawiki/images | |||
sudo chown -R www-data:www-data /var/www/html/mediawiki/images | |||
* Abilita il caricamento delle immagini e configura i formati supportati in <code>LocalSettings.php</code>: | |||
$wgFileExtensions = [ 'png', 'jpg', 'jpeg', 'gif', 'pdf' ]; | |||
* '''Output atteso''': | |||
** Caricamento delle immagini funzionante.<br /> | |||
==== '''6. Aggiunta del supporto a LaTeX per le formule matematiche''' ==== | |||
* '''Cosa fare''': | |||
*# Installa LaTeX sul server: | |||
sudo apt install texlive texlive-latex-extra | |||
*# Configura il supporto in <code>LocalSettings.php</code>: | |||
wfLoadExtension( 'Math' ); | |||
$wgDefaultUserOptions['math'] = "mathml"; | |||
* '''Output atteso''': | |||
** Formule matematiche renderizzate correttamente. | |||
==== '''7. Installazione di temi (skins) e personalizzazione grafica''' ==== | |||
* '''Cosa fare''': | |||
*# Installa e attiva i temi che preferisci (ad esempio <code>Vector</code> o <code>Timeless</code>): | |||
wfLoadSkin( 'Vector' ); | |||
$wgDefaultSkin = "vector"; | |||
# Personalizza il layout con <code>MediaWiki:Common.css</code>. | |||
* '''Output atteso''': | |||
** Grafica personalizzata e uniforme. | |||
==== '''8. Installazione e configurazione di estensioni utili''' ==== | |||
* '''Cosa fare''': | |||
*# Installa estensioni come: | |||
*#* '''VisualEditor''' per la modifica visuale. | |||
*#* '''ParserFunctions''' per logiche avanzate. | |||
*# Segui le istruzioni per configurarle nel file <code>LocalSettings.php</code>. | |||
* '''Output atteso''': | |||
** Funzionalità avanzate abilitate. | |||
==== '''9. Ottimizzazione del server e del database''' ==== | |||
* '''Cosa fare''': | |||
*# Abilita la cache per migliorare le prestazioni: | |||
$wgMainCacheType = CACHE_ACCEL; | |||
# Programma backup regolari del database. | |||
* '''Output atteso''': | |||
** Sito stabile e performante. | |||
==== '''10. Testing e debugging''' ==== | |||
* '''Cosa fare''': | |||
*# Testa tutte le funzionalità configurate. | |||
*# Abilita il debug per individuare eventuali errori: | |||
$wgShowExceptionDetails = true; | |||
$wgShowSQLErrors = true; | |||
* '''Output atteso''': | |||
** Nessun errore riscontrato. | |||
Line 70: | Line 189: | ||
</div> | </div> |
Revision as of 20:11, 7 January 2025
Ordine temporale per costruire un sito MediaWiki
ORDINE TEMPORALE PER COSTRUIRE IL SITO MEDIAWIKI
- Installazione di MediaWiki e configurazione del database
- Personalizzazione del file
LocalSettings.php
- Creazione della struttura del sito e menu principale
- Gestione dei permessi degli utenti
- Configurazione delle immagini e dei file multimediali
- Aggiunta del supporto a LaTeX per le formule matematiche
- Installazione di temi (skins) e personalizzazione grafica
- Installazione e configurazione di estensioni utili
- Ottimizzazione del server e del database
- Testing e debugging
APPROFONDIMENTO PER OGNI FASE
1. Installazione di MediaWiki e configurazione del database
- Cosa fare:
- Verifica che il tuo server (locale o remoto) abbia i requisiti necessari: PHP, MySQL/MariaDB, Apache o Nginx.
- Scarica l’ultima versione di MediaWiki dal sito ufficiale.
- Segui la procedura guidata per configurare il database:
- Nome database: ad esempio,
mediawiki_db
. - Utente database: ad esempio,
root
(preferibile creare un utente dedicato).
- Nome database: ad esempio,
- Genera il file
LocalSettings.php
durante l’installazione guidata.
- Output atteso:
- MediaWiki accessibile all’indirizzo locale, ad esempio:
http://localhost/mediawiki
.
- MediaWiki accessibile all’indirizzo locale, ad esempio:
- Conferma il completamento prima di passare al passo successivo.
2. Personalizzazione del file LocalSettings.php
Cosa fare:
Apri il file LocalSettings.php (si trova nella directory principale di MediaWiki).
Aggiungi o modifica le seguenti configurazioni:
Abilita il caricamento delle immagini: $wgEnableUploads = true;
Configura il supporto per formule matematiche (da aggiungere in un secondo momento): $wgMathValidModes = [ "png", "mathml" ];
Imposta il nome del tuo sito: $wgSitename = "Masticationpedia";
Salva e testa le modifiche.
Output atteso:
Funzionalità base configurate correttamente.
- Cosa fare:
- Vai su
MediaWiki:Sidebar
per configurare il menu principale. - Aggiungi le voci principali e i sotto-menu. Esempio:
- * navigation ** mainpage|Home ** scientific-community|Scientific Community ** book-index|Index of the Book ** donate|Donate ** contact|Contact
- Vai su
- Approfondimenti:
- Ogni voce del menu deve puntare a una pagina esistente. Creale prima di aggiungerle al menu.
- Output atteso:
- Un menu principale funzionante e ben organizzato.
4. Gestione dei permessi degli utenti
- Cosa fare:
- Configura i permessi degli utenti nel database o nel file
LocalSettings.php
.
- Aggiungi l’utente amministratore:
php maintenance/createAndPromote.php --bureaucrat --sysop NomeUtente
- Imposta ruoli specifici, ad esempio per caricare file o modificare l’interfaccia:
$wgGroupPermissions['sysop']['editinterface'] = true;
$wgGroupPermissions['user']['upload'] = true;
- Output atteso:
- Gli utenti hanno i permessi appropriati per le loro funzioni.
5. Configurazione delle immagini e dei file multimediali
- Cosa fare:
- Crea la directory
/images
e assicurati che sia scrivibile:
- Crea la directory
sudo chmod -R 755 /var/www/html/mediawiki/images
sudo chown -R www-data:www-data /var/www/html/mediawiki/images
- Abilita il caricamento delle immagini e configura i formati supportati in
LocalSettings.php
:
$wgFileExtensions = [ 'png', 'jpg', 'jpeg', 'gif', 'pdf' ];
- Output atteso:
- Caricamento delle immagini funzionante.
- Caricamento delle immagini funzionante.
6. Aggiunta del supporto a LaTeX per le formule matematiche
- Cosa fare:
- Installa LaTeX sul server:
sudo apt install texlive texlive-latex-extra
- Configura il supporto in
LocalSettings.php
:
- Configura il supporto in
wfLoadExtension( 'Math' );
$wgDefaultUserOptions['math'] = "mathml";
- Output atteso:
- Formule matematiche renderizzate correttamente.
7. Installazione di temi (skins) e personalizzazione grafica
- Cosa fare:
- Installa e attiva i temi che preferisci (ad esempio
Vector
oTimeless
):
- Installa e attiva i temi che preferisci (ad esempio
wfLoadSkin( 'Vector' );
$wgDefaultSkin = "vector";
- Personalizza il layout con
MediaWiki:Common.css
.
- Output atteso:
- Grafica personalizzata e uniforme.
8. Installazione e configurazione di estensioni utili
- Cosa fare:
- Installa estensioni come:
- VisualEditor per la modifica visuale.
- ParserFunctions per logiche avanzate.
- Segui le istruzioni per configurarle nel file
LocalSettings.php
.
- Installa estensioni come:
- Output atteso:
- Funzionalità avanzate abilitate.
9. Ottimizzazione del server e del database
- Cosa fare:
- Abilita la cache per migliorare le prestazioni:
$wgMainCacheType = CACHE_ACCEL;
- Programma backup regolari del database.
- Output atteso:
- Sito stabile e performante.
10. Testing e debugging
- Cosa fare:
- Testa tutte le funzionalità configurate.
- Abilita il debug per individuare eventuali errori:
$wgShowExceptionDetails = true;
$wgShowSQLErrors = true;
- Output atteso:
- Nessun errore riscontrato.