It is strongly recommended that you change any installation prior to 0.11 to the new distutils scheme, this will make any future upgrades much easier.
You should follow the instructions on
HelpOnInstalling regarding basic installation, until you come to the "Creating a wiki instance" step. Then you have two options:
- simply adapt your old instance to the new situation, this especially means to create an alias that points to the .../share/moin/htdocs directory; you have to change url_prefix to /wiki then. The positive effect is that you automatically get any new icons and CSS files of version 0.11 and any future version, because distutils will update them in that location.
- create a new instance as per the instructions, copy the data directory from your old instance, and merge the configuration files.
Check your configuration against the provided default
moin_config.py that you find in
.../share/moin/cgi-bin/moin_config.py after installation with distutils. You should add the
sitename setting, which gets added to the page title, to RSS feeds and the like.
When you are offically a part of the
InterWiki system, then also add
interwikiname, which should contain your own
InterWiki moniker (for example "
MoinMoin" for the
MoinMoin wiki itself).
To get new icons, and also to allow
I18N customization of the menu and icon links, you should either delete or adapt your settings for
page_icons and
navi_bar. Note that the new
navi_bar default setting gets the wiki's name from the new
sitename setting, which previously was the main reason to have your own modified
navi_bar.
Due to
I18N support for system pages, the only remaining configurable page name is that of the front page, which can be set by
page_front_page (the old name
front_page for that setting is also no longer supported); the reasoning behind this is that page name customization was mainly added and used for localization issues, while changing the front page name is rather common, often the front page is named like the whole wiki.
Finally, copy any new system pages to your wiki data directory. The current system pages are in the directory .../share/moin/data/text. The minimal set to copy is the new help pages ("Help*"). If you are sure you have not modified any system pages, you can simply copy all of them to your instance data/text directory.
When copying all system pages with one command, be sure to delete pages from the following list of pages that are likely changed by your users.
The following pages are very likely to change once a wiki is in use, and it is advisable to delete them from the master system page directory
.../share/moin/data/text before any instance update; they are only included to seed new wikis:
CategoryCategory
CategoryHomepage
FrontPage
HomepageTemplate
LocalSpellingWords
PythonLanguage
WikiHomePage
WikiName
WikiSandBox
The recommended set is in the following list:
Help*
AbandonedPages
EventStats
EventStats_2fHitCounts
EventStats_2fUserAgents
FindPage
InterWiki
MoinMoin
OrphanedPages
PageSize
Python4Suite
RandomPage
RecentChanges
SiteNavigation
StructuredText
SystemInfo
TitleIndex
UserPreferences
WantedPages
WikiWikiWeb
WordIndex
XsltVersion
If you want to do German visitors a favour, also copy the new German system and help pages, they will be automatically activated as long as you use the default
page_icons and
navi_bar settings:
Hilfe*
AktuelleÄnderungen (Aktuelle_c4nderungen)
AufgegebeneSeiten
BenutzerEinstellungen
GesuchteSeiten
SeiteFinden
SeitenGröße (SeitenGr_f6_dfe)
StartSeite
TitelIndex
VerwaisteSeiten
WegWeiser
WortIndex
ZufallsSeite
The next version will include an admin interface that will allow interactive upgrades.