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
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
29
30 Macros (if used) can be installed as follows:
31
32 sudo ./instmacros .../ep2008
33
34 The RSSReader macro was found on the MoinMoin macro market and requires the
35 feedparser module (provided by the python-feedparser package on Debian/Ubuntu).
36 However, the FeedReader macro is preferable, at least with RSS 2.0 feeds since
37 it parses the titles correctly.
38
39 Administering Content
40 ---------------------
41
42 In the archived Wiki for EuroPython 2008, various administration groups exist
43 for the implementation of access controls on certain pages; see the Volunteers
44 page for a short explanation. Note that the acl_* attributes set in the
45 ep2008.py file define the principal administrative privileges for the Wiki
46 such that the AdminGroup members can more or less change anything. Thus, when
47 deploying this Wiki, it might be a good idea to edit the AdminGroup page and
48 to add other administrative users - this would probably be done most
49 conveniently by just going into the page found in the following directory:
50
51 .../ep2008/wiki/data/pages/AdminGroup/revisions
52
53 The filename of the page is given in the following file:
54
55 .../ep2008/wiki/data/pages/AdminGroup/current
56
57 For an archived Wiki, the page is most likely to reside here:
58
59 .../ep2008/wiki/data/pages/AdminGroup/revisions/00000001
60
61 Be sure to only add existing users - there exists a possibility of people
62 otherwise creating accounts which would then have undeserved administrative
63 privileges.