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 MoinMoin: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

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

AiutoPerGliSviluppatori AiutoPerUtenti