AiutoContenuti > AiutoPerAmministratori > AiutoSuConfigurazione

Questa pagina dovrebbe aiutare a configurare un wiki MoinMoin già installato. Se non se ne è ancora installato uno, consultare AiutoSuInstallazione.

Contents

  1. Generale
    1. Set di caratteri
    2. Configurazione internazionale
    3. Personalizzare le preferenze utente
  2. Configurare un singolo wiki
  3. Configurare molteplici wiki
  4. Panoramica di tutte le opzioni di configurazione
  5. 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 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:

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 -*-

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

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:

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:

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

Desktop``Edition

`False`

Se `True` fornisce a tutti gli utenti speciali permessi. Usare solo in un wiki locale.

Security``Policy

`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

AiutoPerGliSviluppatori AiutoPerUtenti