##master-page:HelpTemplate
##master-date:Unknown-Date
#format wiki
#language pt

Sincronizar dois wikis pode ser útil em algumas circunstâncias como espelhar um wiki ou para fazer cópias de segurança. A sincronização pode também ser utilizada se quiser aceder aos dados a partir de uma versão no seu aparelho móvel sem ser necessário estar em linha.

<<TableOfContents>>

= Objectivo =
Sincronizar os wiki parcial ou inteiramente para que duas instâncias tenham o mesmo conteúdo (não necessariamente o mesmo histórico), evitando conflitos e possibilitando a fusão, suportado por um GUI com boa usabilidade. Não é necessário uma ligação bidireccional, o arranque requer apenas acesso HTTP ao wiki remoto.

= Utilização =
O primeiro passo é registar o wiki remoto com um nome de LigaçõesEntreWikis. Isto pode ser feito na página [[InterWikiMap|MapaDeLigaçõesEntreWikis]] ou no ficheiro `intermap.txt` (ver AjudaNaConfiguração).

Seguidamente é necessário criar um género de "página de trabalho" que contenha todos os parâmetros para a sincronização. Esta página será acedida também pelo registo do processo de sincronização. Veja em baixo os parâmetros autorizados. Os parâmetros têm de ser escritos no formato do dicionário (ver AjudaComDicionários). A página ''SyncJobTemplate'' é um bom exemplo e é útil uma vez que já contém alguns parâmetros.

Depois disso, basta seleccionar <<GetText(SyncPages)>> no menu de selecção e iniciar a sincronização.

= Configuração =
À excepção do ''remoteWiki'', todos os outros parâmetros são opcionais.

   remoteWiki:: moniker/nome da [[LigaçõesEntreWikis|LigaçãoEntreWiki]] do wiki remoto. Tenha em consideração de que é necessário que corresponda ao nome da ligação entre wikis que foi configurada pelo administrador do wiki remoto. Se não corresponder, verá uma mensagem de erro.

   remotePrefix:: É anexado ao nome da página remota ao pesquisar por páginas/páginas a enviar. Se não quiser ocupar o namespace global do wiki remoto, pode definir um prefixo para criar todas as páginas como sub-páginas de outra página no wiki remoto.

   localPrefix:: É anexado ao nome local da página ao receber novas páginas. Isto é particularmente útil se não quiser que as páginas remotas ocupem o seu namespace global. Pode utilizá-lo para agregar sítios wiki diferentes no seu wiki local.

   pageMatch:: Quando definido, descreve as páginas que devem ser transferidas, utilizando um expressão regular.

   pageList:: Quando definido, apenas estas páginas (locais ou remotas) são transferidas. A correspondência não é utilizada neste caso. Os nomes de páginas têm de estar separados por vírgulas, outra sintaxe como `["` não deve ser utilizada.

   groupList:: Quando definido, apenas estes grupos de páginas locais e todas as páginas referidas são transferidas. Nem a correspondência nem a ''pageList'' são utilizadas neste caso. Repare que estas páginas de grupo não são resolvidas recursivamente. A sintaxe é a mesma da `pageList`.

   direction:: Ou ''Down'' ou ''Both'' (não é sensível a maiúsculas/minúsculas). `Down` significa que as alterações locais não são editadas no wiki remoto. Tenha em consideração que `Down` é mais lento e maior consumidor de banda-larga em alguns casos.

   user:: O nome de utilizador a utilizar para autenticar no wiki remoto.

   password:: A senha não deve ser utilizada para autenticar o wiki remoto. /!\ Não forneça a senha na página se não tiver a certeza que mais ninguém a consiga ler! Defina apenas o `user` - o [[WikiMoinMoin|MoinMoin]] perguntará pela senha automaticamente.

= Algumas Regras =
 * Como descrevemos em cima, o histórico da página não é transferido, apenas o delta (como uma fusão). Assim, não verá nenhuns comentários feitos no outro wiki, etc.
 * Será possível iniciar a sincronização em ambos os wikis
 * As páginas onde os conflitos não foram resolvidos não serão sincronizadas. São sincronizadas se um dos lados resolver o conflito.
 * As páginas renomeadas não podem ser sincronizadas (isto ainda não é suportado).
 * Os anexos não são transferidos actualmente (isto pode mudar quando os anexos se tornarem itens no futuro).
