SommaireDeL'Aide > AideD'Administration > AideDeParamétrage

Sous-thèmes

Sommaire

Paramétrage d'un wiki unique

Pour mettre en place un wiki unique, 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.

En général, le plus simple est de placer le fichier wikiconfig.py à côté de votre script serveur moin.cgi. Si besoin est, vous pouvez placer ce script n'importe où. Dans ce cas, vous devrez ajouter le chemin vers ce fichier à votre script serveur. Reportez-vous à la section « System Path Configuration » de votre script serveur.

Structure du fichier de paramétrage du wiki

Notes générales sur la structure des fichiers wikiconfig.py et farmconfig.py :

# -*- coding: iso-8859-1 -*-

from MoinMoin.multiconfig import DefaultConfig

class Config(DefaultConfig):

    sitename = u'MonWiki'     # <- u indique que le texte
    interwikiname = 'MonWiki' #    sera converti en Unicode
    data_dir = '/emplacement/quelconque/monwiki/data/'
    underlay_dir = '/emplacement/quelconque/monwiki/underlay/'
    
    # Suite des paramètres...

Options Unicode

Certaines options doivent utiliser des valeurs Unicode. Par exemple, le nom du site pourrait contenir des umlaut allemands, des accents français, être en chinois ou en hébreu. De ce fait, vous devrez utilisez des chaînes de caractères Unicode pour ces paramètres. Les chaînes Unicode sont définies en ajoutant un préfixe u à la chaîne. Voici quelques exemples :

    # Nom du site, utilisé par défaut en titre des pages [Unicode]
    sitename = u"Wiki de Jérôme"
    # ou encore :
    sitename = u'私のウィき'

Reportez-vous aux commentaires du fichier de paramétrage, qui vous indiqueront quelles sont les options nécessitant des valeurs Unicode.

Notes :

Paramétrage international

Le fichier de paramétrage par défaut livré avec MoinMoin utilise le codage iso-8859-1. C'est très bien pour des langues utilisant des caractères latins, comme l'anglais, le français ou l'allemand, mais ce n'est pas utilisable pour les autres langues. Si vous voulez pouvoir utiliser des caractères non latins dans vos paramètres, votre fichier de paramétrage devra utiliser le codage UTF-8.

Pour ce faire, utilisez la ligne suivante comme première ligne de tous vos fichiers de paramétrage :

# -*- coding: utf-8 -*-

Les valeurs utilisant des chaînes Unicode sont les suivantes (les utilisateurs internationaux voudront sans doute les modifier) :

Pour connaître les paramètres conseillés pour la langue française, consultez la page /WikiEnLangueFrançaise. Pour obtenir des configurations toutes faites pour toutes les langues, consultez la page ConfigMarket. Lisez également la section sur les options Unicode.

Paramétrage de plusieurs wikis

Le moteur de wiki MoinMoin est capable de gérer plusieurs wikis à partir d'une seule installation, d'un seul jeu de fichiers de paramétrage et d'un seul processus serveur. C'est spécialement nécessaire pour les environnements rémanents comme twisted, car le serveur twisted tourne en permanence sur une adresse IP et un port TCP donnés. Donc, pour être capable d'offrir un hébergement virtuel de plusieurs domaines (wikis) sur la même adresse IP et le même port, il est nécessaire que le moteur de wikis charge en permanence plusieurs paramétrages en même temps et choisisse le bon lors du traitement d'une requête destinée à une URL spécifique.

Pour choisir le bon paramétrage, MoinMoin utilise la variable de paramétrage wikis située dans le fichier farmconfig.py - cette variable contient simplement une liste de paires (nom_du_wiki, expression_rationnelle_d_url). Attention, n'utilisez pour nom_du_wiki que des identifiants Python valables (pour être précis : identifiant ::= (lettre|"_") (lettre | chiffre | "_")* - essayez juste un mot simple si vous ne comprenez pas cette règle de grammaire). Lorsqu'il traite une requête pour une URL, MoinMoin parcoure cette liste et essaye de trouver une correspondance entre l'URL et l'expression rationnelle. Si l'URL ne correspond pas, il passe simplement à la paire suivante. Si l'URL correspond, MoinMoin charge le fichier de paramétrage appelé <nom_du_wiki>.py (habituellement situé dans le même répertoire) qui contient le paramétrage de ce wiki.

