KernelNewbies:

• LanguageSetup

Welcome

System and Help Page Package installation

MoinMoin comes with no system and help pages installed by default (the page you read right now is the only page after a fresh installation).

Becoming superuser

For installation of the language packages, it is required that you are superuser:

1. If you do not already have an account, create one (see hints on the login page).
2. If the wiki is not already configured to recognize you as a superuser, change wiki config appropriately:

       superuser = [u"YourLoginName", ]

   See HelpOnConfiguration for more details.

3. Restart the wiki to make it load the changed configuration.
4. Login in (with the login name you configured as superuser).

Installing page packages

You can install help and system page packages for any language you want to support for your wiki users. You should see links for each supported language, and below an install link for each page package of that language — click on it for each of the packages you wish to install. When you're finished, restart the wiki (otherwise it won't recognize the newly installed pages correctly).

Make sure you at least install the essential system page package for the language_default you might have configured (the default for this setting is en, i.e English). Note however that if you don't install the whole page set, the installed pages may contain broken links to the non-installed.

If you want to use translated categories and templates, after installing their corresponding pages you still need to update your page_category_regex and page_template_regex configs to match the translated page names. See HelpOnConfiguration and http://moinmo.in/ConfigMarket for more details.

FrontPage configuration

For the root URL of your wiki, moin will use a special page (called the "front page"). Users can be given a translated front page in their preferred language, or they can be given any other single page you specify.

Note: you must set page_front_page to get rid of this page being the front page:

    # Choose this, if most wiki content is in a single language.
    # If English is not your wiki's main language, choose something in YOUR wiki language
    page_front_page = u"MyStartingPage"

OR

    # Choose this, if wiki content is maintained in multiple languages.
    # In the navigation, "FrontPage" will get automatically translated for installed languages.
    page_front_page = u"FrontPage"

If you go the single language way, you can copy some of the content of FrontPage (or one of its translations) to the page you choose as your page_front_page.

If you go the multiple language way, don't forget to edit all translations of FrontPage.

If you go the multiple languages way, people reaching your wiki will be directed to the front page corresponding to their browser language setting. If you did not prepare that page (see front page name for different languages in wiki comment below), they will see the default page for their language and have the impression the wiki is empty or badly maintained.