The contents of this page are moved to the official docs as part of the release process.

Since some people are not able to read (the hint on the HelpContents page), all Help* pages on the normal MoinMoin wiki are now read-only, except this page.

This is not the place for first time users to ask questions or describe "solutions". If you are not sure about what you are doing, this is not the place to write about it.

It would be nice if you directly edited MoinMaster, cf. EditingOnMoinMaster.

Missing documentation

As far as I can see, the HelpOnMacros page is missing documentation for the Login and Action macros. I could not edit MoinMaster to fix this, since I don't know all the details on these macros, since there is no documentation for them that I can find. On a more serious note, I'm not sure if there are other undocumented macros; do the files in the MoinMoin/macro directory in the distribution correspond precisely with the "builtin" macros, one-to-one?

New FAQs

Hiding moin.cgi

Use ScriptAlias as described on MoinMoin/InstallDocs to end up with are URLs that look like http://example.com/wiki/RecentChanges.

If you have access to .htaccess only, use rewrite rules and add this to your moin_config.py:

os.environ['SCRIPT_NAME'] = "/wiki"

Possible Errata on HelpOnSpellCheck

• TODO: fix markup if information is correct or delete

HelpOnSpellCheck says: > "MoinMoin looks for valid words in two places:
>
> * the "dict" directory in the MoinMoin package directory
> * the page LocalSpellingWords

<SNIP>

> If it doesn´t work
> If you change the contents of "MoinMoin/dict/" (because of adding
> new / removing old dictionaries) or if you create a new
> "MoinMoin/dict/" directory, then you have to delete the file
> "MoinMoin/wiki-moinmoin/data/dict.cache" (a new one will be created
> automagically).

I am new to MoinMoin, so am not sure I've got it right, but I would suggest that "the MoinMoin package directory" be changed to "the MoinMoin directory in the site-packages directory of your Python installation".

Further, there was no dict.cache anywhere on my system. However, once I created C:/Python24/Lib/site-packages/MoinMoin/dict and erased spellchecker.dict in the data/cache subdirectory of my wiki instance, all worked fine. So, if I understand aright, in the docs "dict.cache" should be replaced with "spellchecker.dict".

Again, this is from a newbie, and I am running a standalone moinmoin 1.3.1 with Python 2.4 and Windows Me. -- BrianvandenBroek

• I also found this to be the case on Fedora, adding a link in /usr/lib/python2.3/site-packages/MoinMoin/dict/ and removing "spellchecker.dict" worked.

Please could you put the edit page copies of the help pages somewhere accessible? Everytime I try to restore damaged versions of help pages on other moins I am frustrated by the fact that here the edit-lock here prevents me from copying the edit page text to paste into another moinmoin --AndrewCates

• It's not neccessary to have edit rights to do this e.g. http://moinmoin.wikiwikiweb.de/HelpForBeginners?action=raw and on newer MoinMOin versions you have only to delete the page because then it is called from the underlay dir again -- ReimarBauer 2005-03-23 21:02:30

Making URL from 1.2 working with 1.3

If you upgraded from version 1.2 to version 1.3, URL are not encoded the same way as before. This may be problematic if you used to link wiki pages from outside of the wiki:

• http://wiki.nonexistent.org/moin.cgi/LinkTo_2fNewPage is an example of old URL style

• http://wiki.nonexistent.org/LinkTo/NewPage is an example of new URL style

In this example, moin.cgi has disappeared because of a better configuration of Apache, this is not really a result of the migration. If you keep not hidding moin.cgi in 1.3, you should name it differently (moin1.3.cgi for example) to be able to differentiate a new URL of an old one.

You need to enable the rewrite engine of Apache as shown on above examples. Then, you add those two directives before the first RewriteRules :

•         RewriteMap old-to-new prg:/etc/apache2/old-wiki.py
          RewriteRule ^/moin.cgi(.*)$ ${old-to-new:$1} [noescape,last,redirect]

This means to call the program /etc/apache2/old-wiki.py to do some transformations on the URL. last avoids to apply more rewrite rules and redirect is to redirect to the correct page instead of serving it silently. This is useful to push the user to use the new URL scheme (for bookmarks for example).

The program /etc/apache2/old-wiki.py is a simple Python script :

•    1 #! /usr/bin/python -u
     2 import sys, re
     3 match = re.compile("^(.*)_(..)(.*)$")
     4 def escape(a):
     5     if not(a.isalnum() or a == "/"):
     6         return "%%%x" % ord(a)
     7     else:
     8         return a
     9 while 1:
    10     ligne = sys.stdin.readline()
    11     if not ligne:
    12         break
    13     ligne = ligne.strip()
    14     while 1:
    15         mo = match.match(ligne)
    16         if not mo:
    17             break
    18         try:
    19             ligne = u"%s%s%s" % (mo.group(1), unicode(chr(int(mo.group(2), 16)), "iso-8859-15"), mo.group(3))
    20             ligne = ligne.encode('UTF-8')
    21             ligne = "".join(map(lambda x: escape(x), ligne))
    22         except:
    23             ligne = "/"
    24     sys.stdout.write("%s\n" % ligne)
    25     sys.stdout.flush()
  

• All this is wrong, there was no change in moin.cgi configuration between 1.3 and 1.2. The only difference is escaping of wiki names, and it is not handled at all by this code, and should not be. I don't see what real problem related to moin is solved here.

  • As I said above, the problem to be solved is the fact that the escaping method has changed (what I called encoding of URL). If you have previously linked to the page http://wiki.nonexistent.org/moin.cgi/LinkTo_2fNewPage, after the upgrade, this link becomes invalid. You should update it to http://wiki.nonexistent.org/moin.cgi/Link/NewPage on all your non wiki pages, which is a pain. The code aboves make Apache rewriting mod do all this work with the help of the little Python script. This way, your old links still work. What may not be clear is what moin.cgi is doing here. Well, when I upgraded, I have updated my configuration to not have to include moin.cgi at the beginning of the URL. Therefore, http://wiki.nonexistent.org/moin.cgi/NewPage does not work too. Then, the rewrite rule removes moin.cgi too. -- VincentBernat 2005-07-23 10:47:20

Small typo in edit page help text

In the italian version, at the bottom of the edit page form:

Tabelle
    || cela di testo |||| cella su due colonne ||; non sono consentiti spazi dopo la tabella o il titolo.

cela should be cella

• Not in latest revision of MoinI18n/it from 2006-07-19 20:10:12.

Small corrections to the rightsidebar css

To prevent the logo owerflowing outside the header add the padding-bottom line to #header

#header {
    background: #e5e5e5;
    border-bottom: 1px solid #9C9C9C;
    line-height: 1.1em;
    padding-bottom: 1em;
}

To make the left border of the sidebar appear add the padding-left line to #sidebar

#sidebar {
    display: inline;
    margin: 10px;
    float: right;
    clear: right;
    width: 200px;
    padding: 0;
    padding-left: 10px;
    font-size: 0.88em;
    overflow: hidden;
}

Small Addition to HelpOnConfiguration

User the entry for user_wikihome, add that you'll need to create a farm-local intermap.txt, and configure shared_intermap to point to it.

Typo on "TutorialFirstChange"

The contents of hello.c initially look like this:

/*
 * hello.c
 *
 * Placed in the public domain by Bryan O'Sullivan
 *
 * This program is not covered by patents in the United States or other
 * countries.
 */

Toggle Line Numbers actually shows this non-english text on the web site:

Přepnout zobrazení čísel řádků

???