AiutoContenuti > AiutoPerAmministratori > AiutoSuConfigurazione

Questa pagina è di aiuto alla configurazione di un wiki MoinMoin già installato. Se non se ne è ancora installato uno, consultare AiutoSuInstallazione.

Contents

Generale
Configurare un singolo wiki
Configurare molteplici wiki
Panoramica di tutte le opzioni di configurazione
Argomenti correlati

Generale

Set di caratteri

Moin utilizza internamente Unicode e UTF-8 per l'output e l'input, come le pagine, l'output HTML e i file delle traduzioni. Il set di caratteri esterni è definito in config.charset come utf-8. Questa impostazione è valida per tutte le lingue, dato che ogni carattere può essere codificato in UTF-8. È sconsigliato modificare questo valore, anche se è tecnicamente possibile.

Importante: per utilizzare valori Unicode è necessario configurare correttamente la prima riga del file di configurazione. Assicurarsi che l'editor sia configurato correttamente.

Alcune opzione devono usare valori Unicode. Per esempio, il nome del sito può contenere gli umlaut tedeschi e accenti francesi o può essere in cinese ed ebraico. Per questo motivo, è necessario usare stringhe unicode per tutto questo. Le stringhe Unicode sono definite anteponendo la lettara u alla stringa. Alcuni esempi:

    # Nome del sito, usato in modo predefinito per il wiki [Unicode]
    sitename = u"Jürgen's Wiki"
    # un altro esempio:
    sitename = u'הוויקי של יורגן'

Per maggiori informazioni sulle quali opzioni devono usare valori Unicode, fare riferimento ai commenti nel file di configurazione.

Note:

Non è possibile usare diverse codifiche nello stesso file. Se si sta usando iso-8859-1, tutti i caratteri e tutto il file deve utilizzare quella codifica.
Se si utilizza UTF-8 (o semplice ASCII), non è necessario usare stringhe Unicode, Moin decodificherà correttamente le stringhe.

Configurazione internazionale

Il file di configurazione predefinito di Moin, utilizza la codifica iso-8859-1. Questa impostazione è adatta alle lingue latine come inglese e tedesco, ma non per lingue non latine. Se si desidera utilizzare caratteri non latini nel proprio file di configurazione, usare UTF-8.

Impostare la prima riga di tutti i file di configurazione in questo modo:

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

$/!\$ È necessario un editor di testo in grado di utilizzare (e che utilizzi) la codifica UTF-8.

Valori che fanno uso di stringhe Unicode sono identificati dal valore predefiniti che inizia con u"..." oppure ur"..." (la u sta per unicode) o ancora quando la descrizione riporta [unicode].

Per file di configurazione già pronti nella propria lingua, consultare ConfigMarket. Consultare anche la sezione riguardante le opzioni Unicode.

Personalizzare le preferenze utente

È possibile impostare in modo predefinito, disabilitare o rimuovere diverse opzioni per le preferenze utente. Consultare AiutoSuConfigurazione/PreferenzeUtente.

Configurare un singolo wiki

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 wikiconfig.py.

wikiconfig.py può essere posizionato in qualsiasi posto, basta assicurarsi che venga caricato da moin. È utile aggiungere la directory dove è posizionato come primo elemento di sys.path, l'elenco dei percorsi che python usa 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 di 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 è utile 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 comprende i valori per tutte le opzioni, quindi non è necessario definirli tutti, solo quelli da personalizzare.
Viene definita una nuova classe di configurazione chiamata "Config" e eredita tutte le impostazioni dalla configurazione predefinita che viene 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 si avvierà se viene usato un rientro non corretto.
Un oggetto comune della configurazione è sitename, nella maggior parte dei casi non è desiderato avere il nome predefinito del wiki "Untitled Wiki". È possibile definire un nome qualsiasi, in qualsiasi lingua, ma prima di fare questo è utile leggere le sezione successiva sulle opzioni Unicode.
Se sono state seguite le istruzioni di installazione, il wiki può essere avviato senza altre modifiche, ma potrebbe essere utile cambiare altri valori come data_dir, data_underlay_dir, acl_rights_before e molti altri. Nella maggior parte dei casi, configurare i valori forniti nel file wikiconfig.py è sufficiente.
Qualsiasi altra cosa non definita espressamente mantiene i valori predefiniti che vengono ereditati da DefaultConfig.

