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.
Contents
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 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 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çã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 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).