{{tag>Logiciel}}

====== sync : synchroniser des dokuwikis ======

Synchronise deux DokuWikis via XMLRPC

===== Pré-requis =====

Pour qu'il fonctionne, il faut :
  * **sur le site distant** :
    * activer l'interface **XML-RPC**
    * Paramètres d'authentification :
      * cochez **Active l'API système distante...** (//remote security//)
      * **Restreindre l'accès à l'API...** (//remoteuser//) : renseigner avec le nom de l'**administrateur** du site distant
  * **sur le site local**,
    * créer un profil sync avec :
      * le nom de l'**administrateur** distant
      * son **mot de passe**

<WRAP center round important 60%>
En cas de problème de timeout, si le plugin **sync** donne le message <code><<Failed to fetch remote file list. transport error - Timeout while reading response (15.855s)>></code>

Attendez et recommencez, c'est que le site distant a une limite à respecter.
</WRAP>

===== Installation =====

Recherchez et installez le plugin **sync** à l'aide du gestionnaire d'extensions.

===== Configuration =====

===== Utilisation =====

Le plugin doit être installé sur le wiki local, par exemple sur votre ordinateur portable.

Sur l'autre wiki (wiki distant) l'option remote doit être activée.

Une fois installé, le plugin est disponible dans l'interface d'administration.

==== Profils ====

{{ logiciel:internet:dokuwiki:plugins:sync:sync-01.jpg?600 |}}

Avant la synchronisation, vous devez créer un profil de synchronisation. Les options suivantes peuvent être définies :

^ Option        ^ Required  ^ Description                                                                                                                                                                                                                                                    ^
| XMLRPC URL    | yes       | The full URL to the XMLRPC API of the remote wiki                                                                                                                                                                                                              |
| Namespace     | no        | The namespace that should be synchronized between the two wikis. When none is given, everything is synced                                                                                                                                                      |
| Sync Depth    | yes       | By default all namespaces below the above given one are synced. You can restrict it here                                                                                                                                                                       |
| Username      | no        | A user name at the remote wiki, the sync plugin will login with this name. Only pages readable by this user can be synced\\ If your Wiki uses Basic access authentication by an HTTP dialog like then see “htaccess” under Notes for Username and Password 1)  |
| Password      | no        | Password for the above user account                                                                                                                                                                                                                            |
| What to Sync  | yes       | Limit the syncing to pages or mediafiles                                                                                                                                                                                                                       |

<WRAP center round tip 60%>
Vous pouvez définir plusieurs profils accédant au même wiki distant pour pouvoir synchroniser sélectivement différentes parties.
</WRAP>

==== Synchronisation ====

{{ logiciel:internet:dokuwiki:plugins:sync:sync-03.jpg |}}

Lorsque vous sélectionnez un profil et cliquez sur «Démarrer la synchronisation», le plugin rassemblera une liste de fichiers différents entre le wiki local et le wiki distant. Il suggère automatiquement dans quelle direction les fichiers doivent être synchronisés si possible. Les fichiers peuvent être:
  * copiés du site distant vers le wiki local (écrasement des pages locales existantes)
  * copiés vers le site distant depuis le wiki local (écrasement des pages distantes existantes)
  * copied to the remote from the local wiki (overwriting existing remote pages)
  * ou les deux versions peuvent être conservées telles quelles

Un lien intitulé «Diff» à côté de chaque page ouvrira une vue de différence dans une fenêtre contextuelle.

==== Notes ====

  * le Wiki distant doit avoir l'interface remote activée
  * si le Wiki distant utilise l'option remoteuser, vous devez spécifier un utilisateur privilégié dans la configuration de connexion du profil de synchronisation
  * on ne peut pas synchroniser un espace de noms distant nommé différemment de l'espace de noms local car cela romprait les liens. Si vous souhaitez synchroniser plusieurs wikis, il est recommandé d'installer plusieurs instances de wiki local sur votre ordinateur portable
  * pour accéder à la protection par mot de passe .htaccess, utilisez l'URL http://username:password@yourserver.com/dokuwiki/lib/exe/xmlrpc.php
  * Le plugin ne synchronise que le contenu (pages et médias), pas les modèles ni les données de configuration

===== Désinstallation =====

===== Voir aussi =====

  * **(en)** [[https://www.dokuwiki.org/plugin:sync]]

----
//Basé sur << [[https://www.dokuwiki.org/plugin:sync|Synchronization Plugin]] >> par Andreas Gohr.//