Le fichier farmconfig.py livré avec MoinMoin contient quelques exemples d'entrées correspondant à un serveur hébergeant plusieurs wikis. Il faudra l'adapter à vos besoins si vous voulez faire tourner plusieurs wikis en parallèle.

/!\ Pour simplifier l'écriture des pages d'aide, nous appellerons wikiconfig.py les fichiers de paramétrage du type <nom_du_wiki>.py. Vous devrez bien entendu utiliser le fichier dont le nom correspond à votre wiki.

Bien entendu, comme vous avez déjà adapté le paramètre wikis du fichier farmconfig.py (voir ci-dessus), nous nous contenterons ci-dessous de vous donner quelques conseils qui vous faciliteront le travail. Pensez également à consulter les astuces de paramétrage d'un seul wiki qui vous expliqueront les règles d'héritage des paramètres.

L'utilisation d'un paramètrage basé sur une classe permet de définir les caractéristiques communes de vos wikis en un seul endroit : dans la classe de paramétrage de base (reportez-vous au fichier farmconfig.py pour en avoir un exemple) :

farmconfig.py :

# -*- coding: iso-8859-1 -*-
# farmconfig.py :
from MoinMoin.multiconfig import DefaultConfig
class FarmConfig(DefaultConfig):
    url_prefix = '/wiki'
    show_hosts = 1
    underlay_dir = '/emplacement/partagé/du/dossier/underlay'
    # ...

La paramétrage de vos wikis individuels ne doit dès lors plus contenir que les paramètres spécifiques à chacun d'entre eux (comme le logo, le dossiers des données [data] ou les listes de contrôle d'accès). Tout le reste sera hérité de la classe de paramétrage de base (consultez moinmaster.py pour en avoir un exemple) :

moinmaster.py :

# -*- coding: iso-8859-1 -*-
# moinmaster.py :
from farmconfig import FarmConfig
class Config(FarmConfig):
    show_hosts = 0
    sitename = u'MoinMaster'
    interwikiname = 'MoinMaster'
    data_dir = '/org/de.wikiwikiweb.moinmaster/data/'
    # ...

Résumé des options de paramétrage

La table suivante contient les valeurs par défaut et une courte description de toutes les variables de paramétrage. Vous pouvez garder les valeurs par défaut de la plupart d'entre-elles. Celles qui ont besoin d'être modifiées sont indiquées dans le fichier wikiconfig.py d'exemple livré avec votre distribution.

/!\ À partir de MoinMoin 1.3.1, certaines options doivent avoir pour valeurs des chaînes Unicode. Consultez la section sur les options Unicode.

Nom de la variable

Valeur par défaut

Description

SecurityPolicy

None

Objet de type classe servant de point d'entrée à la mise en place de restrictions de sécurité.

acl_...

...

Définition globale au wiki de liste de contrôle d'accès (reportez-vous à l'AideDesListesDeContrôleD'Accès)

allow_xslt

0

Mis à vrai (1) pour activer l'utilisation les traitements XSLT via 4Suite (notez que cela permet à n'importe qui disposant du savoir-faire nécessaire d'insérer n'importe quel code HTML dans votre wiki, raison pour laquelle cette option est par défaut à 0).

actions_excluded

[]

Interdit les actions non-souhaitées (liste de chaînes)

attachments

None

S'il est mis à None, l'envoi des pièces jointes se fait via CGI ; sinon, doit avoir pour valeur un dictionnaire contenant le chemin d'enregistrement des pièces jointes (clef dir) et l'URL (le préfixe) correspondant à ce répertoire (clef url).

auth

[moin_cookie]

Liste des fonctions d'authentification, à appeler dans cet ordre (consultez l'AideDeL'Authentification).

bang_meta

1

Active le balisage : !NoWikiName.

caching_formats

['text_html']

