OddMuse: un wiki software semplice e potente.

Un qualcosa di comodo è un software wiki: tu gli dai del testo formattato in un modo molto semplice (TexTile o WikiCreole) e lui si prende la briga di convertirlo in HTML, di gestire le revisioni, gli utenti e quant'altro.

Il problema è che molti software wiki sono obesi e pesanti, senza contare che si portano dietro un botto di dipendenze (roba che per forza di cose dovrei installare per farli funzionare… database, framework strani/strambi, librerie che nessuno ha mai sentito nominare e cose del genere).

Senza contare che una volta installati sarebbero comunque pesanti.

Esempio? MediaWiki. È bello e potente, ma va lento sul server del SaLUG! e sul server di Wikipedia, quindi andrà sicuramente in modo indecentemente lento sul mio Pentium3 (che fa da server).

Alcune soluzioni di questo tipo ma interessanti sono: DokuWiki, MediaWiki, MoinMoin.

Ho vagliato quindi alcune alternative. Apparte alcuni software wiki che non ricordo, ho apprezzato molto OddMuse, che tra l'altro è il software che regge http://emacswiki.org (un posto che visito abbastanza spesso).

Ho deciso quindi di installarlo e di configurarlo e, surprise surprise, funziona egreggiamente.

Mi è piaciuto perchè è semplice, essenziale e versatile, ma estendibile.

OddMuse consiste essenzialmente in uno script perl, quindi è necessario avere Perl installato sul proprio sistema (ma tanto il mio server è imbottito di script perl :-D) ed il supporto agli script CGI attivato.

Queste non sono necessità comuni, dato che in genere i siti che offrono hosting regalano spazio, supporto a PHP e database MySQL.

Ma siccome io uso un server tutto mio, me ne sbatto dei siti di hosting, faccio/installo quello che voglio e come voglio… Che OddMuse sia!!

Dopo aver scelto dove installare OddMuse nel proprio layout di configurazione (io mi diverto ad impostare la configurazione del server web secondo una certa logica, dovrò scrivere una pagina anche su questo), possiamo scaricare lo script e renderlo eseguibile.

manu $ wget http://www.emacswiki.org/scripts/current.pl -O index.cgi

manu $ chmod a+x index.cgi

Adesso bisogna configurarlo… Non è difficile, basta aprire il file index.cgi nel proprio editor e modificare qualche variabile qua e là.

Io ho modificato le seguenti variabili nel seguente modo:

• $DataDir

È il percorso dove OddMuse salva le sue pagine e tutti i dati. Io all'inizio non l'ho modificato, dato che di default salva in /tmp/oddmuse . In questo modo, ho fatto un po' di prove, poi quando la cosa ha preso la forma che volevo, l'ho copiata nella directory del mio sito e ho modificato la variabile perchè puntasse alla nuova locazione del "database".

• $SiteName

Il nome che apparirà nella barra del titolo.

• $HomePage

La pagina (wiki) che verrà mostrata come HomePage.

• $CookieName

Il nome del cookie che OddMuse usa per salvare le proprie informazioni.

• $StyleSheet

L'indirizzo (assoluto o relativo) del CSS del wiki.

• $EditAllowed

Regola l'accesso in scrittura al wiki :

0 - no

1 - si

2 - solo pagine di discussione

3 - solo commenti

• $AdminPass e $EditPass

Password per amministratori e per editor (gente che può scrivere).

Si possono specifcare più password, separate da uno spazio.

Appunto: nella mia configurazione, OddMuse falliva nel generare le pagine web. Se l'homepage del wiki sta ad http://wiki.santoro.tk/index.cgi e una pagina si chiama [ [mypage]], OddMuse creava un link ad http://wiki.santoro.tk//mypage, invece di http://wiki.santoro.tk/index.cgi/mypage. Questo, conduceva sempre ad un Errore 404. Risolvere questo problema è semplice, basta impostare la variabile $ScriptName. Nel mio caso, $ScriptName contiene http://wiki.santoro.tk/index.cgi, e non ottengo più errori 404.

Se però pensate che avere il nome dell'eseguibile perl nell'url sia brutto, potete usare qualcosa come mod_rewrite dal lato server per riscrivere l'url, ed in questo caso non avreste bisogno di modificare la variabile $ScriptName.

Altre variabili che potreste voler impostare sono $LogoUrl, per esempio, che indica quale file di immagine dovrà essere impostato come logo del Wiki.

OddMuse viene gestito tramite moduli.

Per installare il supporto alla sintassi CreoleWiki, bisogna installare il modulo Creole. Niente di più semplice.

Spostiamoci nella cartella puntata dalla variabile $DataDir e scarichiamo lo script creole.pl

manu $ wget http://cvs.savannah.gnu.org/viewvc/*checkout*/oddmuse/oddmuse/modules/creole.pl

Fatto.

Adesso, per scrivere in una pagina possiamo usare questa sintassi:

Adesso possiamo cominciare a scrivere.

OddMuse all'inizio sembra strano e un po' bizzarro, ma giocandoci un po' la cosa appare meno complicata di quanto sembra, e se ne apprezzano le scelte di design fatte dagli sviluppatori.

Il mio wiki, comunque, è disponibile presso: http://wiki.santoro.tk !