HelpMiscellaneous

Other MoinMoin help topics

Subtopics

Contents

  1. Other MoinMoin help topics
    1. Adding an icon to your wiki setup
    2. Apache tricks
      1. Securing access to a wiki via Apache means
      2. Serving the wiki from a domain root
    3. Serving the wiki from wiki.domain.com and home page from www.domain.com
    4. Special features for wiki farms and intranets
      1. Centralized settings
      2. Remapping URLs
    5. TODO

Adding an icon to your wiki setup

You maybe want to add some icon to your wiki site, commonly known as favicon.ico. To get those little icons besides bookmarks and with tabbed browsing, add this to your wikiconfig.py: 

html_head = '''
<link rel="icon" href="/images/icon.png" type="image/png">
<!-- ... more header stuff ... -->
'''

The image size must be 16x16 and simply putting it as /favicon.ico (into your DocumentRoot) does not work with all browsers (e.g. does not work with Mozilla versions 1.0 - 1.3).

Apache tricks

Securing access to a wiki via Apache means

See [MoinMoin]PasswordProtectedEditing

Serving the wiki from a domain root

httpd.conf modification for MoinMoin installation at "/": 

# global section:
LoadModule rewrite_module /usr/lib/apache/1.3/mod_rewrite.so
# virtualhost section:
RewriteEngine on
RewriteRule ^/wiki/       -                      [last]
RewriteRule ^/robots.txt  -                      [last]
RewriteRule ^/favicon.ico -                      [last]
RewriteRule ^/?(.*) /file/path/to/moin.cgi/$1  [last,type=application/x-httpd-cgi]

This way you can use short and clean URLs like [WWW] http://LinuxWiki.de/FrontPage.

Note:

Serving the wiki from wiki.domain.com and home page from www.domain.com

Here is a configuration for virtual hosting with special permissions on Gentoo Linux. The following configuration is for Apache2 config files. Just put it all in httpd.conf for Apache 1.

Add this to /etc/apache2/conf/vhosts/vhosts.conf 

NameVirtualHost *
<VirtualHost *>
   ServerName www.domain.org
   ServerAlias domain.org
   DocumentRoot /var/www/domain.org/htdocs
</VirtualHost>
 
<VirtualHost *>
   ServerName wiki.domain.org
   Alias /wiki/ "/usr/share/moin/htdocs/"
   Alias /favicon.ico "/var/www/htdocs/favicon.ico"
   ScriptAlias / "/usr/share/moin/mywiki/moin.cgi/"
</VirtualHost>

Add this to /etc/apache2/conf/commonapache2.conf 

<Directory /usr/share/moin/htdocs/>
   Order deny,allow
   Allow from all
</Directory>

<Directory /usr/share/moin/domain.org/>
   Order deny,allow
   Allow from all
</Directory>

Special features for wiki farms and intranets

The following shows how certain features can help you to optimize your configuration when you run several wikis on one host, or when you use MoinMoin in intranet environments.

Centralized settings
Remapping URLs

The configuration variable "url_mappings" can be used to remap absolute URLs to relative ones, or change certain URL prefixes to totally different ones. This is especially useful in intranets, when whole trees of documents hosted outside of the wiki move around.

"url_mappings" is a lookup table in the form of a dict, the key is the prefix to be replaced, the value is the replacement. A typical example is url_mappings = {'http://my.server.net/': '/'}, which removes the scheme from local URLs, and thus makes links to your own server work for both http and https.

Please notice: If you want to redirect a single page to another, just type #REDIRECT and the name of the page to direct to in the first line of your page. See HelpOnProcessingInstructions.

TODO

<!> TODO: explain the following things in detail, and add more detail to the above sections

Needing more explanation:

Admin stuff:

Command-line tools:

Compatibility:

last modified 2004-12-11 15:03:12