## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnSynchronisation
##master-date:2008-10-28 23:02:04
#acl -All:write Default
#format wiki
#language it

Sincronizzare due wiki può essere utile per eseguire il ''mirror'' di un wiki o per un backup. Può essere utile anche per avere una versione per il proprio telefonino per poter accedere ai dati senza essere in linea.

<<TableOfContents>>

= Obiettivo =

Sincronizzare i wiki consiste nell'avere due istanze degli stessi contenuti (non necessariamente la stessa cronologia) evitando i conflitti, con il supporto all'unione dei dati, il tutto attraverso una GUI con buona accessibilità. Non è necessaria una connessione bidirezionale, il wiki di partenza necessita solamente di avere accesso HTTP al wiki remoto.

= Utilizzo =

Il primo passo consiste nel registrare il wiki remoto come un [[InterWikiIt|InterWiki]]. Questo può essere svolto nella InterWikiMap o nel file `intermap.txt` (consultare AiutoSuConfigurazione).

È quindi necessario creare una specie di "pagina di lavoro" che contiene tutti i parametri di sincronizzazione. Questa pagina verrà ampliata anche col registro del processo di sincronizzazione, consultare più sotto per i parametri permessi. I parametri devono essere scritti nel formato dei dizionari (consultare AiutoSuDizionari). È buona norma utilizzare la pagina '''LavoroSincModello''' che contiene già dei parametri.

Fatto ciò, basta selezionare '''<<GetText(Sync Pages)>>''' dal menù a discesa e iniziare la sincronizzazione.

= Configurazione =

A parte il parametro ''remoteWiki'', tutti gli altri sono opzionali. Questi parametri devono essere memorizzati nella pagina di lavoro sotto forma di dizionario.

   remoteWiki:: Nome [[InterWikiIt|InterWiki]] del wiki remoto. Notare che deve corrispondere al nome interwiki configurato dall'amministratore del wiki remoto. In caso contrario verrà visualizzato un messaggio di errore.

   remotePrefix:: È preposto al nome della pagina remota quando si cercano/inviano pagine. Se non si vuole creare confusione nel namespace globale del wiki remoto, è possibile impostare un prefisso per creare tutte le pagine come sottopagine di un'altra pagina nel wiki remoto.
   localPrefix:: È preposto al nome della pagina locale quando si ricevono le pagine. È utile per fare in modo che le pagine remote non creino confusione nel namespace globale. È possibile usare il parametri per aggregare diversi wiki in uno solo locale.
   pageMatch:: Se definito, descrive, attraverso un'espressione regolare, le pagine che dovrebbero essere trasferite.
   pageList:: Se definito, solo queste pagine (locali o remote) sono trasferite. In questo caso la corrispondenza non viene utilizzata. I nomi delle pagine devono essere separati da virgole, la sintassi come `[[` non dovrebbe essere usata.
   groupList:: Se definito, solo queste pagine locali di gruppi e tutte le pagine a cui fanno riferimento vengono trasferite. Sia la corrispondenza che ''pageList'' non sono usati. Queste pagine di gruppi non vengono analizzate ricorsivamente. La sintassi è la stessa di `pageList`.
   direction:: Questa può essere ''Down'' o ''Both'' (non fa differenze tra maiuscole e minuscole). `Down` significa che le modifiche locali non vengono scritte nel wiki remoto. Notare che `Down`, in alcuni casi, è più lento e consuma molto più banda. 
   user:: Il nome utente da usare per l'autenticazione nel wiki remoto
   password:: La password da usare per l'autenticazione nel wiki remoto. /!\ Non inserire la password nella pagina a meno che non si sia sicuri che nessun'altra persona possa leggerla. Impostare solamente l'utente, MoinMoin richiederà la password automaticamente.

= Alcune regole =
 * Come scritto sopra, la cronologia non viene trasferita, solo il delta (come un ''merge'', unione). Non verrà visualizzato nessun altro commento fatto nell'altro wiki.
 * È possibile avviare la sincronizzazione in entrambi i wiki.
 * Le pagine in cui i conflitti non sono stati risolti non sono sincronizzate. Vengono sincronizzate solo se i conflitti sono risolti da una delle due parti.
 * Le pagine rinominate non possono essere sincronizzate (non è ancora supportato)
 * Gli allegati non vengono trasferiti (potrebbe cambiare quando gli allegati diventeranno oggetti).

= Note =

 * Ricordarsi di usare la notazione Unicode nell'impostare il nome interwiki nel file `wikiconfig.py`, per esempio: `interwikiname = u'mywiki'`
