1 Initialising and Installing the Wiki
2 ------------------------------------
3
4 Various scripts are provided to install the Wiki according to the
5 Debian/Ubuntu filesystem layout devised for Apache and MoinMoin.
6
7 To set up a Wiki, do the following:
8
9 sudo ./initwiki .../ep2008
10 sudo ./insttheme .../ep2008
11
12 (The initwiki script sets up the resources for the Wiki; the insttheme script
13 adds theme-related resources, including the theme code.)
14
15 To copy an archived Wiki into an active Wiki:
16
17 sudo python archive_wiki.py archived_ep2008 .../ep2008
18
19 To set up the Wiki in the main MoinMoin configuration, examine farmconfig.py, then:
20
21 sudo ./instwiki /etc/moin
22
23 (This copies the ep2008.py and farmconfig.py files; if either change
24 subsequently, it will be necessary to copy them again.)
25
26 To set up an Apache site for the Wiki, examine site-ep2008, then:
27
28 sudo ./instsite /etc/apache2/sites-available
29
30 Macros (if used) can be installed as follows:
31
32 sudo ./instmacros .../ep2008
33
34 The path details employed by the moin.cgi file in the installed Wiki must
35 correspond to the paths employed by the installation process above; this file
36 can be found in a location of the following form:
37
38 .../ep2008/www/moin.cgi
39
40 The FeedReader macro is used to fetch RSS 2.0 feeds and is preferable to the
41 RSSReader macro available elsewhere since it parses the titles of feed entries
42 correctly.
43
44 Administering Content
45 ---------------------
46
47 In the archived Wiki for EuroPython 2008, various administration groups exist
48 for the implementation of access controls on certain pages; see the Volunteers
49 page for a short explanation. Note that the acl_* attributes set in the
50 ep2008.py file define the principal administrative privileges for the Wiki
51 such that the AdminGroup members can more or less change anything. Thus, when
52 deploying this Wiki, it might be a good idea to edit the AdminGroup page and
53 to add other administrative users - this would probably be done most
54 conveniently by just going into the page found in the following directory:
55
56 .../ep2008/wiki/data/pages/AdminGroup/revisions
57
58 The filename of the page is given in the following file:
59
60 .../ep2008/wiki/data/pages/AdminGroup/current
61
62 For an archived Wiki, the page is most likely to reside here:
63
64 .../ep2008/wiki/data/pages/AdminGroup/revisions/00000001
65
66 Be sure to only add existing users - there exists a possibility of people
67 otherwise creating accounts which would then have undeserved administrative
68 privileges.
69
70 Notes on Translations
71 ---------------------
72
73 http://lists.centos.org/pipermail/centos-docs/2007-October/000690.html
74 http://moinmo.in/MoinMoinBugs/LanguageDictTranslationsNotFoundForLanguageNamesHavingSpaces