← Back to branch summary

~ubuntu-branches/ubuntu/natty/moin/natty-updates

« back to all changes in this revision

Viewing changes to debian/README.Debian.in

  • Committer: Bazaar Package Importer
  • Author(s): Jonas Smedegaard
  • Date: 2008-06-22 21:17:13 UTC
  • mfrom: (0.9.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080622211713-fpo2zrq3s5dfecxg
Tags: 1.7.0-3
Simplify /etc/moin/wikilist format: "USER URL" (drop unneeded middle
CONFIG_DIR that was wrongly advertised as DATA_DIR).  Make
moin-mass-migrate handle both formats and warn about deprecation of
the old one.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/README.Debian.in
1
 
moin for Debian
2
 
---------------
3
 
 
4
 
This Debian package has been tested mostly as CGI script with Apache 1.3.
5
 
 
6
 
It should work with any web server supporting either of these:
7
 
 
8
 
 * CGI
9
 
 * FastCGI
10
 
 * Apache Python module
11
 
 * Twisted
12
 
 
13
 
 
14
 
Example: A single wiki as CGI with Apache 1.3
15
 
---------------------------------------------
16
 
 
17
 
 1) Create and populate /var/www/mywiki
18
 
    # mkdir /var/www/mywiki
19
 
    # cp -r /usr/share/moin/server/moin.cgi /var/www/mywiki
20
 
    # mkdir /var/lib/mywiki
21
 
    # cp -r /usr/share/moin/data /usr/share/moin/underlay /var/lib/mywiki
22
 
 
23
 
 2) Pass on the wiki to Apache:
24
 
    # chown -R www-data: /var/www/mywiki /var/lib/mywiki
25
 
 
26
 
 3) Configure Apache 1.3:
27
 
    Add the following lines to /etc/apache/httpd.conf:
28
 
 
29
 
        Alias /wiki/ "/usr/share/moin/htdocs/"
30
 
        ScriptAlias /MyWiki "/var/www/mywiki/moin.cgi"
31
 
 
32
 
    and reload apache
33
 
 
34
 
 4) Configure MoinMoin:
35
 
    Edit /etc/moin/farmconfig.py to include mywiki like this:
36
 
 
37
 
        wikis = [
38
 
            ("mywiki",    r"^your.site/mywiki/.*$"),
39
 
        ]
40
 
 
41
 
    Also, in /etc/moin/farmconfig.py comment out data_dir and
42
 
    data_underlay_dir (we need those defined separately for each wiki)
43
 
 
44
 
    # cp /etc/moin/moinmaster.py /etc/moin/mywiki.py
45
 
    Edit /etc/moin/mywiki.py to include these lines:
46
 
 
47
 
            sitename = u'MyWiki' # [Unicode]
48
 
            data_dir = '/var/lib/mywiki/data'
49
 
            data_underlay_dir = '/var/lib/mywiki/underlay'
50
 
 
51
 
 5) Enjoy your new wiki at http://your.site/MyWiki/
52
 
 
53
 
 
54
 
For more complex setups for apache 1.3 and 2.0, you may find inspiration
55
 
in *.conf files below /usr/share/doc/moinmoin-common/examples/*.conf .
56
 
 
57
 
For more info, both related to above example and other setups like
58
 
Twisted or standalone, read the upstream file
59
 
/usr/share/doc/moinmoin-common/INSTALL.html .
60
 
 
61
 
 
62
 
Migrating from earlier version of moin
63
 
--------------------------------------
64
 
 
65
 
Please follow the upgrade description in
66
 
/usr/share/doc/moinmoin-common/README.migration(.gz). beware that the
67
 
document was written upstream so some info may not apply to this Debian
68
 
package.
69
 
 
70
 
No prerelease of MoinMoin has been packaged officially for Debian, so if
71
 
upgrading from an earlier testing or unstable Debian package, you
72
 
probably want to run (one after the other) all of
73
 
/usr/lib/python2.3/site-packages/MoinMoin/scripts/migration/*mig*.py .
74
 
 
75
 
TIP: If you use mc (Midnight commander) then tag all migration scripts
76
 
and run the following while in the opposite window outside of the data
77
 
directory:
78
 
 
79
 
  for f in %T; do %D/$f; done
80
 
 
81
 
 
82
 
See also these links for additional cleanup after migration:
83
 
 
84
 
  http://moinmoin.wikiwikiweb.de/RemovingUnwantedLanguages
85
 
  http://moinmoin.wikiwikiweb.de/RemovingSystemPages
86
 
 
87
 
 
88
 
Always use farmconfig
89
 
---------------------
90
 
 
91
 
The Debian packaging of MoinMoin has farmconfig enabled by default, and
92
 
it is recommended to always use farmconfig instead of wikiconfig.py.
93
 
 
94
 
Some upgrades of MoinMoin require migration of data (as was the case
95
 
from 1.2.4 to 1.3.4). Future Debian packaging routines may offer to do
96
 
the migration automatically, but only for farmconfig wikis!
97
 
 
98