Installation into the wiki instance
Parsers should be copied into the parser directory of your plugin path, which normally can be found in your moin data dir (that means: DATA-DIR/plugin/parser, where DATA-DIR is the same you entered in your wikiconfig.py in the line beginning with data_dir =) of your wiki. Do a chmod a+r on the .py file if necessary. To use the parser put #format parsername at the beginning of the page. parsername is the filename without .py (docbook.py -> #format docbook). See HelpOnProcessingInstructions.
Installation into the main wiki software
You can also copy parsers into the Python site-packages/MoinMoin/parser directory. The MoinMoin/parser directory is created inside site-packages during the MoinMoin install. Typical default Python site-packages path on Unix/Linux is /usr/lib/pythonX.Y/site-packages. Because you can add paths to the PYTHONPATH environment variable the actual directory could be anywhere. Actually, i think that last phrase is not actually true. MoinMoin looks for plugins in two places, the site-packages directory and the wiki's data/ directory. It would be nice to have a third place, but it's not currently the case. -- TheAnarcat 2006-05-30 20:37:53
If on Unix/Linux you might have to chmod a+r on the .py file.
It is better to set the right owner to the py files in most cases it is the owner of the webserver process-- ReimarBauer 2005-10-02 10:55:03
Installation for Dummies
- Copy the .py file into data/plugin/parser in your wiki instance
- Restart your wiki if you have standalone wiki
- Restarting is not necessary if you are running from a webserver via the CGI interface
- Edit a page and try out some demo code from the parser
Important Note
Whatever you name the file in the parser directory, will be what you will need to call it. For example if you download foo-1.0.py, and place it in parser/ as foo.py, then you will use #!foo. But if you called it foobar.py, you would need to use #!foobar.
Perhaps we should include some information about the extentions to HelpOnAdministration.