AiutoContenuti > AiutoPerAmministratori > AiutoSuConfigurazione
Questa pagina dovrebbe aiutare a configurare un wiki MoinMoin già installato. Se non se ne è ancora installato uno, consultare AiutoSuInstallazione.
Contents
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 impostare la linea di codifica corretta nella prima riga del file di configurazione. Verificare che il proprio editor sia configurato correttamente.
Alcune opzioni devono usare valori Unicode. Per esempio, il nome del sito può contenere gli umlaut tedeschi o gli accenti francesi oppure può essere in cinese o ebraico. Per questo motivo, è necessario usare stringhe unicode per i suddetti elementi. Le stringhe Unicode sono definite anteponendo la lettara u alla stringa. Ecco alcuni esempi:
# Nome del sito, usato in modo predefinito per il logo-nome del wiki [Unicode]
sitename = u"Jürgen's Wiki"
# un altro esempio:
sitename = u'הוויקי של יורגן'Per maggiori informazioni sulle opzioni che devono usare valori Unicode, consultare i commenti presenti nel file di configurazione.
Note:
Non è possibile usare diverse codifiche nello stesso file. Se la propria linea di codifica dice iso-8859-1, tutti i caratteri, l'intero contenuto del file devono utilizzare quella codifica.
- Se si utilizza la codifica UTF-8 (o puro 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 avere caratteri non latini nei propri elementi di configurazione, usare la codifica UTF-8 per il file di configurazione.
Impostare la prima riga di tutti i file di configurazione in questo modo:
# -*- coding: utf-8 -*-
![/!\](/moin_static/memodump/img/alert.png "/!\")
È necessario un editor di testo in grado di (e che effettivamente utilizzi) la codifica UTF-8 per modificare i file di configurazione.
I valori che fanno uso di stringhe Unicode possono essere identificati dal loro valore predefinito che inizia con u"..." oppure ur"..." (la u sta per unicode) o ancora quando la descrizione riporta esplicitamente la parola [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 nelle 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 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.
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. Questa caratteristica si rivela necessaria, specialmente per ambienti persistenti come Twisted, dato che il suddetto server viene eseguito sempre su uno specifico indirizzo IP e su una porta TCP. Per un host virtuale di diversi domini (i wiki) sullo stesso indirizzo IP e sulla stessa porta, è necessario che il motore del wiki carichi continuamente molteplici configurazioni allo stesso tempo e 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: questa variabile contiene semplicemente un elenco di coppie (nomewiki, url-regex). Si consiglia di usare per wikiname solamente identificatori Python validi (per essere precisi: identifier ::= (letter|"_") (letter | digit | "_")*, basta provare con una sola parola se non si comprende la precedente regola grammaticale). Quando viene elaborata una richiesta da alcuni URL, moin cerca tra gli elementi di questa lista e tenta di far corrispondere l' url-regex con l'indirizzo URL attuale. Se tale corrispondenza non riesce, elabora la coppia successiva. Se riesce, 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 nell'archivio della distribuzione contiene alcune voci di esempio per una wiki farm che esegue molteplici wiki. È necessario adattarlo affinché soddisfi alle proprie esigenze.
Per semplificare la scrittura di queste pagine di aiuto, un qualsiasi file di configurazione <nomewiki>.py, verrà chiamato wikiconfig.py, ovviamente si deve usare il nomefile che si è scelto.
Di seguito vengono 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.
Ora viene utilizzata la configurazione basata 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', |
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 |
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
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