Se si esegue un singolo wiki, non si dovrebbe copiare il file farmconfig.py nella directory di configurazione (rimuoverlo assieme al file .pyc se sono presenti). Senza farmconfig, Moin utilizza il wikiconfig.py predefinito.
wikiconfig.py può essere posizionato in qualsiasi posto, basta assicurarsi che venga caricato da moin. È utile aggiungere la directory dove risiede come primo elemento di sys.path, (quest'ultimo è l'elenco dei percorsi che python utilizza per eseguire le importazioni). La configurazione di sys.path viene eseguita solitamente nello script del server (come moin.cgi o moin.wsgi). Per maggiori informazioni, consultare i commenti presenti all'interno dello script.
Note generali sulla struttura del wiki/farmconfig.py:
# -*- coding: iso-8859-1 -*-
from MoinMoin.multiconfig import DefaultConfig
class Config(DefaultConfig):
sitename = u'MyWiki' # u indica che sarà convertito in Unicode
interwikiname = 'MyWiki'
data_dir = '/where/ever/mywiki/data/'
underlay_dir = '/where/ever/mywiki/underlay/'
# Altre impostazioni...Per prima cosa viene definita la codifica del file di configurazione. L'impostazione predefinita è adatta solo alle lingue latine ("occidentali"), per una configurazione internazionale, consultare la sezione Configurazione internazionale. Se non viene definita la codifica, non sarà possibile usare caratteri non-ASCII.
- Di seguito viene importata la configurazione interna predefinita di Moin. La configurazione predefinita include valori per tutte le opzioni, quindi non è necessario definirli tutti, ma solo quelli che si desidera personalizzare.
- Successivamente viene definita una nuova classe di configurazione chiamata "Config" che eredita tutte le impostazioni dalla configurazione predefinita importata. Notare che il nome della classe deve essere "Config".
- Le righe seguenti sono le opzioni di configurazione per la classe "Config". Notare che ogni riga deve avere un rientro di quattro spazi, le tabulazioni non sono consentite. Moin non funzionerà se viene usato un rientro non corretto.
Un oggetto comune della configurazione è sitename: nella maggior parte dei casi non si desidera che il proprio wiki utilizzi il nome predefinito "Untitled Wiki". È possibile definire qualsiasi nome desiderato in ogni lingua, ma prima di fare questo, è utile leggere la sezione Set di caratteri.
Se sono state seguite le istruzioni di installazione, il wiki funzionerà senza altre modifiche, ma si potrebbe desiderare cambiare altri valori come data_dir, data_underlay_dir, acl_rights_before e molti altri. Nella maggior parte dei casi, è sufficente configurare i valori presenti nel file wikiconfig.py messo a disposizione.
Qualsiasi altra cosa non specificata, semplicemente conserva i valori predefiniti ereditati dal DefaultConfig.