Configurare molteplici wiki

Il motore del wiki è in grado di gestire molteplici istanze wiki con una singola installazione, un unico insieme di file di configurazione e un singolo processo server. Specialmente per ambienti persistenti come twisted, questo è necessario, dato che il server twisted viene eseguito sempre su uno specifico indirizzo IP e una porta TCP. Per un host virtuale di diversi domini (wiki) sullo stesso indirizzo IP e la stessa porta, è necessario che il motore del wiki carichi continuamente molteplici configurazioni allo stesso tempo a scelga quella corretta quando gestisce le richieste per uno specifico URL.

Per essere in grado di scegliere la configurazione corretta, Moin utilizza la variabile wikis nel file farmconfig.py: contiene semplicemente un elenco di coppie (nomewiki, url-regex). Usare solamente identificatori Python validi per wikiname (per essere precisi: identifier ::= (letter|"_") (letter | digit | "_")*, basta provare con una sola parola se non si comprende la sintassi). Quando viene elaborata una richiesta da alcuni URL, moin cerca attraverso i file elencati e cerca una corrispondenza con url-regex e l'indirizzo URL attuale. Se non la trova, elabora la coppia successiva. Se la trova, carica il file di configurazione chiamato <nomewiki>.py (solitamente dalla medesima directory) che contiene il file di configurazione per quel wiki.

Il file farmconfig.py negli archivi della distribuzione dispone di alcune semplici voci per una wiki farm che esegue molteplici wiki. È necessario adattarlo affinché si adatti alle proprie esigenze.

$/!\$ Per semplificare queste pagine di aiuto, un qualsiasi file di configurazione <nomewiki>.py, verrà chiamato wikiconfig.py. Ovviamente è necessario adattare il nome dela file ai propri casi.

Di seguito verranno dati alcuni consigli su come poter risparmiare del lavoro con i file di configurazione. Consultare anche la configurazione di un wiki singolo in quanto viene spiegata l'eredità all'interno del file di configurazione.

Verrà utilizzata la configurazione basta su classe per essere in grado di configurare i valori comuni del wiki una volta sola nella classe di configurazione di base (consultare farmconfig.py per un esempio):

farmconfig.py:

# -*- coding: iso-8859-1 -*-
# farmconfig.py:
from MoinMoin.multiconfig import DefaultConfig
class FarmConfig(DefaultConfig):
    url_prefix = '/wiki'
    show_hosts = True
    underlay_dir = '/where/ever/common/underlay'
    # ...

Spiegazione:

per prima cosa viene importata la configurazione predefinita, come per un singolo wiki
viene definita una nuova classe di configurazione di farm wiki che eredita dalla configurazione predefinita
vengono modificate tutte le cose che che i wiki hanno in comune, lasciando stare i valori particolari per ogni wiki che necessitano di essere diversi
questa classe FarmConfig verrà ora usata dai file di configurazione del wiki al posto della classe DefaultConfig:

Le configurazioni dei singoli wiki avranno solamente le impostazioni che devono essere diverse, come il logo o la directory dei dati o le impostazioni delle ACL. Tutto il resto lo ottengono ereditando dalla classe di configurazione di base. Consultare moinmaster.py per un esempio:

moinmaster.py:

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

Spiegazione:

consultare la configurazione di un wiki singolo, l'unica differenze è la classe da cui si eredita: FarmConfig (che eredita da DefaultConfig)
viene sovrascritto il valore show_hosts e impostato a zero, solo per questo wiki
vengono anche sovrascritti i valori sitename, interwikiname e data_dir

Panoramica di tutte le opzioni di configurazione