Formats de sorties devant être mis en cache ; définissez-le à [] pour désactiver la mise en cache (ce qui est pratique pour les développeurs).

changed_time_fmt

'%H:%M'

Format d'heure utilisé sur la page ModificationsRécentes pour les pages modifiées dans les dernières 24 heures.

chart_options

None

Si vous diposez de gdchart, utilisez quelque-chose comme : chart_options = {'width': 720, 'height': 540}

cookie_domain

None

Pour farmconfig : utilisez ce domaine pour le cookie MoinMoin.

cookie_path

None

Pour farmconfig : utilisez ce chemin pour le cookie MoinMoin.

cookie_lifetime

12

Vous avez 12 heures à partir de maintenant avant que le cookie MoinMoin n'arrive à expiration et que vous soyez déconnecté.

data_dir

'./data/'

Chemin vers le dossier de données (en général appelé data) contenant vos (propres) pages de wiki.

data_underlay_dir

'./underlay/'

Chemin vers le dossier d'infrastructure (en général appelé underlay) contenant les pages systèmes et les pages d'aides livrées avec MoinMoin.

date_fmt

'%Y-%m-%d'

Format de date système, principalement utilisé pour les ModificationsRécentes.

datetime_fmt

'%Y-%m-%d %H:%M:%S'

Format par défaut pour la date et l'heure (utilisé si l'utilisateur n'a pas défini de préférence ou s'il a choisi le format de date « par défaut »).

default_markup

'wiki'

Analyseur (i. e. format) de page par défaut (utilisez le nom du module correspondant de MoinMoin.parser)

docbook_html_dir

'...'

Chemin vers le répertoire contenant les feuilles de style XSLT de transformation de Docbook en HTML (optionnel, utilisé par l'analyseur Docbook). La valeur par défaut convient pour la distribution Sarge de Débian.

editor_default

'text'

Éditeur par défaut : éditeur en mode texte (valeur text) ou éditeur graphique (valeur gui).

editor_ui

'freechoice'

Éditeur proposé sur l'interface utilisateur : au choix (valeur freechoice) ou uniquement l'éditeur préféré (valeur theonepreferred).

editor_force

False

Impose l'utilisation de l'éditeur par défaut.

edit_locking

'warn 10'

Politique de verrouillage de l'éditeur : aucun ((valeur None), avertir ( valeur 'warn <durée maximale en minutes>') ou verrouillage (valeur 'lock <durée maximale en minutes>')

edit_rows

20

Hauteur par défaut de la boîte d'édition (exprimée en nombre de lignes).

hacks

{}

Réservé pour le développement de MoinMoin.

hosts_deny

[]

Liste des adresses IP bannies ; si l'adresse IP se termine par un point, elle bannit un sous-réseau entier (de classe A, B ou C).

html_head

""

Balises d'en-tête HTML (<HEAD>) devant être ajoutées à toutes les pages (consultez l'AideDesStyles).

html_head_posts

robots: noindex,nofollow

Balises d'en-tête HTML (<HEAD>) devant être ajoutées aux requêtes de type POST.

html_head_index

robots: index,follow

Balises d'en-tête HTML (<HEAD>) devant être ajoutées à un petit nombre de pages d'index.

html_head_normal

robots: index,nofollow

Balises d'en-tête HTML (<HEAD>) devant être ajoutées à la plupart des pages ordinaires.

html_head_queries

robots: noindex,nofollow

Balises d'en-tête HTML (<HEAD>) devant être ajoutées aux requêtes comportant des chaînes d'interrogation, comme par exemple les actions.

html_pagetitle

None

Permet de définir le titre des pages HTML (si cette variable n'est pas définie, le titre par défaut sera la valeur de la variable sitename).

interwiki_preferred

[]

Lors des dialogues, affiche ces wikis en haut de la liste.

interwikiname

None

Nom InterWiki (préfixe, surnom) du site ou None si le site n'en a pas.

language_default

'en'

Langue par défaut de l'interface et du contenu des pages (consultez l'AideDesLangues).

language_ignore_browser

False

Ne pas tenir compte des paramètres de langue du navigateur de l'utilisateur (consultez l'AideDesLangues).

