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:




{| class="wikitable"
!Passaggio!!Descrizione
!Test
|-
|**Installazione di MediaWiki e configurazione del database**||
Verifica i requisiti del server (PHP, MySQL, Apache/Nginx), scarica l'ultima versione di MediaWiki, configura il database e genera il file LocalSettings.php. Conferma che MediaWiki sia accessibile, ad esempio su http://localhost/mediawiki.
|
|-
|**Personalizzazione del file LocalSettings.php**||
Modifica il file LocalSettings.php per abilitare funzionalità come il caricamento di immagini, il supporto a LaTeX e la configurazione del nome del sito.
|
|-
|**Creazione della struttura del sito e menu principale**||
Configura il menu principale tramite MediaWiki:Sidebar, aggiungendo voci principali e sottomenu. Ogni voce deve puntare a una pagina esistente.
|
|-
|**Gestione dei permessi degli utenti**||
Configura i permessi nel database o in LocalSettings.php. Promuovi un utente a amministratore con lo script di manutenzione e assegna ruoli specifici.
|
|-
|**Configurazione delle immagini e dei file multimediali**||
Crea la directory /images, assicurati che sia scrivibile, abilita il caricamento delle immagini in LocalSettings.php e configura i formati supportati.
|
|-
|**Aggiunta del supporto a LaTeX per le formule matematiche**||
Installa LaTeX sul server, abilita l'estensione Math in LocalSettings.php e configura le opzioni di rendering.
|
|-
|**Installazione di temi (skins) e personalizzazione grafica**||
Attiva i temi preferiti e personalizza il layout tramite MediaWiki:Common.css.
|
|-
|**Installazione e configurazione di estensioni utili**||
Installa estensioni come VisualEditor e ParserFunctions seguendo le istruzioni specifiche per ognuna.
|
|-
|**Ottimizzazione del server e del database**||
Abilita la cache, programma backup regolari e ottimizza il database per migliorare le prestazioni.
|
|-
|**Testing e debugging**||
Testa tutte le funzionalità configurate e abilita il debug in LocalSettings.php per individuare eventuali errori.
|
|}
</div>
</div>

Revision as of 20:11, 7 January 2025

Ordine temporale per costruire un sito MediaWiki

ORDINE TEMPORALE PER COSTRUIRE IL SITO MEDIAWIKI

  1. Installazione di MediaWiki e configurazione del database
  2. Personalizzazione del file LocalSettings.php
  3. Creazione della struttura del sito e menu principale
  4. Gestione dei permessi degli utenti
  5. Configurazione delle immagini e dei file multimediali
  6. Aggiunta del supporto a LaTeX per le formule matematiche
  7. Installazione di temi (skins) e personalizzazione grafica
  8. Installazione e configurazione di estensioni utili
  9. Ottimizzazione del server e del database
  10. Testing e debugging


APPROFONDIMENTO PER OGNI FASE


1. Installazione di MediaWiki e configurazione del database

  • Cosa fare:
    1. Verifica che il tuo server (locale o remoto) abbia i requisiti necessari: PHP, MySQL/MariaDB, Apache o Nginx.
    2. Scarica l’ultima versione di MediaWiki dal sito ufficiale.
    3. Segui la procedura guidata per configurare il database:
      • Nome database: ad esempio, mediawiki_db.
      • Utente database: ad esempio, root (preferibile creare un utente dedicato).
    4. Genera il file LocalSettings.php durante l’installazione guidata.
  • Output atteso:
    • MediaWiki accessibile all’indirizzo locale, ad esempio: http://localhost/mediawiki.
  • 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.


3. Creazione della struttura del sito e menu principale

  • Cosa fare:
    1. Vai su MediaWiki:Sidebar per configurare il menu principale.
    2. Aggiungi le voci principali e i sotto-menu. Esempio:
    3. * 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 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:
    1. Crea la directory /images 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 LocalSettings.php:

$wgFileExtensions = [ 'png', 'jpg', 'jpeg', 'gif', 'pdf' ];

  • Output atteso:
    • Caricamento delle immagini funzionante.

6. Aggiunta del supporto a LaTeX per le formule matematiche

  • Cosa fare:
    1. Installa LaTeX sul server:

sudo apt install texlive texlive-latex-extra

    1. Configura il supporto in LocalSettings.php:

wfLoadExtension( 'Math' );

$wgDefaultUserOptions['math'] = "mathml";

  • Output atteso:
    • Formule matematiche renderizzate correttamente.



7. Installazione di temi (skins) e personalizzazione grafica

  • Cosa fare:
    1. Installa e attiva i temi che preferisci (ad esempio Vector o Timeless):

wfLoadSkin( 'Vector' );

$wgDefaultSkin = "vector";

  1. Personalizza il layout con MediaWiki:Common.css.
  • Output atteso:
    • Grafica personalizzata e uniforme.



8. Installazione e configurazione di estensioni utili

  • Cosa fare:
    1. Installa estensioni come:
      • VisualEditor per la modifica visuale.
      • ParserFunctions per logiche avanzate.
    2. Segui le istruzioni per configurarle nel file LocalSettings.php.
  • Output atteso:
    • Funzionalità avanzate abilitate.


9. Ottimizzazione del server e del database

  • Cosa fare:
    1. Abilita la cache per migliorare le prestazioni:

$wgMainCacheType = CACHE_ACCEL;

  1. Programma backup regolari del database.
  • Output atteso:
    • Sito stabile e performante.


10. Testing e debugging

  • Cosa fare:
    1. Testa tutte le funzionalità configurate.
    2. Abilita il debug per individuare eventuali errori:

$wgShowExceptionDetails = true;

$wgShowSQLErrors = true;

  • Output atteso:
    • Nessun errore riscontrato.