Serving Suggestions
Making your wiki your own
<-- back to Moniker theme description
Here are a heapin' spoonful of suggestions that we've found will help make the theme even more palatable! (of course, these will work with any theme since they're just Moin config settings):
Exclude Unneeded Actions
By default, Moin enables all available actions in the 'more actions' menu. However, many actions may be irrelevant to your install. For example, they may be features you do not need (like PackagePages or Render As Docbook), or they're irrelevant because it's an internal-only wiki (like remove Spam), or simply because you might prefer the spell checker built into most browsers over SpellCheck, etc).
Within your wikiconfig.py file, add this block of text (check your indenting), and then comment out (hashmark #) the actions you do want to include:
actions_excluded = [ 'raw', #'print', 'RenderAsDocbook', #'refresh', 'SpellCheck', 'LikePages', #'LocalSiteMap', #'RenamePage', 'CopyPage', 'DeletePage', 'MyPages', #'SubscribeUser', 'Despam', #'revert', 'PackagePages', 'SyncPages', 'Load', 'Save', ]
Remove Unneeded 'editbar' links
In our case, we wanted to remove the 'add links' (a.k.a 'Quicklinks'). We decided we didn't want to duplicate functionality of the browser (we encourage our users to simply bookmark their frequent pages). And, at the end of the day, it didn't seem to be a widely used feature anyway (people preferring bookmarks, also were confused on how to remove no longer relevant links, etc).
Within your wikiconfig.py file, add this block of text (check your indenting), and then comment out (hashmark #) the actions you do not want to include:
edit_bar = [ 'Edit', 'Comments', #'Discussion', 'Info', #'Quicklink', 'Subscribe', 'Attachments', 'ActionsMenu', ]
The above statement will enable only those edit bar features, removing the 'quicklink' link.
As an interesting side note: you can change the display order of your editbar items by re-arranging this list.
Customize the navilinks
First navilinks. Here, you can put any links you want, so you should customize it to your organization. You don't need to list, for example, recent changes if you don't want to. You can and should perhaps make this top-level links to department pages, links to internal procedures, etc. You can even link to external sites!
navi_bar = [ u'[[Home | Front Page]]', u'[[Help | Wiki Help]]', u'[[PhoneList | Phone List]]', u'[[HR | HR Info]]', u'[[Toolkit | Toolkit Manual]]', u'[[https://webmail.example.com | Webmail]]', ]
Customize the bottom credits
By default, Moin shows you the familiar MoinMoin Powered Python Powered GPL licensed Valid HTML 4.01 links at the bottom. If you want to wear it loud and proud, please leave it as-is! But you can also trivially customize this with your own content, such as All content copyright <MyCompany>. Or, you can even make it blank (which with Moniker, is especially appealing)!
page_credits = [ ]
Custom Pages
New Page
One of the first and immediate things we heard from users was how confused they were when they wanted to create a new page. By default, when creating a new page, Moin will present a table of all possible "like pages", as well as a table of all available Templates. For the user, the result was complete information-overload, and they often simply stopped at that point.
So, we dramatically simplified this with a re-write of the MissingPage and NewPageTemplate underlay. It now looks like this:
Clicking the "create it now" link opens the editor into a NewPageTemplate, which we replaced with a skeleton of text that the user just replaces with their own.
Naturally, it's not difficult to replicate the above on your own, or you can download my pre-packaged one (includes MissingPage, the puzzle icon, and the NewPageTemplate):
download FriendlierNewPage.zip
-- 98.245.218.145 2012-05-24 14:11:25 - The FriendlierNewPage looks a lot better than the standard MissingPage. To make the pre-packaged one work with MoinMoin 1.9.4, after copying everthing into place, edit the file MissingPage/revisions/00000002 and change "moin_static180" to "moin_static194". Otherwise, the puzzle icon won't show up.