Set up a wiki with Drupal 5

This how-to will provide you with a Drupal installation which has wiki functionality:

• Diff for revisions and a recent changes view
• Mediawiki input format
  • Wikilinks for the whole page and interwiki links
  • Easy image addition through image assist
  • Mediawiki style templates
• Various views for the site

---

Prerequisites

• Install Drupal 5
• Download and install contributed modules
  • diff
  • image
  • img_assist: Apply the patch on the module to make it work with Mediawiki syntax
  • pathauto
  • PEAR wiki filter: follow the directions in the readme to install PEAR packages
  • Recent changes
  • Template filter
  • views
  • Wiki tools

Enable modules

Go to administer > site building > modules and activate the following modules:

• Core - optional
  • blog (if you want blogs for your users)
  • book (if you need a book style part of your website)
  • path
  • search
  • upload
• Other
  • Diff
  • Pathauto
  • PEAR wiki filter
  • Recent changes
  • Template filter
  • Wikitools
• Views
  • Views
  • Views UI
  • Views RSS

Node types

Go to administer > content > content types and add new content types:

Wiki pages

• Name = Wiki Page
• Type = wiki
• Description = A wiki page can be edited by all users.
• Workflow options:
  • uncheck Promoted to front page
  • check Create new revision

Templates

• Name = Template
• Type = template
• Description = A template can be used in other pages as replacement.
• Workflow options:
  • uncheck Promoted to front page
  • check Create new revision

Other node types

Depending on your needs, you can set other node types like blog, page, story and image also to create new revisions.

Access rules

Go to administer > users > access control and give the authenticated user role the following permissions:

• blog module:
  • edit own blog
• book module:
  • create book pages
  • edit book pages
  • edit own book pages
• comment module:
  • access comments
  • post comments withouht approval
• image module:
  • create images
  • edit own images
  • view original images
• img_assist module:
  • access all images
  • access img_assist
  • use original size
• node module:
  • access content
  • create wiki content
  • edit own wiki content
  • edit wiki content
  • view revisions
• search module:
  • search content
  • use advanced search

Wikitools

Go to administer > site configuration > wikitools and set the following options:

• Wikipath: locate
• Title of main page: Main Page
• Wiki node types: select Blog entry, Page, Story, Wiki Page
  • If you have other content types for you site, you can select them too. The image and template types are not needed.
• Options:
  • Select the options depending on your needs. If you want to allow different pages with the same name - for example a blog entry and a wiki page with the same name - then deselect the Unique Titles option. If users should be able to change the node titles then deselect the Move Protection option.

Input format

Go to administer > site configuration > input format and create a new input format:

• Name = Mediawiki
• Filters:
  • PEAR Wiki Filter
  • Template Filter

Select the newly created format and set it the default format.

Click configure on the Mediawiki format. And then the Rearrange Tab. Give PEAR Wiki filter a weight of 0 and the Template filter a weight of 3 and save.

Click the Configure Tab and setup the following options:

• PEAR Wiki filter:
  • Path of PEAR packages: If you don't see the available formats alredy, set the path to the Text_Wiki PEAR package.
  • Format: Mediawiki
  • Ignore regexp: #(?<!{){{(?!})([^}]|(}}}))*(?<!{)}}(?!})#s
  • Use wikilinks: yes
  • Use wikitools: yes
  • Interwiki mapping: Set desired interwiki links
  • Use image module: yes
• Template filter:
  • Node type for templates: Template

Image attach

Go to administer > site configuration > image assist and set the following options:

• Other properties:
  • Default link behaviour: Link to image page
  • Default insert mode: Mediawiki (if this option does not show up, make sure the patch is applied correctly)

Set other options as desired.

Pathauto

Go to administer > site configuration > pathauto and set the following options:

• General settings:
  • Separator: _
  • Strings to remove: remove all entries
• Node path settings:
  • Default pattern: none
  • Pattern for Blog entry pages: blog/[user]/[title] (if blog module activated)
  • Pattern for Book pages: [book]/[title] ((if book module activated)
  • Pattern for Wiki pages: wiki/[title]

Set other options as desired.

Views

All pages

...

Images

...

Templates

...

Theme

Go to administer > site building > themes and select the Configure tab.

• Display post information
  • uncheck Wiki pages and Book pages (if you have book module enabled)

Syntax highlighting

If syntax highlighting is needed, install the GeSHi filter module and enable it on the Mediawiki input format. Then go to administer > site configuration > geshi filter and set the desired options. Make sure to check the Try to auto-configure other filters. If problems arise, make sure that the activated filters in the Mediawiki format have the order:

1. PEAR wiki filter
2. Template filter
3. GeSHi filter

Talk pages

If you want talk pages, install the Talk Pages module. This module will break direct links to comments, for example from the recent changes module!

Known problems

Due to a bug in Drupal the revisions are not working correctly at the moment. See this issue: http://drupal.org/node/114822 for the patch.

Original post: http://drupal.tschannen.net/wiki/set_up_a_wiki_with_drupal_5