Pour mettre en place un seul wiki, vous ne devez pas copier le fichier farmconfig.py dans votre répertoire de paramétrage (enlevez également le fichier .pyc s'il est présent). Sans le fichier farmconfig.py, MoinMoin utilisera le fichier par défaut wikiconfig.py.
Le fichier wikiconfig.py se trouve en général au même endroit que votre script moin.cgi. Si besoin est, vous pouvez placer ce script n'importe où. Dans ce cas, vous devrez ajouter le chemin de ce fichier à votre script serveur. Reportez-vous à la section « System Path Configuration » de votre script serveur.
Notes générales sur la structure des fichiers wikiconfig.py et farmconfig.py :
# -*- coding: iso-8859-1 -*-
from MoinMoin.config.multiconfig import DefaultConfig
class Config(DefaultConfig):
sitename = u'MonWiki' # u indique une conversion en Unicode
interwikiname = 'MonWiki'
data_dir = '/emplacement/quelconque/monwiki/data/'
underlay_dir = '/emplacement/quelconque/monwiki/underlay/'
# Suite des paramètres...Tout d'abord, il est nécessaire de définir le codage utilisé pour ce fichier. La valeur par défaut est uniquement adaptée aux langues utilisant des caractères latins (« langues occidentales »). Reportez-vous à la section Paramétrage international pour les autres langues. Vous ne pourrez pas utiliser de caractères non ASCII si vous n'avez pas défini le codage.
- Ensuite, le fichier de paramétrage importe les paramètres par défaut. Ces paramètres par défaut définissent des valeurs de toutes les options. Il n'est donc pas nécessaire de définir des valeurs pour toutes les options, mais uniquement pour celles que vous souhaitez modifier.
Puis, il définit une nouvelle classe de paramétrage appelée « Config », laquelle hérite du paramétrage par défaut que nous avons importé. Notez que cette classe doit obligatoirement s'appeler « Config ».
Les lignes suivantes sont les directives de paramétrage de la classe Config. Notez que chacune de ces lignes doit être indentée de 4 espaces (les tabulations ne sont pas permises). MoinMoin ne fonctionnera pas si l'indentation utilisée est incorrecte.
sitename est un paramètre courant — en général, il est déconseillé d'utiliser le nom par défaut Untitled Wiki (« Wiki sans titre »). Vous pouvez utiliser n'importe quel nom de votre choix dans n'importe quelle langue. Cependant, avant cela, consultez la section Codage des caractères.
Si vous avez suivi les instructions d'installation, le wiki fonctionnera sans nécessiter de modifications supplémentaires. Cependant, vous voudrez sans doute modifier certains autres paramètres, comme data_dir, data_underlay_dir acl_rights_before et cætera. En général, définir les paramètres inclus dans le fichier wikiconfig.py livré avec MoinMoin est suffisant.
Tout paramètre non défini gardera simplement la valeur par défaut, héritée de DefaultConfig.