ep2008-dev

Annotated README.txt

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