<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>HelpOnInstalling/MinimalWiki</title></articleinfo><section><title>Installing a minimal wiki</title><para><inlinemediaobject><imageobject><imagedata depth="15" fileref="http://www.nnx.me//moin_static197/ninuxtheme02/img/alert.png" width="15"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> This configuration is unsupported by moin development. If you break it, you own the parts. </para><para><inlinemediaobject><imageobject><imagedata depth="15" fileref="http://www.nnx.me//moin_static197/ninuxtheme02/img/alert.png" width="15"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> This instruction is based on Moin version 1.5.x . </para><para>If web space is small, or maybe if you only need a two or three wiki pages you might not want the global install. This document describes what is absolutely essential and what is not. It is good to understand the basic structure of the <ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/MoinMoin#">MoinMoin</ulink> wiki and how the elements work together. </para><section><title>htdocs / wiki</title><para>you will need at least one theme, you could delete the others. If you for instance want to delete the distributed 'classic' and 'rightsidebar' theme you have to   </para><orderedlist numeration="arabic"><listitem><para>delete the folders with their names under htdocs  </para></listitem><listitem><para>delete the scripts in !MoinMoin/theme which are named 'rightsidebar.py' and 'classic.py' </para></listitem></orderedlist><para>Sometimes the cache seems to need some time to update the view. To check if the styles are still available log in and go to UserSettings. </para><para>If only one theme is served you can disable the themes choice by setting <code>theme_force=true</code> in the wikiconfig file. </para></section><section><title>MoinMoin binaries</title><para>You will need to have the &quot;MoinMoin&quot; dir installed where all classes and scripts can be found. What macros and functions we do not need is more complicated, so yet no information about it here.  </para></section><section><title>Pages</title><para>The underlay dir per default contains the virgin system files. You can have an empty underlay directory. This must contain a subfolder &quot;pages&quot;. If you have a wiki-farm, you might want to create an extra directory that you might call something like &quot;underlay-barebones&quot; and change the value for the <code>underlay_dir</code> of the specific wiki. You may want to have at least some essential pages like: </para><itemizedlist><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/AutoAdminGroup#">AutoAdminGroup</ulink> </para></listitem><listitem><para>CategoryCategory </para></listitem><listitem><para>CategoryHomepage </para></listitem><listitem><para>CategoryTemplate </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/LocalBadContent#">LocalBadContent</ulink> </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/LocalSpellingWords#">LocalSpellingWords</ulink> </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/MoinPagesEditorGroup#">MoinPagesEditorGroup</ulink> </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/RecentChanges#">RecentChanges</ulink> </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/SystemInfo#">SystemInfo</ulink> (especially for testing) </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/SystemPagesGroup#">SystemPagesGroup</ulink> </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/SystemPagesInEnglishGroup#">SystemPagesInEnglishGroup</ulink> </para></listitem><listitem><para><ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/UserPreferences#">UserPreferences</ulink> </para></listitem></itemizedlist></section><section><title>Languages</title><para>The languages are now attachments of the page <ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/SystemPagesSetup#">SystemPagesSetup</ulink>. Each language is packed as a ZIP file. Inside the ZIP file you find only numbers of the pages and a file MOIN_PACKAGE that describes what file number has which page name. These packages are thought to be installed via <ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/SystemPagesSetup#">SystemPagesSetup</ulink>. If you unpack them at home you will have to rename them and make the directories by hand. You could also install them in a new wiki and then copy them from the &quot;pages&quot; directory to the destination. </para></section><section><title>Configuration Options</title><para>You find all default values of the option in the file <code>MoinMoin/multiconfig.py</code>.  If you want to show the user fewer options you can define this with the configuration values <code> user_checkbox_defaults, user_checkbox_disable, user_checkbox_fields, user_checkbox_remove </code> (look at <ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/HelpOnConfiguration#">HelpOnConfiguration</ulink>).  </para><section><title>checkbox minimum</title><para>with these checkbox fields you will not any get errors on calling UserPreferences </para><screen><![CDATA[    user_checkbox_fields = [
    # needed fields:
        ('mailto_author', lambda _: _('Publish my email (not my wiki homepage) in author info')),
        ('show_nonexist_qm', lambda _: _('Show question mark for non-existing pagelinks')),
        ('show_page_trail', lambda _: _('Show page trail')),
        ('wikiname_add_spaces', lambda _: _('Add spaces to displayed wiki names')),
        ('edit_on_doubleclick', lambda _: _('Open editor on double click')),
        ('show_topbottom', lambda _: _('Show top/bottom links in headings')),
    # I want this one anyway:
        ('disabled', lambda _: _('Disable this account forever'))
    ]
    # if we have these fields, they need to have defaults:
    user_checkbox_defaults = {'mailto_author':       0,
                              'show_nonexist_qm':    0,
                              'show_page_trail':     1,
                              'wikiname_add_spaces': 0,
                              'edit_on_doubleclick': 0,
                              'show_topbottom':      0
                             }]]></screen></section><section><title>Additional Remove Checkboxes</title><para>You can also remove some of these settings with <code>user_checkbox_remove</code> </para><screen><![CDATA[   user_checkbox_remove = ['show_nonexist_qm', 'show_page_trail', 'wikiname_add_spaces', 'edit_on_doubleclick', 'show_topbottom', 'remember_last_visit']]]></screen></section></section><section><title>Actions</title><para>You might want to disable some actions. To see what they actually do take a look at <ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/HelpOnActions#">HelpOnActions</ulink>. To see what actions are active take a look at your wikis page <ulink url="http://www.nnx.me/HelpOnInstalling/MinimalWiki/SystemInfo#">SystemInfo</ulink> (if you did not delete it). </para></section><section><title>reduce wiki</title><para>If you want to reduce a data/ directory to the latest page revision of each non-deleted page (plus all attachments) you can use <code>moin ... maint reducewiki --target-dir=outputdir</code>. This is used to make the distributed underlay directory, but can also be used for other purposes. </para></section></section></article>