DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:sync

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:sync [2013-09-21 17:37] – fix chnagelog rss url Aleksandrplugin:sync [2023-01-10 18:44] (current) – version upped andi
Line 6: Line 6:
 email      : andi@splitbrain.org email      : andi@splitbrain.org
 type       : admin type       : admin
-lastupdate : 2010-03-22 +lastupdate : 2022-09-06 
-compatible : 2009-12-25++compatible : ponder stibbons, binky, hrun, detritus, Frusterick Manners, Greebo, Hogfather
 depends    :  depends    : 
 conflicts  conflicts 
Line 18: Line 18:
 donationurl: http://donate.dokuwiki.org/Sync donationurl: http://donate.dokuwiki.org/Sync
 ---- ----
 +
  
 ===== Download and Installation ===== ===== Download and Installation =====
  
-To download and install the plugin through the plugin manager or manually, please use the download link given above.+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
  
 ==== Changes ==== ==== Changes ====
Line 39: Line 40:
 Before syncing you need to create a Synchronization profile. The following options can be set: Before syncing you need to create a Synchronization profile. The following options can be set:
  
-^ Option     ^ Required ^ Description ^ +^ Option     ^ Required ^ Description ^
-| XMLRPC URL | yes      | The full URL to the XMLRPC API of the remote wiki | +| 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 | +| 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 | +| 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 | +| 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 [[wp>Basic access authentication]] by an HTTP dialog like [[wpde>Datei:Http_auth_iw_10.png |{{https://upload.wikimedia.org/wikipedia/commons/0/00/Http_auth_iw_10.png?150}}]] then see "htaccess" under [[#Notes]] for Username and Password ((see [[https://developer.mozilla.org/en-US/docs/Web/HTTP/Basic_access_authentication |Mozilla Developer Network ]] for technical details))//  
-| Password   | no       | Password for the above user account | +| Password   | no       | Password for the above user account | ::: 
-| What to Sync | yes    | Limit the syncing to pages or mediafiles |+| What to Sync | yes    | Limit the syncing to pages or mediafiles ||
  
-Hint: you can define multiple profiles accessing the same remote wiki to be able to selectively sync different parts.+**Hint:** you can define multiple profiles accessing the same remote wiki to be able to selectively sync different parts.
  
 ==== Syncing ==== ==== Syncing ====
Line 55: Line 56:
 When you select a profile and hit "Start Synchronization", the plugin will gather a list of files that are different between the local and the remote wiki. It automatically suggests in which direction files should be synced if possible. Files can be: When you select a profile and hit "Start Synchronization", the plugin will gather a list of files that are different between the local and the remote wiki. It automatically suggests in which direction files should be synced if possible. Files can be:
  
-  * copied from the remote to the local wiki (overwriting existing local pages) +  * copied **from** the remote to the local wiki (overwriting existing local pages) 
-  * copied to the remote from the local wiki (overwriting existing remote pages)+  * copied **to** the remote from the local wiki (overwriting existing remote pages)
   * or both versions can be kept as is   * or both versions can be kept as is
  
Line 68: Line 69:
   * if the remote Wiki uses the [[config:remoteuser]] option, you need to specify a privileged user in the login config of the sync profile   * if the remote Wiki uses the [[config:remoteuser]] option, you need to specify a privileged user in the login config of the sync profile
   * it is not possible to sync a remote namespace to a differently named local namespace as this would break links and such, if you want to sync multiple wikis, it is recommended to install mutliple local wiki instances on your laptop   * it is not possible to sync a remote namespace to a differently named local namespace as this would break links and such, if you want to sync multiple wikis, it is recommended to install mutliple local wiki instances on your laptop
-  * to get through .htaccess password protection, use http://username:password@yourserver.com/dokuwiki/lib/exe/xmlrpc.php as the URL+  * to get through .htaccess password protection, use ''%%http://username:password@yourserver.com/dokuwiki/lib/exe/xmlrpc.php%%'' as the URL 
   * The plugin only syncs content (pages and media) not templates or configuration data   * The plugin only syncs content (pages and media) not templates or configuration data
  
 ===== Discussion ===== ===== Discussion =====
  
-:!: Please don't report any bugs or feature requests here but instead use the [[http://github.com/splitbrain/dokuwiki-plugin-sync/issues|bug tracker]]!  :!:+:!: Please don't report any bugs or feature requests here but instead use the [[https://github.com/splitbrain/dokuwiki-plugin-sync/issues|bug tracker]]!  :!:
plugin/sync.1379777827.txt.gz · Last modified: by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki