X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/8472d5a4fa8746e6047677b4235221da61abfa3b..778ab6e2d26dce7a795213badaa29e27128c379f:/doc/tips/distributed_wikis.mdwn diff --git a/doc/tips/distributed_wikis.mdwn b/doc/tips/distributed_wikis.mdwn index c47197729..e0d1f2fce 100644 --- a/doc/tips/distributed_wikis.mdwn +++ b/doc/tips/distributed_wikis.mdwn @@ -7,12 +7,13 @@ git, let's explore some possibilities for distributed wikis. ## Overview -There are three possible level of decentralisation: +There are several possible level of decentralisation: 0. [[default setup|rcs/git]], no decentralisation 1. [[a simple HTML mirror|tips/Git_repository_and_web_server_on_different_hosts/]] - 2. separate `srcdir`, still requires a central bare repo - uses [[plugins/pinger]] - 3. completely distinct ikiwiki installs, synchronised with [[plugins/contrib/gitpush]] + 2. [[separate ikiwiki and git servers|tips/Hosting_Ikiwiki_and_master_git_repository_on_different_machines]] + 3. separate `srcdir`, still requires a central bare repo - uses [[plugins/pinger]] + 4. completely distinct ikiwiki installs, synchronised with [[plugins/contrib/gitpush]] Here's a graphic overview of those: @@ -34,6 +35,15 @@ This is the configuration described in hosts the HTML files, the ikiwiki [[cgi]] but everything else is on the git server. +### Separate ikiwiki web server, and git server + +[[!img Hosting_Ikiwiki_and_master_git_repository_on_different_machines/separate-web-git-servers.svg size=400x]] + +This is the configuration described in +[[tips/Git_repository_and_web_server_on_different_hosts]]. One server hosts the web server (and the [[Ikiwiki cgi|cgi]]) and the git source dir; a second server hosts the git bare repository. + +> I don't understand how this configuration is different from the previous one, could you clarify? the image link is broken as well. [[anarcat]] + ### Decentralised pinger setup [[!img ping-setup.svg size=400x]] @@ -58,6 +68,8 @@ The first two ways of setting up ikiwiki are better described in [[setup]] or [[ Say you have a friend that has already configured a shiny ikiwiki site, and you want to help by creating a mirror. You still need to figure out how to install ikiwiki and everything, hopefully this section will help you with that. +Note that parts of the following documentation duplicate instructions from [[setup]], [[setup/byhand]], [[rcs/git]] and [[tips/laptop_wiki_with_git]]. + ### Installing ikiwiki You need to install the ikiwiki package for the mirror to work. You can use ikiwiki to publish the actual HTML pages elsewhere if you don't plan on letting people edit the wiki, but generally you want the package to be installed on the webserver for editing to work. @@ -202,13 +214,15 @@ To do this, the mirror needs to push back to the master, using the [[plugins/con This will ensure that commits done on the mirror will propagate back to the master. -## Other guides +## Other ideas -Another guide is the [[tips/laptop_wiki_with_git]] guide. To get a -better understanding of how ikiwiki works, see [[rcs/git]]. +See also: -[This](http://piny.be/jrayhawk/notes/ikiwiki_creation/) may also be of -use if the above doesn't work. + * [[setup]] + * [[setup/byhand]] + * [[rcs/git]] + * [[tips/laptop_wiki_with_git]] + * [ikiwiki creation notes](http://piny.be/jrayhawk/notes/ikiwiki_creation/) ### Announcing the mirror @@ -234,4 +248,3 @@ the wiki, and if you could even resolve the conflict using the web interface. Not 100% sure as I've not gotten into this situation yet. --[[Joey]] -