welcome: please sign in

The following 323 words could not be found in the dictionary of 0 words and are highlighted below:
able   above   access   actions   admin   After   aggregate   aiming   all   allow   allowed   already   also   an   and   another   any   are   as   As   ask   at   attachments   Attachments   authenticate   automatic   automatically   avoiding   backup   bandwith   based   be   become   been   below   Besides   bi   Both   both   builtin   by   can   cannot   case   cases   change   changes   check   chosen   circumstances   clutter   commas   commented   comments   config   Configuration   configured   conflict   conflicts   connection   consuming   contains   content   Contents   create   currently   data   decide   default   defined   delta   describes   device   Dict   Dictionaries   dictionary   different   direction   directional   disables   Do   do   don   done   Down   dropdown   either   else   error   etc   example   except   excluded   exclusion   expression   extended   file   first   for   format   from   fully   future   generally   Get   global   good   group   groups   has   have   having   Help   helpful   history   if   If   in   In   including   initiating   Install   instances   Inter   intermap   interwiki   interwikiname   into   is   Is   it   It   items   job   Job   just   kind   let   lib   like   list   List   local   log   made   mainly   make   Map   Match   match   matching   Matching   may   means   menu   merge   merging   message   might   mirroring   mobile   Moin   moniker   more   multiconfig   must   mywiki   name   names   namespace   necessarily   necessary   need   needs   Neither   new   nice   no   nobody   nor   not   notation   Note   Notes   novices   Objective   Of   of   On   on   one   online   only   open   optional   or   other   out   packages   page   Page   pagename   Pages   pages   parameters   partly   password   Path   Please   prefix   Prefix   prepended   process   protect   purposes   py   Python   python2   Rather   read   really   receiving   recursively   referred   register   regular   Remember   remote   remove   Renamed   resolved   rules   same   searching   see   See   select   sending   sensitive   separated   set   setting   should   side   simply   site   sites   slower   So   so   solved   some   Some   space   start   step   stored   subpages   supply   supported   supporting   sure   sync   Sync   synchronisation   synchronised   Synchronising   Synchronizing   syntax   Table   Template   Text   that   The   the   Then   There   these   They   thing   this   This   Those   to   To   transferred   two   txt   unicode   usability   Usage   use   used   useful   user   username   using   usr   version   want   was   well   when   which   while   wiki   Wiki   wikiconfig   wikis   wikisync   will   with   without   won   work   write   written   xmlrpc   yet   You   you   Your   your  

Clear message
location: HelpOnSynchronisation

Synchronizing

Contents

  1. Synchronizing
    1. Objective
    2. Usage
    3. Configuration
    4. Some rules
    5. Notes for novices

Synchronizing two wikis can be a good thing for some circumstances like mirroring one wiki or for backup purposes. It can also be used if you want a version on your mobile device to access the data without having to be online.

Objective

Synchronising wikis partly or fully aiming at two instances having the same content (not necessarily the same page history) while avoiding conflicts and supporting merging, supported by a GUI with good usability. There is no need for a bi-directional connection, the initiating wiki just needs HTTP access to the remote wiki.

Usage

The first step is to register the remote wiki with an InterWiki name. This can either be done on the page InterWikiMap or in the file intermap.txt (see HelpOnConfiguration).

(!) In your wikiconfig.py set interwikiname. It is commented out by default.

Then it is necessary to create a kind of "job page" that contains all parameters for the synchronisation. This page will be extended by the log of the sync process as well. See below for allowed parameters. The parameters have to be written in the dictionary format (see HelpOnDictionaries). It is generally a nice example and helpful to use the page SyncJobTemplate that already has some parameters in it.

After that, you can simply select SyncPages from the dropdown menu and start the synchronisation.

Configuration

(!) Please check the remote wiki's wiki config for actions_excluded - the builtin default of it (see $PathToYourPythonInstall$/MoinMoin/config/multiconfig.py, e.g. /usr/local/lib/python2.5/site-packages/MoinMoin/config/multiconfig.py) disables some actions, including xmlrpc (this default was chosen to not open your wiki to automatic read/write access by xmlrpc except if you really decide to want that). To allow xmlrpc (wikisync is based on xmlrpc, so it won't work if you don't allow it), remove 'xmlrpc' from the exclusion list.

(!) You may want to protect your wiki by using ACL rules.

Besides remoteWiki, all other parameters are optional. Those parameters must be stored as WikiDict in the job page.

remoteWiki

InterWiki moniker/name of the remote wiki. Note that it has to match the interwiki name that has been configured by the admin of the remote wiki. You will see an error message if this is not the case.

remotePrefix
Is prepended to the remote pagename when searching for pages/sending pages. So if you do not want to clutter the global namespace of the remote wiki, you can set a prefix to create all your pages as subpages of another page in the remote wiki.
localPrefix
Is prepended to the local pagename when receiving new pages. This is mainly useful if you do not want to let the remote pages clutter your global name space. You can use it to aggregate different wiki sites into your local one.
pageMatch
If defined, it describes, using a regular expression, the pages which should be transferred.
pageList

If defined, only these (local or remote) pages are transferred. Matching is not used in this case. Page names have to be separated by commas, other syntax like [[ should not be used.

groupList

If defined, only these page local groups and all referred pages are transferred. Neither matching nor pageList is used in this case. Note that these group pages are not resolved recursively. The syntax is the same as the pageList's one.

direction

This is either Down or Both (it is not case-sensitive). Down means that local changes are not written to the remote wiki. Note that Down is slower and more bandwith-consuming in some cases.

user
The username that should be used to authenticate in the remote wiki.
password

The password that should be used to authenticate in the remote wiki. /!\ Do not supply the password on the page if you cannot make sure that nobody else will be able to read it! Rather just set the user - MoinMoin will ask you for the password automatically.

Some rules

Notes for novices