logo_string

sitename

Le logo du wiki affiché en haut des pages. Cette chaîne de texte peut contenir du HTML (y compris des bases <img>). [Unicode]

lupy_search

False

Utilisation du moteur de recherche Lupy (ce moteur gère un index du wiki).

mail_from

None

En-tête From: utilisé pour indiquer l'expéditeur des messages envoyés. Par exemple mail_from = u'Wiki de Jérôme <ne.repondez.pas@exemple.fr.invalid>'. Reportez-vous à /CourrierÉlectronique.

mail_login

None

"identifiant mot_de_passe" utilisés si vous avez besoin de l'authentification SMTP (SMTP AUTH).

mail_smarthost

None

Adresse IPv4 ou nom de domaine d'un serveur SMTP (suivi d'un suffixe optionnel :port, dont la valeur par défaut est 25). Attention, les fonctions utilisant le courrier électronique (notifications, envoi des informations de connexion) ne fonctionneront que si cette variable est définie.

mail_sendmail

None

Si cette variable est définie, par exemple en lui donnant la valeur '/usr/sbin/sendmail -t -i', la commande indiquée sera utilisée pour l'envoi du courrier. Par défaut, le courrier est envoyé en utilisant le protocole SMTP via une fonction interne.

navi_bar

[u'%(page_front_page)s', u'RecentChanges', u'FindPage', u'HelpContents',]

Nom des pages les plus importantes. Les utilisateurs peuvent y ajouter leurs propres liens rapides dans les PréférencesUtilisateur. Les liens indiqués par défaut (et tous les noms de pages systèmes en version originale) seront automatiquement adaptés à la langue de l'utilisateur. Pour ajouter un lien vers une URL, utilisez la syntaxe u"[url intitulé du lien]", pour abréger le nom d'une page, utilisez u"[NomDePageTrèsTrèsLong intitulé]". Pour les noms de pages comportant des espaces, utilisez u"[nom_avec_des_espaces intitulé quelconque]". [liste de chaînes Unicode]

nonexist_qm

0

Par défaut, un point d'interrogation doit-il être affiché à côté des PagesÀCréer, comme dans le wiki original ? Modifiable par l'utilisateur.

page_category_regex

u'^Category[A-Z]'

Les noms de pages correspondant à cette expression rationnelle sont considérés comme des catégories. [Unicode]

page_credits

[...]

Liste de fragments HTML contenant des logos ou des chaînes de texte utilisées pour l'attribution de la page.

page_dict_regex

u'[a-z0-9]Dict$'

Les pages dont les noms correspondent à cette expression rationnelle sont considérées comme contenant un dictionnaire de défintions de variables. [Unicode]

page_footer1

""

Balises HTML envoyées avant le pied de page système (consultez l'AideDesStyles).

page_footer2

""

Balises HTML envoyées après le pied de page système (consultez l'AideDesStyles).

page_front_page

u'HelpOnLanguages'

Nom de la page d'accueil du site. Vous n'êtes pas sensés conserver la valeur par défaut :) Consultez l'AideDesLangues pour comprendre pourquoi... [Unicode]

page_group_regex

u'[a-z0-9]Group$'

Les pages dont les noms correspondent à cette expression rationnelle sont considérées comme contenant des défintions de groupes. [Unicode]

page_header1

""

Balises HTML envoyées avant l'en-tête de page système et la zone de titre (consultez l'AideDesStyles).

page_header2

""

Balises HTML envoyées après l'en-tête de page système et la zone de titre (consultez l'AideDesStyles).

page_iconbar

["view", ...]

Liste des icônes affichées dans la barre d'icônes. Les seules valeurs valides sont celles contenues dans la table page_icons_table. Disponible uniquement pour le thème Classic.

page_icons_table

dict

Dictionnaire (dict) de {'nom_d_icône': (url, intitulé, clef-image-icône), ...}. Disponible uniquement pour le thème Classic.

page_license_enabled

0

Donner une indication de la licence dans l'éditeur de pages.

page_license_page

u'WikiLicense'