La tabella seguente contiene i valori predefiniti e una breve descrizione di tutte el variabili di configurazione. Molte di queste possono essere lasciate al loro valore predefinito, quella da cambiare con ogni installazione sono comprese nel file wikiconfig.py.

Variabile	Valore predefinito	Descrizione
DesktopEdition	`False`	Se `True` fornisce a tutti gli utenti speciali permessi. Usare solo in un wiki locale.
SecurityPolicy	`None`	Oggetto della classe per implementare restrizioni di sicurezza.
acl_...	`...`	Definizione delle liste di controllo globali al wiki (consultare AiutoSuListeControlloAccesso)
actions_excluded	`['xmlrpc']`	Esclude le azioni non volute (elenco di stringhe)
allow_xslt	`False`	Se `True` abilita l'elaborazione XSLT attraverso 4Suite (notare che questo consente a chiunque con un po' di esperienza di inserire codice HTML arbitrario all'interno del wiki, ecco perché è impostato a 0).
antispam_master_url	`"http://master.moinmo.in/?action=xmlrpc2"`	Dove recuperare gli aggiornamenti per l'anti-spam (se abilitato)
auth	`[MoinAuth()]`	Elenco di funzioni di autorizzazione, da chiamare in questo ordine (consultare AiutoSuAutenticazione e AiutoSuSessioni)
auth_methods_trusted	`['http', 'xmlrpc_applytoken']`	Metodi di autenticazioni per cui gli utenti dovrebbero essere inclusi nel gruppo ACL "Trusted".
bang_meta	`True`	Se `True` ailita la sintassi `!NoNomeWiki`.
cache_dir	`'<data_dir>/cache'`	Percorso alla directory cache globale della farm. Nuovo in 1.6.
caching_formats	`['text_html']`	Visualizza i formati in cache; impostare a [] per disabilitare la cache (utile durante lo sviluppo).
changed_time_fmt	`'%H:%M'`	Formato orario usato nella pagina ModificheRecenti per le modifiche nelle ultime 24 ore.
chart_options	`None`	Se si dispone di gdchart, usare qualche cosa come chart_options = {'width': 720, 'height': 540}
cookie_*	`...`	Modifica il dominio, il percorso e la durata del cookie di sessione di moin. Consultare AiutoSuSessioni.
data_dir	`'./data/'`	Percorso alla directory dati contenente le pagine wiki.
data_underlay_dir	`'./underlay/'`	Percorso alla directory underlay contenente le pagine di aiuto.
date_fmt	`'%Y-%m-%d'`	Formato data, usato principalmente in ModificheRecenti.
datetime_fmt	`'%Y-%m-%d %H:%M:%S'`	Formato predefinito per la data e l'orario (quando l'utente non ha alcuna preferenza o sceglie il formato predefinito).
default_markup	`'wiki'`	Formato / Analizzatore predefinito (nome del modulo in `MoinMoin.parser`)
docbook_html_dir	`...`	Percorso alla directory con i file di trasformazione XSLT da Docbook in HTML (opzionale, usato dall'analizzatore docbook). Il valore predefinito è valido per Debian Etch.
edit_bar	`['Edit', ..., 'ActionsMenu']`	Elenco delle voci nella barra delle modifiche, 'Discussion' è un segnaposto per `supplementation_page_name`.
editor_default	`'text'`	Editor predefinito, 'text' o 'gui'.
editor_force	`False`	Se `True` forza l'utilizzo dell'editor predefinito.
editor_ui	`'freechoice'`	Scelta dell'editor mostrata nell'interfaccia, 'freechoice' o 'theonepreferred'.
editor_quickhelp	`{'wiki':"...", ... }`	Aiuto fornito alla fine della pagina di modifica. Da personalizzare, specificare un dizionario con un valore corrispondente a default_markup ('wiki') e fornire una stringa contenente marcatura del wiki.
edit_locking	`'warn 10'`	Politica di blocco dell'editor: `None`, `'warn <timeout in minuti>'` o `'lock <timeout in minuti>'`.
edit_rows	`20`	Altezza predefinita della casella di modifica.
hacks	`{}`	Da usare durante lo sviluppo.
history_count	`(100, 200)`	Numero di revisioni mostrate nella cronologia e nelle informazioni (default_count_shown, max_count_shown).
hosts_deny	`[]`	Elenco di indirizzi IP aboliti; se un IP termina con un punto, viene abolita tutta la sotto rete (classe A, B o C).
html_head*	`...`	Tag <HEAD> aggiuntivi per tutte le pagine (consultare AiutoSuTemi).
html_pagetitle	`None`	Consente di impostare uno specifico titolo pagina HTML (se non impostato, il valore predefinito è `sitename`).
interwikiname	`None`	Nome InterWiki (prefix, moniker) del sito, oppure None.
interwiki_preferred	`[]`	Nei dialoghi mostra questi wiki in cima all'elenco.
language_default	`'en'`	Lingua predefinita per l'interfaccia utente e il contenuto delle pagine, consultare AiutoSuLingue.
language_ignore_browser	`False`	Se `True` ignora l'impostazione della lingua del browser dell'utente, consultare AiutoSuLingue.
logo_string	`sitename`	Il logo superiore del wiki, consentito HTML (è possibile usare anche `<img>`). [Unicode]
log_reverse_dns_lookups	`True`	Se `True` esegue una ricerca DNS inversa all'azione di SAVE. Se il DNS è danneggiato, impostare a False per velocizzare SAVE.
log_timing	`False`	Se `True`, abilita le tempistiche nell'output per analizzare le condizioni di carico.
mail_*	`...`	Invio e ricezione email, consultare /SupportoPostaElettronica.
mimetypes_xss_protect	`['text/html', ...]`	"content-disposition: inline" non viene utilizzato quando un utente scarica tali allegati.
mimetypes_embed	`[...]`	Tipi mime usati da AiutoSuMacro/IncludiOggetto
navi_bar	`[u'RecentChanges',` `u'FindPage',` `u'HelpContents',]`	Le pagine più importanti. Gli utenti possono aggiungere ulteriori collegamenti all'interno delle proprie preferenze. Per collegare un URL, usare `u"[url link title]"`, per usare un nome corto, usare `u"[NomePaginaLungo title]"`. Per usare nomi di pagian con gli spazi, usare `u"[pagina_con_spazi un titolo]"` [elenco di stringhe Unicode].
nonexist_qm	`False`	Se `True` visualizza i collegamenti alle pagine assenti con un punto di domanda, come nel wiki originale (modificabile dall'utente).
page_category_regex	`u'^Categoria[A-Z]'`	Nomi di pagina che corrispondono a questa espressione regolare sono trattate come categorie [Unicode].
page_credits	`[...]`	Elenco con frammenti HTML con il logo o altre stringhe per i crediti.
page_dict_regex	`u'[a-z0-9]Dict$'`	Le pagine corrispondenti a questa espressione regolare sono considerate come contenenti definizioni da dizionario [Unicode]
page_front_page	`u'AiutoSuLingue'`	Nome della pagina principale. Non ci si aspetta che venga mantenuto quello predefinito. [Unicode]
page_group_regex	`u'Gruppo[a-z0-9]'`	Pagine corrispondenti a questa espressione regolare sono considerate come contenenti definizioni di gruppo. [Uniceode]
page_header* / page_footer*	`...`	Marcatura HTML personalizzata inviata dal tema (consultare AiutoSuTemi).
page_iconbar	`["view", ...]`	Elenco di icone da mostrare nella barra, i valori validi sono solamente quelli in page_icons_table. Disponibile solo nel tema classico.
page_icons_table	`{...}`	Dizionario di {'nome_icona': (url, titolo, icon-img-key), ...}. Disponibile solo nel tema classico.
page_license_enabled	`False`	Se `True` mostra un suggerimento riguardo la licenza nell'editor.
page_license_page	`u'!WikiLicense'`	La pagina collegata dal suggerimento sulla licenza. [Unicode]
page_local_spelling_words	`u'LocalSpellingWords'`	Pagine contenenti parole per il controllo ortografico fornite dall'utente. [Unicode]
page_template_regex	`u'[a-z0-9]Modello$'`	Pagine corrispondenti a questa espressione regolare sono considerate come modelli di nuove pagine. [Unicode]
password_checker	`func(nome_utente, password)`	Controlla se una password è accettabile (il controllo predefinito è la lunghezza della password >= 6, almeno 4 caratteri diversi, nessuna sequenza di tasti, nessun nome utente, è possibile disabilitare usando `None`).
quicklinks_default	`[]`	Elenco di collegamenti rapidi predefiniti impostati ai nuovi utenti alla creazione dell'account. Gli account esistenti non sono influenzati da questa opzione dove modifiche in navi_bar influenzano gli account esistenti. I collegamenti possono essere rimossi nelle preferenze utente, non le impostazioni di navi_bar.
refresh	`None`	refresh = (ritardo_minimo, obiettivi_consentiti) abilita l'uso dell'istruzione `#refresh 5 NomePagina`, obiettivi_consentiti può essere `'internal'` o `'external'`.
rss_cache	`60`	Tempo in secondi per la cache dell'RSS di ModificheRecenti.
search_results_per_page	`25`	Numero di risultati mostrati dopo una ricerca.
session_handler	`DefaultSessionHandler()`	Gestore sessione, consultare AiutoSuSessioni.
shared_intermap	`None`	Percorso a un file contenente le definizioni globali InterWiki (o un elenco di tali).
show_hosts	`True`	Se `True` mostra i nomi host e gli IP, impostare a `False` per nasconderli.
show_interwiki	`False`	Se `True` tema mostra il proprio nome interwiki.
show_names	`True`	Se `True` mostra i nomi utenti nelle informazioni della pagina e in ModificheRecenti. Impostare a `False` per nasconderli.
show_section_numbers	`0`	`1` per mostrare i numeri delle sezioni nei titoli.
show_timings	`False`	Se `True` mostra alcune informazioni riguardo i tempi alla fine della pagina, usato in fase di sviluppo.
show_version	`False`	Se `True` mostra la versione di MoinMoin in fondo alla pagina.
sistersites	`[]`	Elenco di tuple `('WikiName', 'sisterpagelist_fetch_url')`
sitename	`u'Descrizione wiki'`	Breve descrizione del proprio wiki, visualizzata sotto il logo in ogni pagina e usata nei documenti RSS come titolo del canale. [Unicode]
stylesheets	`[(media, csshref), ...]`	Elenco di tuple (media, csshref) da inserire dopo il css del tema, prima del css utente. Consultare AiutoSuTemi.
subscribed_pages_default	`[]`	Elenco di pagine in predefinite abbonamento impostate alla creazione di un nuovo account.
superuser	`[]`	Elenco di nomi utenti fidati con privilegi di amministrazione del wiki (da non confondere con i diritti delle ACL). Per un esempio consultare AiutoSuSuperUtente. Usato per esempio per creare backup completi, installazioni software, installazioni delle lingue attraverso SystemPagesSetup. Consultare anche AiutoSuInstallazionePacchetto.
supplementation_page	`False`	Se `True` mostra la `supplementation_page_name` nel tema per ogni pagina.
supplementation_page_name	`u'Discussione'`	Nome predefinito per la `supplementation_page`.
supplementation_page_template	`u'DiscussioneModello'`	Modello predefinito per `supplementation_page`.
surge_*	`...`	Protezione verso i clien che creano troppo traffico. Consultare /ProtezioneSovraccarico.
textchas*	`...`	Protezione anti-spam, consultare AiutoSuTextCha.
theme_default	`'modern'`	Il nome del tema usato in modo predefinito (consultare AiutoSuTemi).
theme_force	`False`	Se `True`, non consente di modificare il tema.
traceback_show	`True`	Se `True` mostra i traceback degli utenti se Moin va in crash.
trail_size	`5`	Numero di pagine da visualizzare per le pagine visitate.
tz_offset	`0.0`	Differenza oraria da UTC.
ua_spiders	`...\|google\|wget\|...`	Un'espressione regolare di HTTP_USER_AGENT che dovrebbero essere esclusi.
unzip_attachments_count	`101`	Massimo numero di file da estrarre da un file zip.
unzip_attachments_space	`200000000`	Spazio totale da usare per decomprimere i file.
unzip_single_file_size	`2000000`	Dimensione massima di un singolo file nell'archivio che può essere estratto.
url_mappings	`{}`	Tabella di controllo per rimappare i prefissi URL (dizionario di `'prefisso': 'sostituto'`); utile soprattutto nelle intranet, quando interi alberi di documenti esterni vengono spostati.
url_prefix_static	`'/moin_static170'`	Usato come URL base per le icone, css, ecc..., comprende la versione di moin e cambia con ogni rilascio. Questo sostituisce l'impostazione spesso molto confusa `url_prefix = '/wiki'`
url_prefix_action	`None`	Usare 'action' per abilitare la generazione di URL affinché sia compatibile con robots.txt. Genererà quindi .../action/info/PageName?action=info. Raccomandata per i wiki su internet.
user_autocreate	`False`	Se `True` gli account sono creati automaticamente (consultare AiutoSuAutenticazione).
user_dir	`[]`	Condividere i dati utente tra diversi wiki. Consultare AiutoSuGestioneUtenti.
user_email_unique	`True`	Se `True` controlla l'unicità delle email e non accetta duplicati.
user_homewiki	`Self`	Nome interwiki del wiki dove le pagine personali sono posizionate (utile se si dispone di molti utenti). È possibile anche controllare per pagine utente non-wiki.
user_jid_unique	`True`	Se `True` controlla l'unicità degli account Jabber e non accetta duplicati.
user_checkbox_* / user_form_*	`...`	Configura, abilita o rimuove le impostazioni predefinite delle caselle di scelta per le preferenze utente. Consultare /PreferenzeUtente.
xapian_*	`...`	Configurazione della ricerca basata su Xapian, consultare AiutoSuXapian.

Alcuni valori possono essere impostati solamente in MoinMoin/config/__init__.py (parte del codice di MoinMoin, quindi viene modificato il comportamento di tutti i wiki), ma non dal file di configurazione individuale. Modificarlo solo se si sa cosa si sta facendo:

charset	`'utf-8'`	La codifica dei caratteri usata dal wiki Non modificare questo valore, non è verificato e non è supportato.
lowerletters	ucs-2 lettere minuscole	Lettere minuscole, usate per definire cosa sia un NomeWiki.
smileys	`[...]`	Un elenco di simboli di emoticon supportati da MoinMoin. Le immagini e le dimensioni delle immagini sono definite nel codice del tema.
umask	`0770`	Umask usata da MoinMoin, quella predefinita concede diritti ai proprietari e al gruppo, ma non a tutti.
upperletters	ucs-2 lettere maiuscole	Lettere maiuscole, usate per definire cosa sia un NomeWiki.
url_schemas	`['http', 'ftp', ...]`	Schemi URL aggiuntivi che si vuol far riconoscere al wiki (elenco di stringhe come `['ldap', 'imap']`)

Argomenti correlati

HelpOnInstalling/StandaloneServer
AiutoSuListeControlloAccesso: come gestire gli accessi alle pagine con le ACL
AiutoSuTemi: come modificare l'aspetto del wiki
AiutoSuControlloOrtografico: come configurare e mantenere le opzioni di controllo ortografico
/SupportoPostaElettronica: come lavorare con le email con MoinMoin
AiutoSuPagineXml: configurare la resa XML e DocBook
/PoliticheDiSicurezza
/FileAllegati
/ApacheVoodoo
/ProtezioneSovraccarico

AiutoPerGliSviluppatori AiutoPerUtenti