Page utilisé comme lien pour l'indication de licence. [Unicode]

page_local_spelling_words

u'LocalSpellingWords'

Nom de la page contenant les entrées utilisateurs du correcteur orthographique. [Unicode]

page_template_regex

u'[a-z0-9]Template$'

Les pages dont les noms correspondent à cette expression rationnelle sont considérées comme contenant des modèles de pages. [Unicode]

refresh

None

refresh = (délai_minimum_s, cibles_autorisées) active l'utilisation de l'instruction de traitement #refresh 5 NomDePage, cibles_autorisées doit avoir pour valeur soit 'internal', soit 'external'.

shared_intermap

None

Chemin vers un fichier contenant les définitions InterWiki globales (ou une listes de noms de tels fichiers).

show_hosts

1

Désactiver cette option permet de masquer les noms d'hôtes et les adresses IP.

show_interwiki

0

Activer cette option permet au thème choisi d'afficher votre nom interwiki.

show_login

1

Désactiver cette option permet de supprimer les actions de connexion et de déconnexion.

show_names

1

Désactiver cette option permet de masquer les noms dans les pages « Info » et « AktuelleÄnderungen » (ce qui était auparavant fait par l'option show_hosts).

show_section_numbers

0

Activer cette option pour afficher, par défaut, les numéros de sections des titres.

show_timings

0

Affiche des informations sur les temps de traitement en bas de page - utilisé pour le développement.

show_version

0

Affiche la version de MoinMoin en bas de chaque page.

sitename

u'Untitled Wiki'

Courte description de votre wiki, affichée sur chaque page, sous le logo. Elle est également utilisée pour les documents RSS comme titre de fil. [Unicode]

stylesheets

[]

Liste de couples (media, href_css) à insérer après la feuille de style CSS du thème, mais avant la feuille de style CSS utilisateur.

superuser

[]

Liste de noms d'utilisateurs de confiance, devant disposer des super-pouvoirs d'administrateur système du wiki (à ne pas confondre avec les droits admin des listes de contrôle d'accès !). Utilisée par exemple pour réaliser des sauvegardes intégrales, pour installer des logiciels et pour installer des langues via SystemPagesSetup. N'hésitez pas également à consulter l'AideDeL'InstallateurDePaquets.

theme_default

'modern'

Le nom du thème utilisé par défaut (reportez-vous à l'AideDesThèmes).

theme_force

False

Si cette variable est à vrai, les utilisateurs n'ont pas le droit de changer de thème.

trail_size

5

Nombre de pages visitées affichées dans le chemin suivi.

tz_offset

0.0

Fuseau horaire par défaut (décalage en heures par rapport au temps universel).

ua_spiders

...|google|wget|...

Expression rationnelle servant à déterminer quels agents utilisateurs (HTTP_USER_AGENT) sont des robots, afin de ne pas enregistrer leurs connexions.

unzip_attachments_count

51

Nombre maximal de fichiers extraits des fichiers zip.

unzip_attachments_space

200MB

Nombre maximal d'octets pouvant être utilisé pour extraire des fichiers zip (MB = Mo).

unzip_single_file_size

2MB

Taille maximale d'un fichier individuel extrait de l'archive.

url_mappings

{}

Table de conversion utilisée pour transformer des préfixes d'URL (dict de 'préfixe':'remplacement'). Ce qui est très utile pour les réseaux internes où des hiérarchies entières de documents peuvent être déplacés.

url_prefix

'/wiki'

Utilisé comme URL de base pour les icônes, feuilles de styles CSS, et cætera.

user_autocreate

False

Si cette variable est à vrai, les comptes utilisateurs seront créés automatiquement (consultez l'AideDeL'Authentification).

user_checkbox_defaults

dict

Définit les valeurs par défaut des options à cocher de la page PréférencesUtilisateur. Consultez /PréférencesUtilisateur ou le fichier multiconfig.py pour connaître les valeurs par défaut. Exemple : user_checkbox_defaults = {'edit_on_doubleclick': 0}

user_checkbox_disable

[]

Liste de noms d'options à cocher à désactiver dans les PréférencesUtilisateur. Une option à cocher désactivée apparaît grisée et sa valeur par défaut est prise dans user_checkbox_defaults.

user_checkbox_fields

[...]

Liste des descriptions des options à cocher. Reportez-vous à la page /PréférencesUtilisateur ou au fichier multiconfig.py.

user_checkbox_remove

[]

Une liste d'options à cocher devant être retirées des PréférencesUtilisateur. Une option à cocher retirée utilise comme valeur par défaut la valeur définie dans user_checkbox_defaults. Reportez-vous à la page /PréférencesUtilisateur.

user_email_unique

True

Vérifier que les adresses électroniques sont uniques et refuser les adresses en double.

user_form_defaults

[]

Liste des valeurs par défaut des cases à remplir des PréférencesUtilisateur. Reportez-vous à la page /PréférencesUtilisateur.

user_form_disable

[]

Une liste des cases à remplir à désactiver dans les PréférencesUtilisateur. Une case à remplir désactivée apparaît grisée et sa valeur par défaut est prise dans user_form_defaults. Reportez-vous à la page /PréférencesUtilisateur.

user_form_fields

[...]

Liste des intitulés des cases à remplir de la page de PréférencesUtilisateur. Reportez-vous à la page /PréférencesUtilisateur ou au fichier multiconfig.py.

user_form_remove

[]

Une liste des cases à remplir devant être retirées des PréférencesUtilisateur. Une case à remplir retirée utilise comme valeur par défaut la valeur définie dans user_form_defaults. Reportez-vous à la page /PréférencesUtilisateur.

user_homewiki

Self

Pour farmconfig : wiki utilisé pour les pages personnelles des utilisateurs (utile si vous avez de nombreux utilisateurs). Vous pouvez même utiliser des pages personnelles hors d'un wiki si les noms d'utilisateurs utilisés dans le wiki sont inclus dans l'URL cible.

xmlrpc_putpage_enabled

False

Si cette variable est à vrai (True), permet à l'appel wikirpc putPage d'écrire sur la page indiquée. Si elle est à faux, l'écriture de la page se fait systématiquement sur la page PutPageTestPage au lieu de se faire sur la page indiquée.

xmlrpc_putpage_trusted_only

True

Seuls les membres du groupe Trusted (en général, via l'authentification HTTP) peuvent utiliser l'appel putPage.

Certaines valeurs peuvent uniquement être modifées dans le fichier MoinMoin/config.py (qui fait partie du code de MoinMoin, ce qui implique que ces modifications changeront globalement le comportement de tous vos wikis), mais pas depuis les fichiers de paramétrage individuels des wikis - vous ne devriez donc les modifier que si vous savez ce que vous faites :

charset

'utf-8'

Le codage (jeu de caractères) utilisé par le wiki.

lowerletters

lettres minuscules ucs-2

Définition des lettres minuscules, utilisée pour déterminer ce qui constitue un NomWiki.

smileys

{}

Définition de frimousses personnalisées (un dictionnaire (dict), contenant comme clef le texte correspondant et comme valeur un composé contenant la défintion de la largeur, de la hauteur, de la bordure et du nom de l'image).

umask

0770

Le masque de création de fichier (umask) utilisé pour tous les appels de open(), mkdir() et des fonctions similaires.

upperletters

lettres majuscules ucs-2

Définition des lettres majuscules, utilisée pour déterminer ce qui constitue un NomWiki.

url_schemas

[]

Liste des schémas d'URL supplémentaires que vous souhaitez faire reconnaître (liste de chaînes, par exemple ['ldap', 'imap']).

Options spéciales

Jeu de caractère

MoinMoin utilise Unicode en interne et le codage utf-8 pour ses entrées et sorties externes, telles que les pages, les sorties HTML et les fichiers de traductions. Le jeu de caractère externe est défini à utf-8 dans config.charset. Cette valeur est adaptée à toutes les langues, car n'importe quel caractère peut être codé en utf-8. Bien que cela soit techniquement possible, vous ne devriez pas modifier cette valeur.

AideDeParamétrage (zuletzt geändert 2009-11-15 23:40:38)